Atualizar status dos pedidos em ambiente de teste (sandbox)

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

OBJETIVO

Este artigo tem como objetivo explicar como deve ser realizada a atualização de status dos pedidos pela transportadora no ambiente de testes (sandbox) da Abbiamo. Essa etapa faz parte do processo de homologação e garante que a integração esteja tecnicamente pronta para operação em produção.

PASSO A PASSO

1. Acesse a documentação da API da Abbiamo

A documentação com os endpoints de status e exemplos de payload está disponível a qualquer momento: https://abbiamo.readme.io/reference/welcome-carrier

2. Utilize o token e URL do ambiente de sandbox

Após a criação da loja de teste, a Abbiamo fornece:
Um token de autenticação exclusivo.
A URL da API de testes.
As atualizações devem ser enviadas usando o método HTTP POST, com autenticação do tipo Bearer Token.

3. Envie os eventos com os status correspondentes

Durante a fase de homologação, a transportadora deve enviar eventos de atualização para os pedidos simulados. Cada status representa uma etapa do fluxo logístico. Os principais eventos são:
start_delivery: pedido saiu para entrega.
successful: entrega realizada com sucesso.
failed_to_deliver: tentativa de entrega mal sucedida.
returned: pedido devolvido.
canceled: pedido cancelado.
order_receiver_update: atualização dos dados do destinatário.

4. Siga o formato de payload exigido

Todos os eventos devem seguir a estrutura definida na documentação.
Exemplo de payload:

5. Valide a resposta da API e registre os logs

Ao enviar o status corretamente, a API deve retornar um código de sucesso (200 ok 201 Created).
Requisições com erro de schema, autenticação ou dados inválidos retornarão mensagens de erro.

6. Execute todos os cenários obrigatórios

A homologação exige que todos os fluxos sejam testados, incluindo:
Entrega concluída (successful).
Falha operacional (failed-to-deliver).
Devolução (returned).
Cancelamento (canceled).
Alteração de destinatário (order_receiver_update).

A Abbiamo acompanha o recebimento desses eventos para aprovar a integração.

Considerações finais:

É por meio dos status que a Abbiamo monitora a performance da transportadora.
Eventos inconsistentes ou ausentes podem impactar negativamente nos indicadores.
A atualização correta é obrigatória para entrada em produção.
O campo timestamp deve sempre refletir o momento real do evento.
Use o ambiente de sandbox para simular todas as rotas, e tipos de pedidos.
A Abbiamo valida não apenas o envio, mas a ordem e lógica dos eventos.
O envio de eventos com substatus melhora a visibilidade e evita reconciliações manuais.