Integração é o trabalho que parece simples de fora e consome mais tempo que qualquer outro por dentro. O pedido entra na loja e precisa aparecer no ERP: uma frase, e uma dúzia de decisões escondidas nela. Qual identificador manda, o que acontece quando o mesmo evento chega duas vezes, quem ganha quando os dois lados discordam do estoque.
Os textos desta categoria tratam do que a documentação da API não cobre. A documentação descreve o caminho feliz: o endpoint, o formato, o campo obrigatório. O que quebra em produção fica de fora dela: o webhook reenviado, o fornecedor fora do ar por vinte minutos, o limite de requisições que só aparece quando o volume dobra, o cadastro que vira dois clientes porque ninguém decidiu qual campo é a chave.
O critério de escrita aqui é ser específico o bastante para ser útil e genérico o bastante para valer além de um fornecedor. Cada texto termina com um teste concreto (uma coisa para fazer e observar), porque desenho de integração que nunca foi exercitado não está pronto: está apenas ainda não tendo dado errado.
Textos de integrações na prática
A API do ERP: o que ela expõe, o que ela esconde e o que perguntar antes de assinar
Ter API não é ter integração. As perguntas que separam a API que serve da que só consta no folheto, e um teste de três chamadas para fazer antes do contrato.
O mesmo evento duas vezes: a chave que impede o pedido gêmeo
Webhook reenviado, retentativa depois do tempo esgotado, lote liberado à mão. Onde mora a chave de idempotência e por que verificar antes de inserir tem corrida.
Quem é o dono do cadastro: escolhendo o sistema de registro
Dois sistemas editando o mesmo cliente e ninguém decidiu quem ganha. Como escolher o dono por entidade, campo a campo, e o que fazer com o que os dois editam.
Webhook ou consulta periódica: a resposta prática é as duas
Webhook perde evento e não avisa; a varredura custa requisição e atrasa. O arranjo que usa os dois e como dimensionar a janela de sobreposição.
A fila que ninguém olha: o que acontece com o que falhou
Falha temporária ou permanente, quantas tentativas e com que espaçamento, por que reprocessar às cegas é perigoso e o que precisa estar visível na fila.
A credencial que vence de madrugada
Token que expira, certificado que vence, senha rotacionada sem aviso. Por que a renovação preguiçosa ganha da agendada e por que 401 não é falha de negócio.
O que é integração de ERP: a definição, o que não é e os três formatos
Integração de ERP não é relatório nem exportar planilha. A definição, os três formatos (arquivo, API e banco direto) e as perguntas que fecham o escopo.
Hub de integração ou conexão direta: o que o hub resolve e o que ele cobra
O que uma plataforma de integração resolve de verdade, o que ela cobra por isso, quando o custo por transação vira problema e quando ela é a escolha certa.
Integrar ERP com marketplace: quem dita o ritmo é o canal
Marketplace não é loja própria: o cadastro segue a regra do canal, o saldo é disputado entre canais e o pedido chega com frete e prazo que não são seus.
Integrar ERP com sistema contábil: a integração que falha em silêncio
Lançamento, documento fiscal e movimento não são a mesma coisa. Por que a competência não bate com a data do pedido e por que correção é contra-lançamento.
Quanto tempo leva uma integração: o que determina o prazo
Entidades, qualidade da API, ambiente de teste e quem decide as regras. As variáveis que fixam o prazo e o que levantar antes de pedir orçamento.
Integrar o WhatsApp com o CRM: o que muda quando a conversa vira registro
Quem é o dono do número, o que da conversa vira registro, a janela imposta pela plataforma e o transbordo entre atendentes. O desenho antes do botão.
Integrar um sistema que não tem API: as três saídas e o que cada uma cobra depois
Exportação agendada, leitura direta do banco e automação de tela, em ordem de preferência, e o que exigir por contrato antes de aceitar a segunda.
Integração por arquivo: o formato antigo que sustenta metade da indústria
Nomeação e sequencial, o arquivo ainda sendo escrito, o lote parcialmente inválido e os erros de codificação e separador que quebram em silêncio.
Testar a integração antes de subir: o que dá para provar sem o outro lado
As três camadas de prova: o que o duplo cobre, o que só a homologação do outro lado revela e o que só aparece em produção. E a massa que não é o caso feliz.
Monitorar integração em produção: o alarme de ausência que quase ninguém tem
Integração não cai, emudece. Volume por janela, idade do item mais velho e taxa de erro por tipo, e o alarme que dispara quando nada chegou.
Quanto custa manter uma integração: o orçamento que termina no dia da entrega
O que muda do outro lado sem aviso, os sete itens de custo depois do projeto e por que integração sem dono nomeado quebra sem ninguém saber.
O estoque que não bate com o portal: publicar é fácil, despublicar é o problema
Anúncio fantasma não gera reclamação imediata, gera atendimento inútil dias depois. Por que a retirada quebra e o que resolve.
Quando a API do fornecedor cai: o que a sua integração faz com o pedido
Indisponibilidade do outro lado é condição normal de operação, não exceção. Fila, retentativa com recuo e o teste que confirma que nada se perde.
Limite de requisições: integrar com uma API que trava no volume
O erro 429 aparece quando o volume dobra, não no teste. Como descobrir o limite real, caber nele e decidir o que espera quando a cota aperta.
Como integrar ERP e e-commerce sem duplicar pedido
Os quatro pontos onde a integração entre loja e ERP costuma quebrar, e o desenho que impede o mesmo pedido de entrar duas vezes.