Entregas e devoluções LastMile: prova, tracking e retorno
Última atualização 2026-10-14
Entregas LMD- com POD (assinatura/foto/código/OTP), tracking público, redespacho e devoluções LRT-.
Uma entrega (LMD-) é “leve este pacote a esta pessoa”. Uma devolução (LRT-) é o inverso: “vá ao cliente e traga a mercadoria”. Use entregas para as entregas diárias e devoluções para recusas.
A jornada de uma entrega#
- Crie a entrega: destinatário, endereço, telefone, quantidades e volume. Tipo normal: delivery.
- Despache para uma rota ou motorista (pending → assigned). O motorista avança no app: in_transit ao sair, arrived na porta (só evento).
- Colete o POD na porta → delivered, com horário e evento de tracking.
POD: prova de entrega#
POD é “prova de entrega”. Quatro métodos: assinatura no telefone, foto, código de barras ou OTP (deve coincidir com o salvo). No app, assinatura/foto/código é obrigatório.
O cliente rastreia sozinho#
Cada entrega tem um token de 128 bits impossível de adivinhar. Compartilhe o link; sem login. O cliente vê só dados não sensíveis: número, status, destinatário, ETA e eventos; nunca telefone ou endereço.
Falhas e devoluções#
- Entrega falhou (in_transit → failed): motivo obrigatório. Pode ser redespachada (failed → assigned). A linha do tempo registra todos os eventos; o cancelamento vai como note.
- Crie a devolução (LRT-): deve vincular uma entrega ou coleta, mais o motivo. Com “precisa de coleta”, o sistema cria a tarefa e vai para pickup_scheduled.
- O motorista coleta (picked_up) → chega ao hub (received_at_hub) → reembolsa (refunded). Uma devolução pending/cancelled ainda pode ser excluída.
As notificações ao cliente (SMS/email) agora são enviadas de verdade (P1): SMS pelo Twilio do tenant, email pelo Resend. Pré-visualize o texto antes de enviar; cada envio — sucesso ou falha — fica no registro.
O app do motorista também reporta exceções e GPS. Não pode tocar tarefas de outros (403 NOT_YOUR_TASK).