Em 2021, visitei um armazém 3PL nos arredores de Chicago, e o dono estava orgulhoso exatamente da coisa errada. "Construímos todas as nossas integrações nós mesmos", ele me disse. "Economizamos uma fortuna em licenças de middleware". Dois engenheiros, um deles em meio período nas operações. Seis meses depois, ele me ligou em pânico: a plataforma de e-commerce havia mudado um campo da API, o meio período havia pedido demissão, o novo contratado não conseguia ler o código antigo, e os pedidos ficaram travados por dois dias. Eles perderam um cliente importante por causa disso. Esses dois dias custaram mais do que vários anos de assinatura de middleware teriam custado.

Todo armazém eventualmente enfrenta essa decisão. Os pedidos têm que entrar dos marketplaces, as etiquetas têm que voltar das transportadoras, os clientes 3PL querem visibilidade do estoque, e os grandes clientes do varejo exigem EDI — ordens de compra 850, avisos de embarque 856, toda a sopa de letrinhas. A pergunta nunca é se integrar. É quem faz o trabalho, e o que ele realmente custa.

O desenvolvimento é a parte mais barata de fazer você mesmo

A maioria dos armazéns calcula mal essa decisão porque só orçamenta o desenvolvimento. Dois engenheiros, dois meses, a API conecta e todos comemoram as taxas de licença que "economizaram". Essa conta é ficção.

A estrutura real de custo de uma integração caseira é de aproximadamente trinta por cento desenvolvimento e setenta por cento manutenção — e a manutenção nunca termina. As plataformas revisam suas APIs. As transportadoras renovam certificados. As especificações de EDI são ajustadas. Os alertas disparam às 3 AM sem ninguém qualificado para responder. Cada mudança externa vira um sprint de desenvolvimento não planejado. Você acha que comprou um projeto de engenharia pontual; o que você realmente comprou é um passivo de longo prazo com o seu nome.

O risco mais agudo é o pessoal. O ponto único de falha na maioria das integrações caseiras não é um servidor — é a pessoa que escreveu o código. Quando ela sai, e elas sempre acabam saindo, você herda uma caixa preta sem documentação e um negócio que para no dia em que algo muda a montante.

O que o middleware realmente vende para você

Middleware também não é caridade. Os produtos iPaaS que todo mundo conhece — MuleSoft, Boomi, Celigo, Workato — cobram de você três vezes, e você deveria ter os três números por escrito antes de assinar. Primeiro é a assinatura, em faixas por conexões ou volume de dados; os preços mudam regularmente, então verifique as tarifas publicadas atuais do fornecedor e não confie em uma cotação verbal. Segundo é a implementação — os consultores do fornecedor cobram por dia, e uma integração de complexidade média rotineiramente leva o dobro do tempo estimado. Terceiro, e o mais negligenciado, é o aprisionamento: quando sua lógica de negócio mora no construtor visual de fluxos deles, migrar custa uma fortuna.

Então tenha clareza sobre o que você está comprando. Middleware não é mais barato — é risco terceirizado. Quando uma plataforma muda sua API, o fornecedor adapta o conector. Quando algo quebra às 2 AM, há uma equipe de suporte para escalar. Você paga para que a ligação das 3 AM não seja a sua.

Mais uma armadilha para sinalizar antes de assinar: não terceirize seu mapeamento de processos para os consultores do fornecedor. Seus próprios fluxos de trabalho — de onde vêm os pedidos, quem trata as exceções, qual sistema é a fonte da verdade do estoque — têm que ser resolvidos internamente antes de qualquer configuração começar. Já vi armazéns entregarem todo o desenho de processos para consultores, entrar no ar com uma configuração que não combinava com como o chão de fábrica realmente funcionava, e pagar o retrabalho duas vezes. Consultores conhecem a ferramenta. Só você conhece o negócio.

Fluxo de dados de integração de sistemas de armazém

Minhas três linhas na areia

Aqui estão as três regras práticas que adotei ao longo dos anos. Se você atingir qualquer uma delas, não deveria desenvolver suas próprias integrações.

Linha um: mais de cinco pontos de integração. Marketplace, ERP, transportadoras, EDI, portais de clientes — cada ponto adicional aumenta a complexidade de manutenção exponencialmente, não linearmente. Cinco é mais ou menos o máximo que uma equipe humana consegue manter na cabeça. Além disso, você precisa de ferramental de plataforma.

Linha dois: você não tem dois engenheiros de integração em tempo integral. Note a palavra tempo integral, e as palavras engenheiros de integração — não "um desenvolvedor que pode ajudar". Uma integração caseira mantida em meio período vai falhar eventualmente; a única variável é quando.

Linha três: o negócio ainda está mudando rápido. Shopify este ano, TikTok Shop ano que vem, EDI de um cliente corporativo no ano seguinte. Quando a própria superfície de integração é instável, os custos de retrabalho em código customizado vão te afogar. Uma biblioteca de conectores de middleware existe precisamente para isso — habilitar um conector pronto é uma ordem de grandeza mais barato do que escrever um do zero.

O inverso também vale. Desenvolva você mesmo somente quando as três forem verdadeiras: a contagem de pontos fica em dois ou três indefinidamente, a lógica de negócio é genuinamente customizada de formas que o middleware não consegue expressar — regras de faturamento incomuns são o caso clássico — e você tem engenheiros de integração estáveis que não vão a lugar nenhum.

Se você insistir em desenvolver, dois inegociáveis

Alguns armazéns têm razões legítimas para desenvolver. Tudo bem. Mas eu tenho dois requisitos, e não começaria sem ambos.

Primeiro, documentação e um manual de transferência acompanham o código. Antes de o autor sair, outra pessoa precisa ser capaz de ler, modificar e implantar a integração de forma independente. Um sistema que só uma pessoa entende não é um ativo — é uma bomba-relógio.

Segundo, cada chamada externa ganha disjuntores e tentativas de novo, e cada payload de pedido precisa ser reproduzível. As APIs das plataformas falham constantemente; sem tentativas de novo, um timeout é um pedido perdido, e pedidos perdidos na alta temporada podem escalar para penalidades dos marketplaces e clientes finais furiosos. Sem reprodutibilidade, você não tem caminho de recuperação quando — não se — algo falhar. Isso é o piso, não o teto.

A única coisa que você pode fazer amanhã: liste cada ponto de integração de sistemas que você tem em uma única folha de papel e conte-os. Mais de cinco? Agende demos com três fornecedores de middleware esta semana. Menos de cinco, mas mantidos por um único meio período? Agende as demos mesmo assim. Não espere o dia em que os pedidos pararem de se mover para descobrir que você nunca fez essa conta.

Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.