Localizar os status e eventos na documentação de API de integração com a plataforma Abbiamo

Modificado em Dom, 13 Jul, 2025 na (o) 10:54 PM

OBJETIVO

Este artigo tem como objetivo orientar onde encontrar a lista completa de status de entrega e eventos de rastreamento na documentação pública de integração da Abbiamo. Esses status são essenciais para que a transportadora envie corretamente os eventos durante o fluxo de entregas.

PASSO A PASSO

1. Acesse a documentação pública da API da Abbiamo

A documentação oficial está disponível para consulta no link: https://abbiamo.readme.io/reference/welcome-carrier

**2. Localize os status e substatus na seção específica**

Na página referenciada, você encontrará a lista completa dos eventos que representam o ciclo de vida da entrega.
A documentação divide os eventos da seguinte forma: status principais (status) e substatus (opcional).
Os status representam os marcos principais da entrega. Exemplos: collecting, collected,start-delivery.
Os substatus devem ser enviados junto com o evento de tracking apenas quando aplicável.
É possível conferir todos as definições de status e substatus nesse link: https://abbiamo.readme.io/reference/status-and-substatus

3. Utilize os exemplos de payload da documentação

A documentação apresenta exemplos de chamadas HTTP (POST) com os parâmetros corretos e estrutura JSON esperada. Veja um exemplo de envio com substatus:

4. Aplique os status durante a homologação

Os eventos listados devem ser utilizados nos testes obrigatórios no ambiente de homologação. A cobertura correta dos status é exigida para aprovação técnica da transportadora.

Importância dos status na integração:

O envio correto dos status:
Garante o rastreamento em tempo real.
Evita falhas na visualização do status da entrega para o cliente final.
É obrigatório para entrada da transportadora em produção.
Impacta nos indicadores operacionais (SLA,NPS,devolução).

CONSIDERAÇÕES FINAIS

A Abbiamo só aceita os valores de status e substatus definidos na documentação.
O uso incorreto pode gerar falha de validação na API.
Os campos event,timestamp, tracking_code e location são sempre obrigatórios.
Substatus não são obrigatórios, mas devem ser usados sempre que possível para detalhar o contexto da operação.