Validar fluxos no ambiente de teste antes da homologação final para integração da transportadora com a plataforma da Abbiamo

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

OBJETIVO

Este artigo tem como objetivo apresentar os fluxos obrigatórios que devem ser validados no ambiente de teste (sandbox) antes da homologação final. Essa etapa garante que a transportadora está tecnicamente pronta para operar com a plataforma da Abbiamo, com todos os eventos logísticos funcionando corretamente.

PASSO A PASSO

1. Confirme a ativação da loja de testes

Antes de iniciar a validação, certifique-se de que:
A loja de teste foi criada pela Abbiamo.
O token de autenticação e a URL do ambiente de sandbox foram recebidos.
A equipe técnica tem acesso à documentação oficial da API da Abbiamo.

2. Execute os fluxos obrigatórios em ambiente de testes

Fluxos de Entrega

Evento	Descrição
start-delivery	Pedido saiu para entrega
successful	Entrega concluída com sucesso
failed-to-deliver	Falha na tentativa de entrega
returned	Pedido devolvido ao remetente

Fluxos de Atualização e Cancelamento

Evento	Descrição
order_receiver_update	Atualização dos dados do destinatário
canceled	Cancelamento do pedido antes da coleta

3. Envie os eventos no formato correto

Todos os eventos devem ser enviados via POST em JSON, conforme a documentação. Exemplo:

Campos obrigatórios: tracking_code, event, timestamp,location.

O uso de substatus é opcional, mas recomendado para detalhamento de falhas.

4. Verifique as respostas da API após cada envio

Cada evento válido deve retornar uma resposta de sucesso (200 OK ou 201 Created).
Requisições com erro de estrutura, dados ou autenticação devem ser corrigidas antes do avanço.

5. Comunique a Abbiamo após concluir os testes

Após validar todos os fluxos exigidos, a transportadora deve informar a equipe da Abbiamo.
A homologação técnica só será concluída após a análise e confirmação do correto funcionamento de todos os eventos.

Importância da validação completa:

Evita falhas operacionais e inconsistências em produção.
Garante o rastreamento correto dos pedidos na plataforma da Abbiamo.
É exigência obrigatória para liberação da operação em ambiente produtivo.

Considerações Finais:

Todos os fluxos devem ser executados, mesmo que sua operação atual ainda não contemple todos eles.
A ordem lógica dos eventos também é analisada (ex: não é permitido registrar uma entrega antes do envio).
O ambiente de teste simula as interações reais e deve ser tratado como um ambiente de produção durante os testes.