Conexões de API entre ERP e terceiros
ERP para terceiros: CRM, logística, tributos e identidade
Conexõ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 conteúdo 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 rastreamento, por webhook (assíncrono).
- De Plataforma de integração para Plataforma de faturamento eletrônico e fiscal: Faturas para autorização fiscal, por SOAP/XML · REST (fluxo principal).
- De Plataforma de integração para Provedor de KYC e identidade: Verificações de identidade, por REST/JSON (fluxo principal).
- De Provedor 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 Equipe de suporte: Alerta com o conteúdo 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 faturamento eletrônico e de tributos, e os provedores 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 rastreamento 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 à equipe 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, contatos e pedidos no CRM, para que as equipes 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 rastreamento chega
A transportadora envia eventos de rastreamento e de comprovante de entrega por webhook, e a plataforma atualiza o pedido no ERP.
As faturas são autorizadas
As faturas são enviadas à plataforma de faturamento eletrônico ou de tributos no formato que a autoridade exige, e o status de autorização é guardado junto à fatura.
As identidades são verificadas
Novos clientes ou fornecedores são enviados ao provedor 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 equipe de suporte é alertada. Depois da correção, ela é reenviada a partir da fila.
Um parceiro muda a sua API
Testes de contrato rodam 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 registro 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 vocês conseguem conectar?
Qualquer serviço com API documentada ou interface de arquivo. Exemplos típicos são plataformas de CRM, transportadoras e operadores logísticos, marketplaces, plataformas de faturamento eletrônico e de tributos, folha de pagamento, provedores 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 conectados a um ERP, uma plataforma como MuleSoft, Boomi ou Azure Logic Apps, ou um conjunto de serviços sob medida sobre uma fila de mensagens, mantém mapeamento, repetições e monitoramento em um só lugar. Com um ou dois parceiros, conexões diretas podem bastar. Apresentamos as vantagens e desvantagens, incluindo custos de licença, para o seu caso.
Vocês podem nos conectar a plataformas de faturamento eletrônico e de autorização fiscal?
Sim. Muitos países agora exigem que as faturas sejam emitidas ou autorizadas por uma plataforma governamental ou credenciada em um formato definido. Integramos o ERP à plataforma que o seu país exige ou a um provedor credenciado, guardamos o status e os identificadores de autorização junto a cada fatura e tratamos as rejeições. Os seus consultores fiscais confirmam as regras aplicáveis a você.
Como vocês 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 rodando. As mensagens para esse parceiro são repetidas e depois enfileiradas, a equipe 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 esperando.
Quem é o dono dos conectores que vocês constroem?
A propriedade intelectual do trabalho que construímos para você é 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 equipe ou outro fornecedor possa mantê-los. Quaisquer ferramentas da XSIS que já existiam continuam nossas e são licenciadas para você. 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 você precisa construir, conectar ou proteger. Um arquiteto analisa com você e recomenda por onde começar.
O que acontece a seguir
Definição do horário
Nossa equipe envia um e-mail para combinar o horário da sessão.
Sessão de pré-consultoria
Uma sessão on-line gratuita de pré-consultoria de 30 minutos: analisamos os seus objetivos, sistemas e restrições.
Avaliação de prontidão
Em uma 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 a trilha adequada.
Escolha da trilha
Projetos com escopo pronto recebem uma proposta vinculante em 3 a 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 a 2 semanas. O Blueprint Studio e o diagnóstico têm cada um uma taxa fixa, cotada na proposta.