Ligações de API entre ERP e terceiros
ERP para terceiros: CRM, logística, tributos e identidade
Ligações REST, SOAP, webhook e iPaaS entre o seu ERP e os serviços em volta dele, com repetições e alertas.
Blueprint
Role para o lado para ver o desenho completo.
ERP para terceiros: uma plataforma, muitos parceiros
Os eventos de negócio saem do ERP uma única vez e a plataforma de integração os entrega a cada parceiro no formato que ele espera. Os callbacks voltam pelo mesmo caminho. Uma mensagem que ainda falha após as novas tentativas vai para uma fila de mensagens não entregues e gera um alerta com o payload anexado.
- Fluxo principal
- Assíncrono
- Caminho de exceção
O fluxo em 9 etapas
O fluxo, etapa a etapa
- De ERP para Plataforma de integração: Eventos de negócio, por REST · OData · webhook (fluxo principal).
- De Plataforma de integração para CRM: Clientes e pedidos, por REST/JSON (fluxo principal).
- De Plataforma de integração para Logística e transportadoras: Envios agendados, por REST/JSON (fluxo principal).
- De Logística e transportadoras para Plataforma de integração: Eventos de rastreio, por webhook (assíncrono).
- De Plataforma de integração para Plataforma de faturação eletrónica e impostos: Faturas para validação fiscal, por SOAP/XML · REST (fluxo principal).
- De Plataforma de integração para Fornecedor de KYC e identidade: Verificações de identidade, por REST/JSON (fluxo principal).
- De Fornecedor de KYC e identidade para Plataforma de integração: Resultados das verificações, por webhook (assíncrono).
- De Plataforma de integração para Fila de mensagens não entregues e alertas: Falha após as novas tentativas, para uma fila de mensagens não entregues (caminho de exceção).
- De Fila de mensagens não entregues e alertas para Equipa de suporte: Alerta com o payload e o erro (caminho de exceção).
Visão geral
Este é o fluxo entre o seu ERP e os serviços em volta dele: o CRM, as transportadoras e operadores logísticos, as plataformas de faturação eletrónica e de tributos, e os fornecedores de identidade e de KYC. Cada parceiro tem a sua própria API, o seu próprio formato e as suas próprias falhas, e cada um costuma chegar como um projeto separado.
O desenho de referência envia os eventos de negócio do ERP uma única vez, para uma plataforma de integração que os entrega a cada parceiro no formato que ele espera, por REST, SOAP, webhooks ou EDI sobre AS2 onde os parceiros comerciais exigirem. Callbacks, como eventos de rastreio ou resultados de verificação, voltam pela mesma plataforma.
Um parceiro fora do ar é um evento normal, não uma emergência. Falhas temporárias são repetidas. Uma mensagem que ainda falha após as repetições vai para uma fila de mensagens não entregues, e um alerta chega à equipa de suporte com o conteúdo e o erro, para que possa ser corrigida e reenviada.
Como o fluxo funciona
O ERP publica um evento
Quando um cliente, pedido ou fatura muda, o ERP publica um evento de negócio na plataforma de integração, por meio da sua API, de serviços OData ou de webhooks.
O CRM fica atualizado
A plataforma atualiza contas, contactos e pedidos no CRM, para que as equipas de vendas e de atendimento vejam o que o ERP sabe.
Os envios são agendados
Pedidos prontos para envio são agendados com a transportadora ou o operador logístico pela sua API, e etiquetas e referências voltam.
O rastreio chega
A transportadora envia eventos de rastreio e de comprovante de entrega por webhook, e a plataforma atualiza o pedido no ERP.
As faturas são validadas
As faturas são enviadas à plataforma de faturação eletrónica ou de tributos no formato que a autoridade exige, e o estado de validação é guardado junto à fatura.
As identidades são verificadas
Novos clientes ou fornecedores são enviados ao fornecedor de KYC ou de identidade, e o resultado retorna por webhook antes da ativação da conta.
Quando algo falha
Um parceiro está temporariamente indisponível
A chamada é repetida com intervalos crescentes. Uma chave de idempotência em cada gravação garante que uma repetição nunca crie um segundo envio ou uma segunda fatura.
Uma mensagem ainda falha após as repetições
Ela vai para uma fila de mensagens não entregues com o conteúdo e o erro do parceiro, e a equipa de suporte é alertada. Depois da correção, ela é reenviada a partir da fila.
Um parceiro muda a sua API
Testes de contrato correm contra o ambiente de testes de cada parceiro e detectam a mudança. Mudanças anunciadas são agendadas e testadas antes do prazo do parceiro.
Os dados são rejeitados
Um parceiro que recusa dados por um motivo de negócio, como um número fiscal ausente, devolve o erro ao registo no ERP, onde o responsável pode corrigi-lo.
Normas e sistemas
- Integração
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- Identidade e acesso
- OAuth 2.0
Perguntas e respostas
Quais serviços de terceiros conseguem ligar?
Qualquer serviço com API documentada ou interface de ficheiro. Exemplos típicos são plataformas de CRM, transportadoras e operadores logísticos, marketplaces, plataformas de faturação eletrónica e de tributos, folha de pagamento, fornecedores de KYC e de identidade, e parceiros comerciais que trocam documentos EDI sobre AS2. Revisamos a API, os limites e o ambiente de testes de cada parceiro antes de nos comprometermos com um plano.
Precisamos de uma plataforma de integração para isso?
Quando vários parceiros estão ligados a um ERP, uma plataforma como MuleSoft, Boomi ou Azure Logic Apps, ou um conjunto de serviços à medida sobre uma fila de mensagens, mantém mapeamento, repetições e monitorização num só lugar. Com um ou dois parceiros, ligações diretas podem bastar. Apresentamos as trocas, incluindo custos de licença, para o seu caso.
Podem nos ligar a plataformas de faturação eletrónica e de validação fiscal?
Sim. Muitos países agora exigem que as faturas sejam emitidas ou validadas por uma plataforma governamental ou credenciada num formato definido. Integramos o ERP à plataforma que o seu país exige ou a um fornecedor credenciado, guardamos o estado e os identificadores de validação associados a cada fatura e tratamos as rejeições. Os seus consultores fiscais confirmam as regras aplicáveis a si.
Como protegem os webhooks recebidos?
Todo webhook recebido é verificado antes de ser processado: por assinatura, quando o parceiro assina as suas mensagens, e por verificação de token, origem e timestamp, quando não assina. Os conteúdos são validados contra o contrato, e os eventos são processados uma única vez mesmo que o parceiro os envie mais de uma.
O que acontece quando um parceiro fica fora do ar?
O restante dos fluxos continua a correr. As mensagens para esse parceiro são repetidas e depois enfileiradas, a equipa de suporte é alertada e nada se perde. Quando o parceiro se recupera, as mensagens enfileiradas são reenviadas em ordem. O painel mostra qual parceiro está afetado e quantas mensagens estão à espera.
Quem é o dono dos conectores que constroem?
A propriedade intelectual do trabalho que construímos para si é sua desde o primeiro commit — sem etapa de cessão no final. Os conectores são entregues com o código-fonte, os testes e a documentação, para que a sua equipa ou outro fornecedor possa mantê-los. Quaisquer ferramentas da XSIS que já existiam continuam nossas e são licenciadas para si. As APIs dos parceiros e as licenças das plataformas de integração permanecem sob os termos desses fornecedores.
Comece com uma conversa, não com um contrato.
Conte o que precisa construir, ligar ou proteger. Um arquiteto analisa consigo e recomenda por onde começar.
O que acontece a seguir
Definição do horário
A nossa equipa envia um e-mail para combinar o horário da sessão.
Sessão de pré-consultoria
Uma sessão em linha gratuita de pré-consultoria de 30 minutos: analisamos os seus objetivos, sistemas e restrições.
Avaliação de prontidão
Numa avaliação de prontidão gratuita de 48 horas, um Arquiteto Principal verifica o seu projeto com a Definição de Prontidão em 6 pontos e recomenda o percurso adequado.
Escolha do percurso
Projetos com âmbito pronto recebem uma proposta vinculante em 3–5 dias úteis. Projetos em estágio de conceito começam no Blueprint Studio. Um sistema em produção com falhas, não documentado ou que precisa de integração começa com um diagnóstico de 1–2 semanas. O Blueprint Studio e o diagnóstico têm cada um uma taxa fixa, cotada na proposta.