Como Rastrear uma Entrega

​

Quando usar

​

Onde ver o rastreio

​

Pipeline (visão geral)

1. Acesse Visão > Pipeline (/admin/pipeline)
2. Veja o quadro Kanban com todos os envios por status:
   • PENDING → DISPATCHED → PICKED_UP → IN_TRANSIT → OUT_FOR_DELIVERY → DELIVERED
   • Coluna FAILED para entregas com problema
3. Filtre por transportadora ou por frota própria/terceirizada
4. Clique em qualquer envio para ver detalhes

​

Detalhe do envio (timeline completa)

1. Clique em qualquer envio do pipeline ou da lista
2. Veja a timeline com todos os eventos:
   • Data e hora de cada evento
   • Status normalizado (padrão BulkRoute)
   • Descrição do que aconteceu
   • Local (quando disponível)

​

Tracking Live (tempo real)

1. Acesse Campo > Tracking Live (/admin/tracking-live)
2. Veja a posição GPS dos motoristas da frota própria em tempo real
3. Eventos são atualizados via SSE (Server-Sent Events) — não precisa recarregar

​

Como o rastreio funciona (3 camadas)

​

1. Webhook (tempo real)

• Lalamove, Kombex, DHL, FedEx

​

2. Polling (a cada 15 minutos)

• Correios, Braspress, Jadlog, SSW, etc.
• O BulkRoute consulta automaticamente a cada 15 minutos
• Só consulta envios ativos (coletados, em trânsito, em rota de entrega)

​

3. App do Motorista (frota própria)

• Saída para entrega
• Tentativa frustrada (com foto e motivo)
• Entrega concluída (com assinatura digital)
• Geolocalização GPS de cada evento

​

Página de rastreio com sua marca (Branded Tracking)

https://www.bulkroute.com.br/tracking/BRFMSF5NRT9S0M

• Logo da sua empresa (light e dark mode)
• Cores da sua marca
• Título e rodapé customizados
• Timeline visual limpa e descomplicada

https://rastreio.suaempresa.com.br/tracking/BRFMSF5NRT9S0M

​

Notificações automáticas ao cliente

{
  "event": "shipment.status_updated",
  "data": {
    "shipmentId": "shp_987654321",
    "trackingCode": "BR123456789BR",
    "carrierCode": "braspress",
    "previousStatus": "IN_TRANSIT",
    "currentStatus": "DELIVERED"
  }
}