Serviços de middleware e integração de APIs
Uma camada de integração para cada sistema e parceiro, com os casos de falha tratados
Quando cada ligação é um script próprio
A maioria das empresas depende de serviços que não opera: um CRM, transportadoras e fornecedores de logística 3PL, plataformas fiscais, triagem de KYC e PLD e ferramentas SaaS. Cada um tem a sua própria API, os seus próprios limites e a sua própria forma de falhar.
Ligados um de cada vez, eles tornam-se um conjunto de scripts ponto a ponto que ninguém entende por completo. Um parceiro muda a sua API, uma mensagem perde-se à noite, e o primeiro sinal é a reclamação de um cliente.
O que muda para si
Uma camada em vez de uma teia de scripts
Os sistemas publicam e recebem eventos por uma única camada governada, para que acrescentar um parceiro não signifique tocar em todos os sistemas.
Nada perdido, nada duplicado
Gravações idempotentes, novas tentativas com espera crescente e uma fila de mensagens não entregues, para que uma falha seja capturada e reprocessada em vez de perdida.
Cada fluxo visível
Rastreios, taxas de erro e latência por parceiro, com alertas que dizem qual parceiro falhou e como.
O que entregamos
Gateway de API
Uma única porta de entrada governada para as APIs que publica: autenticação, limites de taxa, cotas, versionamento e análises de uso.
Malha de eventos e barramento de serviços corporativo
Uma malha de eventos é uma rede de brokers que encaminha eventos entre sistemas e sites em tempo real. Quando o seu parque já corre num barramento de serviços corporativo (ESB), também projetamos e ampliamos nele.
Automação de fluxos com BPMN
Processos que atravessam sistemas e pessoas, como integração de clientes ou aprovações, modelados em BPMN (Business Process Model and Notation) e executados por um motor de fluxo de trabalho.
Conectores para o ecossistema de terceiros
Conectores por REST, SOAP e webhooks, ou por um iPaaS (plataforma de integração como serviço), para CRM, logística 3PL, fornecedores fiscais e de KYC e PLD.
Contratos de API e versionamento
Definições OpenAPI ou WSDL para cada interface, com regras de campos, códigos de erro e limites, e uma política para absorver mudanças dos parceiros.
Identidade e segredos
Início de sessão único com OpenID Connect ou SAML, acesso de serviços com OAuth 2.0 e credenciais num cofre de segredos, com âmbito e rotação.
Confiabilidade e monitorização
Chaves de idempotência, novas tentativas, filas de mensagens não entregues e um caminho de operação humana para cada exceção, com painéis e alertas por parceiro.
Como trabalhamos
Fazer o inventário
Listamos os sistemas e parceiros de que depende, os dados de que cada um precisa e as falhas que vê hoje.
Projetar a camada
Escrevemos os contratos de API e escolhemos chamadas diretas, eventos, um ESB ou uma plataforma de integração para cada fluxo.
Construir os conectores
Construímos cada conector com o seu tratamento de erros, proteção contra duplicidade e registo desde o início.
Testar com cada parceiro
Executamos testes de contrato e cenários de ponta a ponta no ambiente de teste de cada parceiro, incluindo falhas.
Lançar com segurança
Lançamos em etapas e mantemos o caminho antigo disponível até o novo ser comprovado.
Operar e adaptar
Acompanhamos taxas de erro e mensagens não entregues e adaptamos os conectores quando os parceiros mudam as suas APIs.
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).
Protocolos, plataformas e padrões
Se já tem uma plataforma de integração, construímos sobre ela. Nomear um produto não significa uma parceria com o fornecedor.
- Dados e análises
- Apache Kafka
- Integração
- REST
- SOAP
- GraphQL
- Webhooks
- OpenAPI
- MuleSoft
- Boomi
- Azure Logic Apps
- Apache Camel
- RabbitMQ
- Identidade e acesso
- OAuth 2.0
- OpenID Connect
- SAML 2.0
- SCIM
- Keycloak
- Microsoft Entra ID
- Normas de saúde
- HL7 v2
- HL7 FHIR
Prova em produção
Para um banco de grande porte do Golfo e um conglomerado regional, construímos uma malha de middleware orientada a eventos em Apache Kafka. Ela liga o SAP S/4HANA a bancos e autoridades fiscais, com segredos mantidos no HashiCorp Vault.
Como começar
Uma lista clara de parceiros e fluxos vai direto para uma proposta. Uma teia não documentada de integrações existentes começa pela Ponte de Diagnóstico Brownfield.
O que acontece a seguir
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.
Entrega em cinco etapas
Mobilização, sprints com demonstrações ao vivo, integração e robustecimento, aceitação e entrada em produção e, depois, serviços geridos. Após o lançamento vem um período de garantia e, depois, suporte e manutenção opcionais.
Projetos com resultado fixo e serviços geridos 24/7
Entrega com âmbito fixo e orientada a marcos, com responsáveis de entrega nomeados, e serviços geridos de aplicação 24 horas por dia sob governação de SLA.
Especialistas embarcados e reforço estratégico
Engenheiros principais e especialistas nearshore e no local, e arquitetos embarcados de solução, de transformação, de PQC e de integração.
Perguntas e respostas
Devemos usar uma plataforma de integração ou código à medida?
Depende de quantas ligações tem e de quem vai operá-las. Uma plataforma de integração como MuleSoft, Boomi ou Azure Logic Apps oferece conectores prontos, mapeamento e monitorização num só lugar, a um custo de licença. Serviços à medida dão controlo total e nenhuma licença, mas mais código para manter. Comparamos os dois para o seu caso.
Qual é a diferença entre um ESB e uma malha de eventos?
Um barramento de serviços corporativo encaminha e transforma mensagens por um hub central. Uma malha de eventos distribui eventos por uma rede de brokers ligados, para que sistemas em nuvens e sites diferentes publiquem e assinem diretamente. Muitos parques usam os dois enquanto migram de um para o outro.
O que acontece quando a API de um parceiro está fora do ar?
Os pedidos que falham por motivos temporários são repetidos com atrasos crescentes. Cada gravação carrega uma chave de idempotência, para que uma nova tentativa nunca crie um segundo pedido ou uma segunda fatura. Uma mensagem que ainda falha vai para uma fila de mensagens não entregues com a carga útil e o erro. Um alerta chega à sua equipa, e a mensagem é reprocessada quando o parceiro se recupera.
Como tratam mudanças de versão de API?
Para as APIs que publica, versionamos, mantemos versões antigas em execução por um período acordado e informamos aos consumidores o que muda. Para as APIs que chama, acompanhamos os avisos de descontinuação de cada parceiro e testamos novas versões no sandbox dele. Os testes de contrato capturam uma mudança não anunciada antes de ela chegar à produção.
Conseguem ligar o nosso fornecedor de identidade?
Sim. Adicionamos início de sessão único com OpenID Connect ou SAML 2.0 por fornecedores como Microsoft Entra ID ou Keycloak. Os utilizadores são provisionados com SCIM quando a aplicação é compatível. O seu fornecedor de identidade continua a ser o único lugar onde o acesso é concedido e removido.
Como lidam com limites de taxa?
Projetamos em torno dos limites publicados de cada parceiro. Agrupamos pedidos quando a API permite, armazenamos em cache dados que raramente mudam, distribuímos tarefas agendadas e recuamos quando um limite está próximo. A monitorização mostra o quão perto cada fluxo opera do seu limite.
Pronto para construir? Peça uma proposta.
Envie os seus requisitos ou o seu RFP. Os nossos arquitetos os validam e devolvem uma proposta vinculante de âmbito fixo.
O que acontece a seguir
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.
Proposta vinculante
Após validação de arquitetura sem custo, recebe uma proposta vinculante de âmbito fixo em 3–5 dias úteis: marcos, arquitetura, estrutura da equipa e SLAs. Assinamos um acordo de confidencialidade (NDA) consigo quando solicitado, antes de partilhar os seus requisitos.
Mobilização
Depois da assinatura, as nossas equipas de engenharia iniciam o Sprint 0 em 5–10 dias úteis após a assinatura do contrato.
Entrega em cinco etapas
Mobilização, sprints com demonstrações ao vivo, integração e robustecimento, aceitação e entrada em produção e, depois, serviços geridos. Após o lançamento vem um período de garantia e, depois, suporte e manutenção opcionais.