Em novembro do ano passado, uma marca de smart home de Shenzhen me ligou em pânico. A mercadoria estava parada há três semanas em um armazém 3PL em Ontario, Califórnia, o tráfego da Black Friday estava chegando e os números de estoque não batiam: o próprio sistema deles mostrava 80,000 unidades disponíveis, o sistema do armazém mostrava 65,000. Quinze mil unidades, sumidas — pelo menos no papel. Puxamos o relatório de conciliação e descobrimos a história real: códigos SKU, unidades de medida e especificações de caixa estavam todos inconsistentes.

Isso não é um caso isolado. Ao longo dos anos, ajudei vendedores transfronteiriços a se integrar com armazéns de fulfillment nos EUA, e o padrão se repete o tempo todo. Construir a API costuma representar cerca de vinte por cento do esforço. Os outros oitenta por cento vão para os dados mestres: como os SKUs são codificados, quantas unidades cabem em uma caixa, se a unidade base é uma peça ou um conjunto, se o código de barras na caixa é o da caixa interna ou o da caixa externa. Quando uma API quebra, você recebe uma mensagem de erro. Quando os dados mestres estão errados, o sistema não reclama. Ele simplesmente envia os itens errados, recebe as quantidades erradas e nunca concilia.

A API leva duas semanas. Os dados mestres levam dois meses.

Muitos fundadores assumem que, uma vez que encontram um armazém com uma API aberta, ou que o time de TI passa duas semanas escrevendo uma integração, os sistemas estão "conectados". Vou dizer sem rodeios: esse é o maior mal-entendido deste negócio.

Uma API é só um cano. Ela não se importa se o que passa por ela está correto. Seu ERP envia um SKU chamado "US-PLUG-BLK-01", o sistema do armazém tem ele registrado como "PLUG-BLK-US-01". Os dados passam, o sistema do armazém não reconhece, e a ordem de recebimento fica travada. Pior, ele combina automaticamente com um SKU antigo parecido e a mercadoria vai para o slot errado. Quando você percebe, milhares de caixas já foram despachadas com o SKU errado, e não há como trazê-las de volta.

O verdadeiro sumidouro de tempo é sentar os dois lados e alinhar os dados mestres linha por linha: regras de codificação de SKU, unidades de medida (peça, conjunto, caixa — os três níveis), especificações de caixa (unidades por caixa externa, peso bruto e líquido) e regras de código de barras (códigos internos versus externos, se etiquetas SSCC são usadas, quem as imprime). Nos projetos em que trabalhei, essa etapa leva de três semanas no melhor caso a dois meses no pior, dependendo inteiramente de quão bagunçados estão os dados do vendedor. Quando os dados são ruins, só organizar a lista de SKUs provoca três rodadas de discussão interna, seguidas de outra rodada com o armazém.

Os códigos de barras são o outro campo minado. As fábricas na China tendem a imprimir códigos de barras de caixa interna, enquanto os armazéns americanos querem códigos de caixa externa mais etiquetas SSCC para gestão em nível de pallet. Quando os códigos não batem, o recebimento vira reetiquetagem manual, caixa por caixa. Trabalhei com um vendedor de móveis de Dongguan cujo primeiro embarque — 40 contêineres, novembro de 2023 — chegou com códigos de barras que ninguém havia confirmado antecipadamente. O armazém cobrou uma taxa de reetiquetagem por caixa. Alguns centavos por caixa vezes 40 contêineres somaram dezenas de milhares de dólares. O dinheiro doeu, mas as duas semanas perdidas de processamento de entrada doeram mais.

Meu veredito é direto: ao escolher um 3PL, primeiro verifique se ele tem um modelo de dados mestres pronto e uma planilha de mapeamento de SKU. Se não tiver, reserve um mês extra de prazo de go-live, não importa quão atraente seja o preço. Você não pode pular essa etapa. Todo o tempo que você economizar aqui vai voltar como despachos errados e divergências de estoque.

Uma API funcionando é a linha de partida, não a linha de chegada

