Monitoramento de entregas

Depois que o pedido sai, a pergunta muda de "quanto cobro?" para "vai chegar no prazo?". Esta seção reúne as ferramentas de acompanhamento: o radar de entregas, que avisa os pedidos que provavelmente vão atrasar e permite compensar o cliente; a fila de exceções, com as remessas que a transportadora parou de movimentar ou reportou com problema; e três relatórios que comparam o prometido com o realizado.

São rotas de leitura e de ação da equipe de operação: ninguém aqui altera o preço do frete (isso fica em Métodos de envio).

Como funciona

Conceitos-chave

Em risco e atrasado

at_risk quer dizer que o pedido ainda pode chegar no prazo mas há sinal contrário (por exemplo, cause: "sem movimentação"). late quer dizer que a data prometida já passou. O texto de cause explica o motivo, em português.

Exceção de remessa

Uma remessa entra na fila de exceções quando o rastreamento a marca como exception (a transportadora reportou um problema) ou stale (nenhum movimento há muito tempo). Resolver uma exceção só arquiva o item da fila; não mexe no pedido nem na transportadora.

Prometido e realizado

Cada pedido grava a data de entrega prometida no momento da compra. Os relatórios medem a entrega real contra ela.

Endpoints

Erros comuns

1. Esperar alertas em tempo real. A varredura roda a cada hora (e uma vez ao iniciar).
2. Tratar carriers: null como erro. O SLA do radar devolve null quando não há entregas no período.
3. Achar que resolver uma exceção entrega o pedido. Só arquiva o item na fila.
4. Interpretar paid_cents do relatório de margem como o custo real da etiqueta. Hoje é uma estimativa.
5. Usar id inexistente em dispensar ou resolver e esperar erro. Respondem 200 mesmo assim.
6. Avisar de novo esperando outro voucher. O voucher é emitido uma única vez por alerta.

Próximos passos