Coletar o dado é metade do trabalho. A outra metade é fazer ele aparecer onde a decisão acontece, e "onde a decisão acontece" quase nunca é uma tela nova.
Se a equipe precisa abrir mais um sistema para ver o dado coletado, o projeto falhou mesmo com a coleta funcionando. Este artigo trata da etapa de entrega.
Os Três Modos de Entrega
A escolha não é de gosto. Cada modo resolve um tipo de necessidade e cobra um preço diferente em complexidade.
Tempo real
O registro é empurrado assim que a coleta confirma o dado na fonte.
Quando usar: o dado dispara uma ação imediata, seja liberar um cadastro, bloquear uma operação ou avisar um analista.
O que cobra: o destino precisa aguentar recebimento a qualquer momento e ser idempotente. Entrega em tempo real vai ser reentregue em algum momento, e o sistema precisa saber ignorar duplicata.
Em lote
Um pacote consolidado no horário combinado.
Quando usar: o consumo é analítico ou o processo do cliente já é batch: fechamento diário, carga em data warehouse, relatório da manhã.
O que cobra: disciplina de metadados. Um lote precisa dizer quantos registros traz e quantos mudaram, para que o destino distinga lote vazio de lote que não rodou.
Por gatilho
A entrega dispara quando muda exatamente o dado que você monitora.
Quando usar: o volume total é alto, mas a fração relevante é pequena. Não faz sentido empurrar 50 mil registros diários se o time só age sobre os 40 que mudaram.
O que cobra: a regra de "o que conta como mudança" precisa estar escrita. Mudança de formatação de um campo não pode gerar evento.
Onde o Dado Chega
Na prática, os destinos se repetem. Do lado de ERP, aparecem com mais frequência Protheus (TOTVS), Omie, Sankhya, Senior, Bling, Tiny, Conta Azul, SAP, Linx e NetSuite. Do lado de CRM, Salesforce, HubSpot, RD Station, Pipedrive, Ploomes, Agendor, Zoho CRM, Zendesk, Freshsales e Kommo.
Sistema fora do catálogo não é impedimento. O conector se constrói por API, webhook, banco ou arquivo. A coleta segue igual, muda só a ponta.
O ponto importante é outro: o catálogo não é o critério de decisão. O critério é se o sistema de destino aceita escrita programática e se ele tem um identificador estável para o registro. Sem chave estável, não existe atualização, só inserção duplicada.
As Cinco Regras Que Evitam Retrabalho na Integração
1. Idempotência antes de qualquer coisa
Toda entrega precisa carregar um identificador de coleta. Se o mesmo identificador chegar duas vezes, o destino atualiza, não duplica. Sem isso, uma reentrega legítima vira registro duplicado no ERP, e alguém vai limpar isso na mão depois.
2. Confirmação explícita, não "enviou"
Rota de entrega que não devolve confirmação é rota que você acha que funcionou. O padrão mínimo: webhook responde, API responde, banco confirma gravação. O que não confirmou continua pendente e é reentregue.
3. Vocabulário do dado é do serviço, não da fonte
O campo entregue tem nome e domínio estáveis, definidos no escopo. Se o portal público muda o rótulo da tela, o payload não muda. Essa é a razão de existir a etapa de normalização.
4. Metadados do lote são obrigatórios
Identificação da coleta, fonte, contagem de registros, contagem de alterações e instante da atualização. Esses cinco campos são o que permite ao destino se defender de meia entrega.
5. Credencial exclusiva por cliente e log por entrega
Credencial por cliente isola o impacto de bloqueio e limita o alcance de um vazamento. Log por entrega é o que permite responder "o que exatamente foi gravado no dia 12" sem depender da memória de alguém.
Como Escolher o Modo Certo
| Sua situação | Modo indicado |
|---|---|
| O dado dispara ação imediata na frente do usuário | Tempo real |
| O consumo é relatório, BI ou carga analítica | Em lote |
| Volume alto, fração relevante pequena | Por gatilho |
| O destino não aguenta escrita a qualquer hora | Em lote, em janela combinada |
| Vários destinos com necessidades diferentes | Combinação: lote para o warehouse, gatilho para o CRM |
A última linha é a mais comum na prática. Raramente existe um modo só.
O Que Testar Antes de Entrar em Produção
Formatos e Protocolos
A entrega acontece por API REST ou webhook, e os formatos usuais são JSON, CSV, XLSX e XML. A escolha do formato costuma ser ditada pelo destino, não pela origem: warehouse gosta de arquivo, CRM gosta de JSON, financeiro ainda pede planilha.
Nenhum desses é decisão de arquitetura. A decisão de arquitetura é a idempotência e a confirmação. O resto é serialização.
Por onde começar a integração
Se o seu time já pergunta "e como isso entra no nosso sistema?", a resposta começa por três informações: qual sistema, qual identificador estável ele usa e qual dos três modos de entrega o processo pede.
Quer verificar se o seu ERP ou CRM já tem conexão pronta? Vale checar antes de desenhar qualquer integração sob medida.