O trabalho difícil costuma começar onde a documentação termina. Os modelos de dados não batem, o sistema antigo precisa conviver com o novo, outra empresa controla uma aprovação e alguém precisa responder pelo que acontece depois da primeira requisição bem-sucedida.

Uma integração complexa não é uma requisição saindo de um sistema e chegando a outro. É uma mudança em como dados, responsabilidade e falhas atravessam a empresa.

Os dois lados têm campos para o mesmo dado, mas as regras, o histórico e as exceções não encaixam um a um.

A operação não pode parar para um corte limpo. Contas, registros ou fluxos mudam por etapas sem criar duas verdades concorrentes.

Certificação, revisão de segurança, fila de merge ou acesso à produção podem estar fora do seu controle sem sair da sua responsabilidade.

Endpoint sem documentação é só um endpoint. Quem constrói em cima precisa de exemplos, erros bem definidos e um jeito de descobrir o que aconteceu.

A maioria das estimativas cobre o cenário em que tudo dá certo entre os endpoints. O risco de produção mora ao redor: histórico, falha parcial, retentativas, revisão externa, corte, monitoramento e a pessoa que responde quando a realidade não cabe no modelo previsto.

A tarefa visível de programação ganha escopo. Tudo que torna o resultado confiável fica implícito.

A estimativa cobre autenticação e payload, mas não quem manda no dado, migração, conciliação ou o fluxo nos dois lados.

A engenharia pode estar pronta para revisão no prazo enquanto a aprovação continua com outro time. Tratar os dois como o mesmo compromisso cria uma falsa certeza.

Documentação, observabilidade, retentativas, suporte e reversão só viram urgentes quando alguém já depende da integração.

A gente trata a integração como um produto: implementação, migração, coordenação externa e operação são planejadas juntas, e alguém responde por ela depois do go-live.

1. **Mapear o caminho inteiro.** Identificar quem cria o dado, quem altera, onde vivem as exceções e qual sistema manda em cada etapa. 2. **Provar tradução e falha.** Testar exemplos reais, casos-limite, retentativas e estados parciais antes que volume e dependências tornem tudo caro. 3. **Fazer o corte por etapas.** Mover primeiro um recorte controlado, manter a operação atual disponível e tornar a conciliação explícita antes de expandir. 4. **Operar e explicar.** Entregar monitoramento, logs acionáveis, documentação, exemplos e um responsável claro por incidentes e revisão externa.

À medida que a Silo crescia, cada nova rede poderia criar outro indexador, outra API, outro caminho de monitoramento e novas instruções de integração. A Bleu construiu uma camada de dados documentada para todas elas e assumiu sua operação em produção.

**[Silo Finance](https://bleu.builders/pt/cases/silo-finance/)** — Um único time respondeu pela camada de dados inteira: indexação, APIs, monitoramento e controle do custo de infraestrutura.

> “É fácil trabalhar com vocês. Vocês assumem responsabilidade, o que é raro. Dá pra confiar na entrega, o que também é raro.” > > — Siros, Silo Finance

A conversa útil começa fora da lista de endpoints: dados, dependências externas, migração, risco operacional e quem precisa confiar no resultado.

Alguns conectores são realmente simples, e aí você não precisa da gente. O modelo faz sentido quando as decisões ao redor importam tanto quanto os endpoints.