Inserir o fluxo de segunda tentativa na integração da transportadora com a plataforma da Abbiamo

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

OBJETIVO

Este artigo tem como objetivo orientar a transportadora sobre como inserir o fluxo de segunda tentativa de entrega na sua integração com a plataforma da Abbiamo. Essa funcionalidade é essencial para garantir que múltiplas tentativas de entrega sejam corretamente refletidas no histórico do pedido e no rastreamento em tempo real.

PASSO A PASSO

1. Notifique a primeira tentativa de entrega com falha

Caso a entrega não tenha sido realizada com sucesso, o sistema da transportadora deve enviar o seguinte evento à Abbiamo:
failed-to-deliver: primeira tentativa de entrega mal sucedida.
Sempre que possível, inclua um substatus para qualificar o motivo da falha (ex: recipient-absent,delivery-refused, adress-not-found).

2. Agende uma nova tentativa de entrega internamente

Com base na sua lógica operacional, o pedido pode:
Retornar para fila de entregas automaticamente, ou
Ser reagendado manualmente para nova tentativa.

3. Envie novamente o evento start-delivery para iniciar a segunda tentativa

Assim que o pedido for colocado novamente em rota, envie o evento para informar à Abbiamo o reenvio:

Isso reinicia a visibilidade da entrega no sistema da Abbiamo e sinaliza o início de uma nova tentativa.

4. Finalize o fluxo com o evento apropriado da segunda tentativa

Ao concluir a nova tentativa, envie um dos eventos a seguir:

Evento	Descrição
successful	entrega realizada com sucesso
failed-to-deliver	segunda tentativa também falhou
returned	pedido retornado ao remetente

Caso haja nova falha, envie também o substatus corresponde ao motivo.

5. Mantenha a ordem cronológica dos eventos

A Abbiamo exige consistência na sequência dos eventos para garantir a integridade do rastreamento.
Exemplo do fluxo completo:

1. start-delivery (1ª tentativa)

2. failed-to-deliver

3. start-delivery (2ª tentativa)

4. successful ou failed-to-deliver ou returned

Por que inserir o fluxo de segunda tentativa na integração:

Permite visibilidade clara de múltiplas tentativas de entrega.
Evita confusões operacionais e reconciliações manuais.
Reflete fielmente a operação da transportadora dentro da plataforma.
É considerado um ponto importante durante o processo de homologação.

Considerações Finais:

A transportadora pode repetir o fluxo de start-delivery quantas vezes forem necessárias, desde que com timestamps e substatus corretos.
A Abbiamo utiliza os dados de tentativas para alimentar indicadores de performance e SLA.
A omissão do fluxo de segunda tentativa pode prejudicar a experiência do cliente final e a visibilidade do embarcador.