Desenvolver o fluxo de retorno na integração de transportadoras na plataforma da Abbiamo

Modificado em Sex, 11 Jul, 2025 na (o) 5:30 PM

OBJETIVO

Este artigo tem como objetivo orientar a transportadora sobre como implementar corretamente o fluxo de retorno (devolução ao remetente) durante a integração com a plataforma da Abbiamo. O fluxo de retorno é essencial para rastrear pedidos que não puderam ser entregues ao destinatário e foram enviados de volta à origem.

PASSO A PASSO

1. Identifique a necessidade de retorno após falha de entrega

Se todas as tentativas de entrega forem esgotadas sem sucesso, e não houver nova tentativa prevista, o pedido deve ser devolvido ao remetente.
Antes de iniciar o retorno, certifique-se de que o status de falha na entrega foi enviado corretamente:

2. Inicie o fluxo de retorno com o evento returning

Este evento sinaliza que o pedido está sendo movimentado de volta para o ponto de origem:

3. Encerre o fluxo com o evento returned

Após a devolução ser concluída, envie o evento de finalização de retorno:

Este evento representa que o objeto foi devolvido ao remetente, fechando o ciclo logístico da entrega.

4. Mantenha a ordem cronológica e lógica do fluxo

A sequência dos eventos deve respeitar a lógica operacional:

1. start-delivery

2. failed-to-deliver

3. returning

4. returned

Caso o retorno também falhe por qualquer motivo (exemplo: endereço de origem não localizado), utilize:

Porque o fluxo de retorno é importante:

Garante visibilidade total do ciclo de vida da entrega.
Evita que pedidos "sumam"após falhas de entrega.
Permite que embarcadores tomem ações logísticas e financeiras com base no status real.
É obrigatório para aprovação da integração técnica em casos de operação com reversa ou reentrega não resolvida.

Considerações Finais:

O envio correto dos eventos returning e returned é obrigatório quando houver retorno físico do pedido.
Os eventos devem conter timestamp,tracking_code e location.
O campo substatus pode ser usado para detalhar o motivo da devolução, se aplicável.
O não envio desses eventos compromete a rastreabilidade e pode gerar divergências operacionais.