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.
Gerenciar entregadores
Para cadastrar entregadores próprios da operação (não plataformas como iFood):
- Menu → Entregadores
- Clique em + Novo Entregador
- Preencha nome, código de login (
DRV01) e PIN - O entregador usa o App do Entregador para fazer login e transmitir posição
Para atribuir um entregador a um pedido: em Pedidos, clique no pedido → Atribuir Entregador.
Dúvidas frequentes
Os entregadores precisam de algum app? Sim. Para entregadores próprios, use o App do Entregador PWA. Para plataformas externas (iFood, UberEats), a posição vem via integração automática. 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.