Cadastrar webhooks na integração de transportadoras via provider Mapp Sistemas

Modificado em Sex, 11 Jul, 2025 na (o) 7:21 PM

OBJETIVO

Este artigo tem como objetivo orientar transportadoras que utilizam a Mapp Sistemas como provider de integração sobre o cadastro dos webhooks obrigatórios na plataforma da Abbiamo, além de destacar a importância de simular um pedido teste antes de entrar em produção, já que não há etapa de homologação técnica formal para esse tipo de integração.

PASSO A PASSO

1. Configure os webhooks padrões fornecidos pela Mapp Sistemas

O provider Mapp Sistemas opera com dois endpoints padrões que devem ser registrados como webhooks na plataforma da Abbiamo:

Evento	URL do webhook
Cancelamento do Pedido	https://dominiodocliente.com.br/md/integracoes/API/webhook/cancelarPedido.php
Criação de pedido/entrega	https://dominiodocliente.com.br/md/integracoes/API/webhook/gravarservico.php

Importante: substitua dominiocliente.com.br pelo domínio real utilizado pela sua operação Mapp Sistemas.

2. Cadastre os webhooks na Abbiamo

Com os endpoints definidos, solicite o cadastro dos webhooks junto ao time da Abbiamo.
A solicitação do cadastro pode ser feita via abertura de chamado no suporte técnico.

3. Não há homologação técnica formal nesse modelo de integração

Para integrações com a Abbiamo via Mapp Sistemas não é realizada uma homologação técnica formal.
A validação da operação é de responsabilidade da transportadora.
O suporte técnico e comercial relacionado à módulos disponíveis na integração é feita diretamente com a Mapp Sistemas.
Por isso é altamente recomendável que a transportadora simule um pedido teste completo na plataforma Abbiamo antes de ativar o ambiente de produção com o embarcador.
É importante verificar se os dados chegam corretamente à Mapp Sistemas.
Se os endpoints estão funcionando com estabilidade.
Se cancelamentos e atualizações são corretamente refletidos no sistema interno.

4. Recomendações para o teste simulado

Crie um pedido fictício com todos os campos obrigatórios.
Aguarde o disparo do webhook para a Mapp e acompanhe o processamento.
Emita logs do recebimento e registre eventuais erros ou falhas.
Valide se o sistema da transportadora interpretou corretamente os dados enviados.

Porque o teste é importante mesmo sem homologação:

Garante que a operação esteja pronta para uso real.
Evita falhas com embarcadores no primeiro envio em produção.
Permite ajustes finos na estrutura ou no tratamento das requisições.
Reduz risco de divergência ou perda de pedidos.

Considerações Finais:

O fluxo entre Abbiamo e Mapp Sistemas depende exclusivamente dos webhooks para iniciar a operação.
Um erro no cadastro do domínio, endpoint ou configuração de autenticação pode interromper o recebimento dos pedidos.
A responsabilidade técnica da configuração e do monitoramento dos endpoints é da transportadora, com apoio da Mapp Sistemas.
A Abbiamo pode susprender temporariamente o envio de pedidos em caso de falhas sucessivas.