A API está pronta, os avisos de remessa antecipada (ASNs) fluem, o estoque sincroniza diariamente. Terminamos? Nem de longe.

O modo de falha mais cruel que já vi: a integração é em tempo real, mas a confirmação de recebimento do armazém e o recebimento de mercadoria do seu ERP são duas ações separadas. A mercadoria chega, o armazém escaneia, o estoque sobe um. Seu ERP, no entanto, só registra o recebimento depois que o financeiro aprova o documento de recebimento — um intervalo de dois dias. Durante esses dois dias, os pedidos continuam chegando contra estoque "disponível" que o armazém ainda não tem de fato. Overselling, cancelamentos, avaliações ruins — toda a reação em cadeia. O problema não é a interface. É que os dois lados definem "estoque" de forma diferente.

Então, em qualquer plano de integração, o mecanismo de conciliação importa mais do que a própria interface. Insisto em três pontos inegociáveis. Primeiro, um relatório automatizado diário de conciliação, linha por linha em nível de SKU, com divergências acima de um limite acordado marcadas em vermelho — e alguém precisa assumir cada linha marcada no mesmo dia. Segundo, uma "data de congelamento de estoque" mensal: os dois lados fecham com a contagem física do armazém, e quem contestar uma divergência precisa apresentar evidências. Sem apontar dedos. Terceiro, os ASNs devem carregar especificações de caixa e números de lote, e o armazém recebe por caixa sem abrir para contagens por peça — a responsabilidade por divergências de caixas abertas vai para o contrato. Parece burocrático. Na alta temporada, você vai agradecer pelos três.

Integração de sistemas 3PL

O checklist pré-lançamento: não entre no ar até que tudo esteja alinhado

Uma semana antes do go-live, reúno os dois lados em uma reunião de alinhamento e percorro este checklist item por item. Se algum item falhar, não aumentamos o volume de pedidos. Entrar no ar uma semana atrasado custa alguns dias de vendas. Entrar no ar com lacunas não resolvidas custa a reputação de toda a alta temporada e as contas de frete de devolução.

Aqui está a lista:

  1. A planilha de dados mestres de SKU está aprovada pelos dois lados: regras de codificação, nomes de produtos, três níveis de unidade de medida (peça, conjunto, caixa), especificações de caixa, peso bruto e líquido. Mapeamento um para um, sem um para muitos.
  2. As regras de código de barras estão confirmadas por escrito: formatos de código de caixa interna e externa, quem gera e imprime as etiquetas SSCC, e o diagrama de posicionamento de etiquetas foi enviado ao armazém com confirmação.
  3. O mapeamento de campos do ASN foi testado com um ASN real: o sistema do armazém interpreta cada campo, quantidades de caixas, lotes e datas de validade (quando aplicável) chegam intactos.
  4. As definições de estoque batem: os dois lados concordam sobre o que significa "estoque disponível" (o que está em trânsito conta? o retido por qualidade? os pedidos reservados?), e a frequência de sincronização mais o atraso máximo estão escritos no SLA.
  5. O processo de conciliação rodou de ponta a ponta: o primeiro relatório diário de conciliação foi gerado, e o responsável e o tempo de resposta de cada divergência foram atribuídos.
  6. Os fluxos de exceção foram ensaiados: notas de divergência de recebimento, compensação por despachos errados e recebimento de devoluções — cada um foi percorrido uma vez, e tanto a equipe do armazém quanto o seu atendimento ao cliente sabem exatamente quem chamar.
  7. Um plano de ramp-up está em vigor: roteie apenas 10 a 20 por cento do volume de pedidos na primeira semana, e vá para volume total quando estiver rodando limpo. Nunca ligue tudo de uma vez — se algo estiver errado, tudo está errado.

Imprima esses sete itens e fixe-os na parede. A integração de sistemas, no fim das contas, nunca é realmente sobre tecnologia. É sobre paciência. Faça o trabalho ingrato dos dados mestres e você vai dormir tranquilo durante a alta temporada.

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