Receber solicitações da Abbiamo (entrega ou cancelamento) em ambiente de teste (sandbox)

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

OBJETIVO

Este artigo tem como objetivo esclarecer como funciona o recebimento de solicitações de entrega e cancelamento enviadas pela Abbiamo para a transportadora durante o processo de integração no ambiente de teste (sandbox). Essa etapa é fundamental para validar a comunicação entre os sistemas antes da ativação em produção.

PASSO A PASSO

1. Verifique se a sua loja teste já foi criada

Antes de receber qualquer solicitação da Abbiamo no sandbox, certifique-se de que:
Sua loja de testes foi criada com sucesso.
O token de acesso e a URL do ambiente foram fornecidos.
Caso não tenha recebido, verifique se o seu e-mail está elencado como ponto focal na solicitação.
É possível abrir um chamado para solicitar os dados de acesso ao ambiente de teste, novamente.
A equipe técnica da transportadora concluiu a configuração dos endpoints de recepção (coleta, entrega,cancelamento etc).

2. Aguarde o envio de pedidos simulados pela Abbiamo

Durante a fase de testes, a Abbiamo irá simular o envio de solicitações para a transportadora, como:
Solicitação de entrega;
Solicitação de cancelamento de pedido.
Essas requisições são enviadas diretamente aos endpoints definidos pela transportadora para validar o comportamento da aplicação.

3. Analise o conteúdo das requisições recebidas

As chamadas feitas pela Abbiamo seguem a estrutura definida na documentação da API. Você deverá:
Validar o código de rastreio (tracking_code).
Verificar o status do evento (ex: start_delivery,canceled).
Confirmar a presença dos campos obrigatórios (ex: timestamp, location,event).
Testar o comportamento da sua aplicação ao receber eventos de diferentes naturezas.

4. Simule o processamento interno e responda corretamente

Ao receber a solicitação:
Realize a simulação do fluxo interno, como se fosse uma entrega ou cancelamento real.
Retorne a resposta HTTP conforme o padrão (geralmente 200 OK se o evento foi aceito com sucesso).
Registre logs de requisições recebidas e tratadas (boa prática para homologação).

5. Informe à Abbiamo sobre os resultados dos testes

Os testes de envio e cancelamento fazem parte da homologação obrigatória.
Devem ser tratadas pela transportadora como se fossem pedidos reais, com respostas e processamento completo.
Os fluxos precisam estar operando de forma estável antes da entrada em produção.

Considerações Finais:

Apenas transportadoras com loja de teste ativa podem receber ligações solicitações no sandbox.
Todos os endpoints devem estar preparados para receber eventos simulados da Abbiamo.
O ambiente de homologação não processa pedidos reais, mas a simulação deve ser realista.
Logs, monitoramento e validação de estrutura são fundamentais durante o teste.