Rastreamento de Entregas
Acompanhe seus entregadores em tempo real no mapa, veja o tempo estimado de chegada de cada pedido e identifique entregas atrasadas antes que o cliente perceba.
Onde encontrar
Menu lateral → Operações → Rastreamento (ícone de pin).
O que você vê na tela
Ao abrir o Rastreamento, a tela se divide em duas partes:
Mapa (esquerda): mostra as suas filiais como marcadores dourados e os entregadores como pontos com seta indicando a direção. O mapa centraliza automaticamente na sua unidade principal.
Tabela (direita): lista todos os pedidos ativos com informações como cliente, bairro de destino, status e tempo estimado de chegada (ETA).
Acompanhar um entregador
- Clique em qualquer linha da tabela — o mapa voa automaticamente para o entregador daquele pedido.
- Uma rota em destaque aparece no mapa ligando sua filial até o endereço do cliente.
- A cor da rota indica o status:
- 🟡 Dourado — em trânsito normal
- 🟢 Verde — próximo ao destino (chegando!)
- 🔴 Vermelho — atrasado
Para deselecionar, clique novamente na linha ou em área vazia do mapa.
Coluna ETA
A coluna ETA na tabela mostra o tempo restante estimado:
~12m→ tempo calculado pelo sistema com base na rota real.- Ícone verde → entregador rastreado, cálculo em andamento.
- Traço (
—) → sem sinal GPS no momento.
Dica: o ETA é calculado a partir da sua filial, não da posição atual do entregador — isso significa que ele reflete a rota completa prevista desde a saída.
Filtrar por status
Use os botões no topo para filtrar:
| Filtro | O que mostra |
|---|---|
| Todos | Todos os pedidos ativos |
| Confirmado | Pedidos aceitos, ainda não saíram |
| Preparando | Na cozinha |
| Pronto | Aguardando entregador |
| Em Entrega | Saíram para entrega |
O mapa atualiza automaticamente ao mudar o filtro.
Modo Demo
Se você quer mostrar o sistema para alguém sem ter entregas ativas, ative o Modo Demo:
- Clique no botão ▶ Demo no canto direito dos filtros.
- O mapa exibirá 10 entregas simuladas saindo das suas filiais reais.
- Os entregadores se movem com velocidades diferentes — incluindo um "atrasado" que fica quase parado.
Para voltar aos dados reais, clique em ● Ao Vivo.
Conexão em tempo real
No canto do mapa aparece o estado da conexão:
- 🟢 Ao vivo — tudo funcionando, atualizações a cada segundo.
- 🟡 Reconectando — queda momentânea, reconectando...
- ⚪ Desconectado — sem conexão, dados atualizando a cada 30 segundos.
Dúvidas frequentes
Os entregadores precisam de algum app? Sim. O entregador precisa usar o app do PopinaFlow (ou uma integração) para transmitir a localização. Sem sinal GPS, o ponto não aparece no mapa.
O mapa não centraliza no meu restaurante, como corrigir? Cadastre a latitude e longitude da filial em Filiais & Terminais → editar filial → campos de GPS.
A rota não aparece mesmo após clicar no pedido. Verifique se o VITE_MAPBOX_TOKEN foi configurado com o escopo directions:read. Fale com o administrador técnico se necessário.