Tutorial 05 ⏱ 8 min Iniciante

Pedidos em tempo real 📍

Entenda o ciclo de vida de um pedido, monitore o mapa ao vivo e saiba como o despacho automático funciona.

Ciclo de vida de um pedido

Todo pedido passa pelos seguintes estados, nesta ordem:

Aguardando motoboy

O pedido foi criado pela loja. O sistema está procurando o motoboy mais próximo para convidar.

🔔

Despachando

Um motoboy aceitou a corrida e está a caminho do ponto de coleta. Você vê a rota no mapa.

📦

Coletado

O motoboy chegou à loja, pegou o pedido e marcou como coletado no app. Agora vai para o endereço de entrega.

Entregue

O motoboy confirmou a entrega no app. O pedido é encerrado e registrado no financeiro.

Cancelado

Pedido cancelado pelo admin ou pela loja. Não gera cobrança.

Como funciona o despacho automático?

Quando um pedido é criado, o sistema calcula a distância de todos os motoboys online e convida o mais próximo. O entregador recebe uma notificação sonora no app e tem alguns segundos para aceitar ou recusar.

Se o motoboy não responder ou recusar, o pedido entra no Pool — fica visível para todos os motoboys online que podem aceitar voluntariamente.

Pool: É a "fila aberta" de pedidos. Se nenhum motoboy específico aceitou, qualquer motoboy online pode pegar o pedido no pool. Isso garante que nenhum pedido fique sem atendimento.

Monitorando pelo mapa

No Dashboard você vê o mapa em tempo real com:

Clique em qualquer ponto para ver detalhes: nome do motoboy, status do pedido, endereço de origem e destino.

Cancelando ou reatribuindo um pedido

Cancelar

Acesse Pedidos → clique no pedido → botão "Cancelar". Pedidos entregues não podem ser cancelados.

Reatribuir

Se o motoboy tiver algum problema e não conseguir finalizar, você pode liberar o pedido de volta ao pool para outro entregador aceitar. Acesse o pedido e clique em "Devolver ao Pool".

Atenção: Cancelar um pedido que já está em andamento pode causar má experiência para a loja e para o cliente final. Só faça isso em caso de necessidade real.