Gestão Logística de Entrega
Visão Geral
Este módulo permite que parceiros integradores notifiquem o aiqfome sobre cada etapa do ciclo logístico do pedido. O objetivo é fornecer visibilidade em tempo real para Sellers e Clientes Finais através de rastreamento preciso.
Regras de Negócio e Operação
Sequência Lógica: Os status logísticos devem ser atualizados em ordem obrigatória. A API retorna erro se algum status for pulado (por exemplo, ao tentar informar
DELIVERY_ONGOINGantes doARRIVED_AT_MERCHANT).Dados do Entregador: O envio do nome e telefone do entregador é opcional. Caso esses campos sejam omitidos, eles serão registrados como nulos e o status será atualizado normalmente.
Webhooks: Cada transição de status realizada com sucesso dispara um evento de webhook. O parceiro integrador deve cadastrar esses eventos conforme o fluxo de registro existente. Para mais detalhes, consulte a Documentação de Webhooks.
Entregador a Caminho da Loja
Indica que um entregador foi alocado para o pedido e iniciou o deslocamento até o estabelecimento. Este é o marco inicial do rastreamento logístico.
/logistic/{order_id}/pickup-ongoingParâmetros do Corpo (Payload)
| Campo | Obrigatório | Descrição |
|---|---|---|
driver_name | ❌ | Nome do entregador alocado. |
driver_phone | ❌ | Telefone de contato do entregador. |
Chegada no Estabelecimento
Informa que o entregador chegou fisicamente à loja e está pronto para coletar os itens. É um marco operacional crítico para que a loja agilize a entrega física do pacote ao profissional.
/logistic/{order_id}/arrived-at-merchantInício da Rota de Entrega
Confirma que o pedido foi coletado na loja e o entregador está oficialmente em rota final para o endereço do cliente. Este status define a transição da responsabilidade da loja para a fase de transporte.
/logistic/{order_id}/delivery-ongoingChegada no Cliente
Sinaliza que o entregador chegou ao destino final e encontra-se no endereço de entrega. Este marco melhora o aviso ao cliente antes da conclusão definitiva.
/logistic/{order_id}/arrived-at-customerConfirmação de Entrega
Confirma que o pedido foi entregue com sucesso ao cliente final. Representa o fechamento do ciclo de vida logístico e a confirmação final da transação.
/logistic/{order_id}/order-delivered