Integrar transportadora na plataforma Abbiamo: veja passo a passo detalhado

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

OBJETIVO

Este artigo tem como objetivo explicar, passo a passo, o processo de onboarding de transportadoras que ainda não estão integradas à Abbiamo. O fluxo garante uma integração técnica e operacional adequada, desde o recebimento da solicitação até o início efetivo das entregas em ambiente de produção.

PASSO A PASSO

1. Envio da Solicitação de Integração

O processo se inicia com o recebimento das informações básicas da transportadora, como dados cadastrais para criação de ambiente de teste, áreas de cobertura e escopo de atuação.
As informações cadastrais são: nome da transportadora, CNPJ, endereço de coleta (será utilizado para criar uma loja teste, onde os desenvolvedores poderão solicitar pedidos para a transportadora), e-mails dos desenvolvedores, sistema de TMS utilizado para CTe, rastreamento e atualização de status.
O canal oficial para envio é o email: carrier@abbiamolog.com

2. Envio da Documentação da API da Abbiamo

A Abbiamo compartilha com a transportadora a documentação oficial da API, que contém:
Endpoints necessários para operação (coleta, tracking,cancelamento,retorno,etc).
Estrutura e formato dos dados (JSON,timestamps, headers).
Descrição dos eventos obrigatórios de tracking.
Padrão de autenticação (Bearer Token).
Regras de negócio aplicadas a cada fluxo.
Segue o link da documentação: https://abbiamo.readme.io/reference/welcome-carrier

3. Análise da solicitação

A Equipe Abbiamo avalia se a transportadora atende aos critérios mínimos para prosseguir com o processo, como capacidade operacional, alinhamento logístico e modelo de atuação.

4. Priorização e classificação de demanda

A solicitação é classificada com base em critérios como urgência,necessidade estratégica e oportunidades de operação na malha logística, para habilitar oportunidades de negócio com nossos embarcadores.

5. Acesso ao ambiente de homologação

Após o envio das informações cadastrais e definição de priorização pela equipe Abbiamo, a transportadora recebe:
Token de autenticação exclusivo para ambiente de homologação.
URL de acesso à sandbox para testes simulados.
Guia com fluxos obrigatórios de integração: https://abbiamo.readme.io/reference/homologation

Cenários Obrigatórios a serem simulados:

Criação de entrega e status inicial.
Saída para entrega (start-delivery).
Entrega realizada com sucesso (successful).
Falha na Entrega (failed-to-deliver).
Pedido devolvido (returned).
Cancelamento antes da coleta (canceled).
Atualização de destinatário (order_receiver_update).

A transportadora deverá seguir esse passo a passo para implementar os fluxos em seu sistema e preparar-se para os testes em ambiente de homologação.

6. Testes controlados com dados simulados

São realizados testes de envio de eventos com pedidos fictícios. É necessário cobrir todos os principais cenários, conforme os fluxos definidos.

7. Validação e Homologação Técnica

A Abbiamo valida os dados recebidos , estrutura dos payloads e a pontualidade no envio dos eventos.
Com todos os testes aprovados, a homologação é concluída.

8. Emissão de Credenciais para Produção (go live)

A transportadora recebe credenciais para operar com pedidos reais no ambiente de produção.
Caso não tenha recebido, poderá solicitar novamente via abertura de chamado.

9. Início oficial das operações

Nessa etapa já é possível integrar com embarcadores que utilizam a Abbiamo;
A transportadora fica disponível no catálogo de integrações da Abbiamo para novos embarcadores;
As primeiras entregas e coletas de embarcadores são monitoradas pela analista de Sucesso do Cliente responsável pelo respectivo embarcador.

Considerações Finais:

A previsão de entrega do processo de integração é de 30 dias corridos a partir da criação do ambiente de teste.
Durante esse período, o time técnico da Abbiamo estará alocado exclusivamente para essa integração.
É fundamental respeitar esse cronograma.
ATENÇÃO: Atrasos podem impactar diretamente na priorização da sua integração, levando à despriorização na esteira de homologação de novas transportadoras. Por isso, recomendamos atenção especial aos prazos e aos alinhamentos técnicos definidos.

Transportadoras não integradas precisam obrigatoriamente passar por homologação antes de operar.
O uso correto da API é condição indispensável para a entrada em produção.
Toda comunicação de onboarding é documentada para garantir rastreabilidade.
Após a entrada em produção, a transportadora passa a ser avaliada por performance e SLA pelos embarcadores.