Contrato de integração
Quais dados trafegam, em que direção, com que frequência e quem é a fonte da verdade de cada campo.
Solução
Integração de Sistemas
Sistemas que finalmente se falam.
Integramos as plataformas que a operação já usa para que o dado circule sozinho, na hora certa e uma vez só — com tratamento de falha, reprocessamento e registro de tudo o que passou.
01 O problema
Cada sistema tem a sua versão da verdade
O que costuma acontecer
- O estoque do e-commerce e o do ERP divergem, e ninguém sabe qual está certo.
- O cadastro do cliente existe em três lugares, com três grafias diferentes.
- O pedido entra em um sistema e alguém redigita no outro para faturar.
- A conciliação financeira é feita a mão, comparando relatórios de origens diferentes.
- Quando uma integração falha, o dado simplesmente some — e só se descobre depois.
Sinais de que é o seu caso
- Existe uma pessoa cujo trabalho é copiar dado de um sistema para outro.
- O relatório muda dependendo de onde você o tira.
- Vendas param quando um dos sistemas fica indisponível.
- A empresa evita trocar de fornecedor porque 'ia dar muito trabalho migrar'.
- Ninguém consegue dizer quantos registros deixaram de ser sincronizados ontem.
02 O que fazemos
As frentes desta solução.
APIs
Consumo e publicação de APIs REST, com autenticação, versionamento e limite de uso.
Eventos
Webhooks e mensageria para que a informação chegue no momento em que acontece.
Filas
O que falha não se perde: entra em fila e é reprocessado com política de retentativa.
Deduplicação
Regras para reconhecer que dois cadastros são a mesma pessoa antes de duplicá-la.
Conciliação
Rotina que compara os dois lados e aponta divergência, em vez de esperar alguém notar.
Observabilidade
Registro de cada mensagem trocada, com estado, tentativa e motivo de falha.
Reprocessamento
Reenvio controlado do que falhou, sem duplicar o que já entrou.
03 Escopo
O que você recebe — e o que não recebe.
A segunda coluna é a que quase ninguém publica. Ela existe porque um escopo com limite declarado é a única forma honesta de combinar preço e prazo.
Está incluído
- Documento de contrato de integração, com campos, direção e fonte da verdade.
- Integrações implantadas e monitoradas em produção.
- Tratamento de erro com fila, retentativa e alerta.
- Rotina de conciliação entre os sistemas integrados.
- Painel de acompanhamento das trocas, com histórico e falhas.
- Documentação técnica das interfaces.
- Procedimento de reprocessamento manual, para quando for necessário.
Não está incluído
- Licenças, planos de API ou custos de plataforma dos sistemas integrados.
- Correção de dados históricos inconsistentes nos sistemas de origem.
- Integração com sistema que não expõe interface, sem estudo de viabilidade contratado à parte.
- Garantia de disponibilidade de API de terceiro — ela não está sob nosso controle.
- Suporte à operação da integração sem contrato de sustentação.
- Migração completa de dados entre plataformas, que é um projeto próprio.
04 Contraindicação
Quando não integrar
Se um dos sistemas está prestes a ser trocado, integrar agora é construir sobre algo que vai sair. Se o volume é de poucos registros por semana, a integração pode custar mais do que a digitação que ela substitui. E se os dois sistemas discordam porque as REGRAS de negócio são diferentes, integração não resolve — ela só propaga a divergência mais rápido.
05 Prazo
Quanto tempo leva — e o que faz variar.
Uma integração ponta a ponta entre dois sistemas com API madura costuma levar semanas, não meses. O prazo estoura quando a API do outro lado é mal documentada, instável ou inexistente — e isso se descobre no diagnóstico, não no meio do projeto.
Qualidade e estabilidade das APIs envolvidas.
Quantidade de entidades a sincronizar (cliente, produto, pedido, nota).
Volume e frequência das trocas.
Necessidade de sincronização em tempo real ou em lote.
Estado dos dados históricos nos dois lados.
Regras de negócio divergentes entre os sistemas.
06 Serviços envolvidos
De onde esta solução sai.
Solução não é uma caixa separada: é a aplicação dos mesmos serviços a um problema específico.
- Sistemas Corporativos
- ERP, CRM, integrações e modernização de sistemas para sua operação. Ver o serviço →
- Sustentação
- Suporte, monitoramento e evolução contínua para os seus sistemas. Ver o serviço →
07 Como uma solução começa
Antes da proposta, o diagnóstico.
Solução não se compra de catálogo. Começa com um diagnóstico do processo real, e só depois vira escopo, prazo e proposta.
- Diagnóstico
- Conversa inicial sem custo, com quem executa o processo.
- Mapeamento
- O processo como ele acontece hoje, com os pontos de perda marcados.
- Recomendação
- O que automatizar, o que integrar e o que deixar como está.
- Proposta
- Escopo, etapas e prazo — depois do diagnóstico, nunca antes.
08 Perguntas frequentes
As perguntas que
realmente fazem.
01Precisa ser em tempo real?+
Quase nunca. Tempo real custa mais, falha mais e raramente é o que o negócio precisa. Perguntamos qual atraso é aceitável para cada dado — e boa parte deles aceita minutos ou horas sem prejuízo nenhum.
02E se a API do fornecedor sair do ar?+
A integração é desenhada assumindo que isso vai acontecer. O que não passa entra em fila, é retentado com espaçamento crescente e gera alerta se persistir. O que não fazemos é prometer disponibilidade de uma API que não é nossa.
03Vocês integram com qualquer sistema?+
Com qualquer sistema que ofereça uma forma documentada de troca. Quando não há API, avaliamos alternativas e dizemos com clareza o quanto cada uma é frágil. Sistema fechado sem interface é limite técnico real, não falta de vontade.
04Quem decide qual sistema está certo quando os dados divergem?+
Isso é a primeira decisão do projeto, não a última. Cada campo tem uma fonte da verdade declarada no contrato de integração. Sem isso, integração vira uma guerra silenciosa entre dois bancos de dados.
05Dá para integrar sem mexer nos sistemas atuais?+
Na maioria dos casos, sim: a integração fica por fora, consumindo e publicando. Quando é preciso alterar algo dentro de um dos sistemas, dizemos antes de começar.
09 Outras soluções
O que mais resolvemos.
Integração de Sistemas
Vamos falar sobre
o seu caso?
A conversa inicial e o diagnóstico preliminar não têm custo. Só depois vêm o escopo e a proposta.