Resposta curta
Integração liga ERP, e-commerce, CRM, banco e planilha por API, webhook ou arquivo, sem uma pessoa copiando no meio. O que decide o projeto não é a conexão, é o que acontece quando ela falha: repetição sem duplicar, fila que segura o pico e reconciliação diária que encontra o que passou batido.
A pessoa que existe só porque dois sistemas não conversam
Em toda operação que cresceu por partes existe pelo menos um cargo invisível: alguém que baixa um relatório de um sistema, confere, e digita em outro. Não está em processo nenhum, não aparece em organograma, mas consome horas de uma pessoa que normalmente é das mais experientes do time.
O custo óbvio é o tempo. O caro é o resto: enquanto o dado está em trânsito, existem duas verdades sobre o mesmo pedido. Se o estoque do e-commerce só atualiza à noite, você vende o que não tem. Se o pagamento entra no banco e só aparece no ERP no dia seguinte, alguém cobra um cliente que já pagou.
Integração malfeita é pior que integração nenhuma, e é o que assusta quem já tentou: sincronizações que rodam duas vezes e duplicam pedido, ou que falham em silêncio e ninguém percebe por três semanas.
Como fazemos
Mapa de quem é dono do dado
Antes de conectar qualquer coisa, definimos qual sistema é a fonte da verdade de cada informação. Sem esse acordo, integração vira dois sistemas se sobrescrevendo, e é a causa da maioria dos casos de dado que 'volta sozinho'.
Escolha do caminho
API quando existe e é boa, webhook quando o sistema avisa sozinho, arquivo quando é o que há. Cada caminho tem um custo e um atraso diferentes; a escolha é por caso, não por preferência técnica.
Idempotência
Toda operação é construída para poder rodar duas vezes sem duplicar nada. É o detalhe que separa integração que sobrevive a uma reexecução de integração que cria pedido fantasma, e reexecução sempre acontece.
Fila e nova tentativa
Sistema de terceiro cai, e quando cai não pode derrubar o seu. A troca passa por fila com nova tentativa progressiva, então uma indisponibilidade de duas horas atrasa o dado sem perder nenhum.
Falha que grita
Toda integração tem painel de execução, alerta quando para e ponto de retomada. Integração que falha em silêncio é a pior das três, porque a operação segue confiando num dado que parou de chegar.
O que você recebe
- Integrações em produção, com fila, nova tentativa e ponto de retomada
- Documento de quem é dono de cada dado, acordado entre as áreas
- Painel de execução com alerta de falha por canal que o time já usa
- Reprocessamento seguro: rodar de novo não duplica nada
- Registro de cada troca, para auditoria e para achar o que quebrou
Com o que trabalhamos
Tudo que já publicamos sobre integração
Integração é o trabalho que parece simples de fora e consome mais tempo que qualquer outro por dentro. “O pedido entra na loja e aparece no ERP” é uma frase com uma dúzia de decisões escondidas dentro dela. Abaixo está o cluster inteiro, na ordem em que as decisões aparecem num projeto real.
Antes de escrever a primeira linha
O que é integração de ERP
Os três formatos que aparecem na prática (arquivo, API e banco direto) e por que o terceiro é o que mais dói depois.
O que a API do ERP permite
“Tem API” não diz se ela escreve, quais entidades expõe nem quanto cobra. As perguntas e o teste de três chamadas antes do contrato.
Quem é o dono do cadastro
Dois sistemas editando o mesmo cliente sem ninguém ter decidido quem ganha. A decisão é por entidade, não por sistema.
O de-para de dados
A tradução entre os dois modelos. É a fase que todo projeto subestima e a que decide se o resto funciona.
Hub de integração ou conexão direta
O que o hub resolve de verdade, o que ele cobra por isso e quando o custo por transação passa a ser o problema.
O que quebra em produção
O mesmo evento duas vezes
Idempotência: onde mora a chave e por que “verificar se já existe antes de inserir” tem corrida.
Quando a API do fornecedor cai
O que a integração faz com o pedido enquanto o outro lado está fora: é isso que decide se o cliente percebe.
A fila de erro que ninguém abre
Falha temporária e falha permanente pedem tratamento oposto, e reprocessar cegamente duplica.
Limite de requisições
O teto que só aparece quando o volume dobra, e o que se faz antes de chamar para caber nele.
A credencial que vence de madrugada
Token que expira, certificado que vence, e o erro clássico de tratar 401 como falha de negócio.
Webhook ou varredura periódica
Webhook perde evento sem avisar; varredura custa requisição. O arranjo que funciona usa os dois.
Por tipo de ponta
ERP e loja própria
O caminho do pedido entre loja e retaguarda, e os dois pontos em que ele costuma nascer duas vezes.
ERP e marketplace
Aqui a regra é do outro lado, e o estoque é disputado entre canais. Problema diferente do da loja própria.
ERP e contabilidade
Onde a integração mais falha em silêncio: competência que não bate com a data do pedido, cancelamento depois do fechamento.
Sistema e portal de classificados
Publicar é a parte fácil; o problema é o item já vendido que continua no ar recebendo contato.
CRM e ERP
Onde fica a fronteira entre proposta e pedido, e o que fazer com preço e disponibilidade que vivem do outro lado.
As pontas difíceis, e o depois
Sistema que não tem API
O caso mais comum no mercado brasileiro e o menos escrito. As saídas em ordem, e o que cada uma cobra depois.
Integração por arquivo
CSV, posicional, SFTP, EDI. Parece antiquada e sustenta metade da indústria, com o lote parcialmente inválido e o separador decimal que quebra em silêncio.
WhatsApp dentro do CRM
A conversa virando registro: quem é o dono do número, o que vira campo estruturado e a janela como estado que a tela precisa mostrar.
Testar antes de subir
O que dá para provar sem o outro lado, o que só a homologação prova, e o que só aparece em produção.
Monitorar em produção
Integração quebra em silêncio. O alarme de ausência (nada chegou, e isso é anormal) é o que quase ninguém tem.
Quanto custa manter
O custo que ninguém orça: a API que muda sem aviso, e quem responde quando quebra às 22h.
Sistemas que já mapeamos
As 14 páginas de sistema
TOTVS Protheus, Sankhya, Omie, Bling, Tiny, VTEX, Nuvemshop, Shopify, Mercado Livre, Amazon, HubSpot, RD Station, Pix e WhatsApp Business API.
Quanto tempo leva
O que determina o prazo, sem prometer prazo, e o que levantar antes de pedir orçamento para receber um número melhor.
Integrar ou trocar o ERP
A decisão anterior a tudo isto. Às vezes a integração é o remendo caro de um problema que era de sistema.
Categoria Integrações na prática
O acervo completo, em ordem, incluindo o que for publicado depois desta lista.
Dezessete entradas, e nenhuma delas é enfeite: a ordem dos grupos é a ordem em que as decisões aparecem num projeto de verdade (primeiro quem manda no dado, depois o que quebra, depois a particularidade de cada ponta). Como a do CRM, esta lista é mantida à mão: o que faz um pilar valer é o que ele deixa de fora.
Perguntas frequentes
E se o sistema não tiver API?
Ainda dá. A ordem de preferência é API, webhook, exportação de arquivo agendada e, em último caso, leitura direta do banco. Cada degrau abaixo custa mais tempo de levantamento e entrega o dado com mais atraso. O diagnóstico diz qual degrau o seu caso permite antes de você decidir.
Integração não duplica pedido?
Duplica quando é construída sem idempotência. Aqui toda operação carrega uma chave própria, então rodar a mesma troca duas vezes produz o mesmo resultado de rodar uma. É o que permite reprocessar com segurança depois de uma queda, e queda acontece.
Quem mantém isso depois de pronto?
Pode ser o seu time ou o nosso. Em qualquer um dos dois casos entregamos painel, alerta e documentação do que cada integração faz. O que não entregamos é caixa-preta: integração que só uma pessoa entende é passivo, mesmo quando funciona.
Vale mais integrar ou trocar por um sistema único?
Depende de quantos processos estão fora do sistema principal. Um ou dois: integrar sai muito mais barato e mais rápido. Metade da operação: aí o problema não é integração, é que o sistema principal deixou de servir, e a conversa passa a ser sobre ERP sob medida.