O veredito logo de início: no cronograma de integração edi de um varejista, o lado do armazém raramente perde tempo escrevendo código. Perde tempo esperando: esperando janelas de teste, refazendo etiquetas e executando pedidos-piloto. Nas mais de 30 implantações que conduzi, um cronograma de integração edi limpo leva de 8 a 10 semanas, do início à virada. Um travado leva 16 semanas ou mais. Nenhum travou porque um desenvolvedor digitava devagar. Todos travaram por causa de filas e retrabalho. Já vi esse fracasso exato três vezes, e o roteiro nunca muda: tudo verde até o fim, e na semana anterior à virada alguém descobre que as etiquetas estão erradas, o pedido-piloto nunca foi agendado e ninguém é responsável pela reversão.

Onde o cronograma de integração edi realmente atrasa

O primeiro atraso é a fila de janelas de teste. O ambiente de testes EDI de um varejista não está disponível sob demanda, e fica apertado antes da alta temporada. Reserva-se uma janela de testes com antecedência, e se perder o horário, espera-se. O código pode estar pronto e parado enquanto o calendário não faz nada por você. Esse tempo de espera pertence ao plano, porque nenhum dos dois lados o controla.

O segundo atraso é o retrabalho de mapeamento de mensagens. O pedido de compra 850, o ASN 856 e a fatura 810 têm, cada um, suas próprias convenções de campo. Um WMS de armazém quase nunca corresponde às expectativas de campo do varejista na primeira tentativa: unidades de medida, formatos de data, dimensões de caixas — qualquer um pode estar errado. Um único erro de mapeamento devolve todo o ciclo de testes ao início.

O terceiro atraso é a conformidade das etiquetas. Uma etiqueta GS1-128 parece simples até ser verificada: conteúdo do código de barras, posicionamento da impressão, marcações da caixa. Um item fora do lugar e a etiqueta falha na validação. Quanto mais tarde se detecta um problema de etiqueta, mais ele custa: as etiquetas impressas e as caixas já embaladas voltam todas para retrabalho.

O quarto atraso é a fila de pedidos-piloto. Um pedido-piloto não é enviado quando dá vontade. É enviado quando o varejista o agenda e quando o dock de recebimento tem espaço. Envia-se, espera-se o recebimento, a inspeção e o retorno, e mais uma ou duas semanas se vão.

Desses quatro, os dois primeiros podem ser empurrados com mais gente. Os dois últimos só podem ser esperados. Por mais apertado que se desenhe o cronograma, a parte de espera não se comprime nem um minuto. Para a visão do lado do fornecedor de toda a sequência, veja a visão do lado do fornecedor do cronograma completo de integração de varejistas: as contas do lado do armazém ainda precisam ser feitas separadamente.

Testes e certificação: o cronograma de integração edi, passo a passo

Eu construo um cronograma de uma única maneira: por entregáveis, não por pessoal. Cada etapa termina com algo que se pode mostrar e verificar. Um marco sem entregável não conta.

Passo um, conectividade e mapeamento de mensagens. O lado do armazém prepara uma lista de campos do WMS, dados mestres de caixas e credenciais de teste. O entregável é uma tabela de mapeamento assinada. A duração típica é de duas a três semanas, e o obstáculo típico são os dados mestres que não batem.

Passo dois, testes unitários. No ambiente de testes, o armazém envia um 850, recebe um 856 e devolve um 810, passando cada tipo de mensagem uma vez. O entregável é um registro de testes cobrindo cada mensagem nos dois sentidos. A duração típica é de uma a duas semanas.

Passo três, testes de certificação. O varejista percorre seu próprio roteiro item por item: formato de mensagem, campos obrigatórios, tratamento de exceções. A certificação verifica se o formato está correto. Não verifica se a operação aguenta o volume real — guarde essa frase, ela volta mais adiante. A duração típica é de uma a duas semanas.

Passo quatro, o pedido-piloto. Carga real, etiquetas reais, um dock de recebimento real, primeiro um lote pequeno. O entregável é a confirmação de recebimento do varejista. A duração típica é de uma a duas semanas.

Passo cinco, a janela de virada. Escolhe-se a data, define-se o interruptor de reversão e escala-se a lista de plantão. O entregável é um plano de virada assinado. A duração típica é de uma semana.

Essas contagens de semanas são as faixas comuns dos meus mais de 30 projetos, não um compromisso do varejista. O agendamento real segue os requisitos mais recentes do varejista.

Outono de 2023, um armazém 3PL em Ontario, Califórnia: os testes do ASN 856 ficaram travados por três semanas inteiras. A causa era pequena: o cálculo do dígito verificador SSCC-18 estava errado, e o sistema do varejista rejeitou os ASNs de todas as 2,000 caixas do piloto. Corrigir o código levou meio dia. Conseguir uma nova janela de testes levou duas semanas e meia. Já vi essa armadilha três vezes: problemas de mensagem nunca são lentos de corrigir, são lentos de voltar à fila.

Pedidos-piloto e etiquetas: a briga do armazém

Os pedidos-piloto são subestimados mais do que qualquer outra coisa na integração. As pessoas acham que um pedido-piloto é só enviar algumas caixas para testar. Não é. Um pedido-piloto é o único ensaio de todo o programa em que dinheiro de verdade circula: etiquetas, ASNs, recebimento, armazenagem — quatro coisas verificadas numa única passagem.

Início de 2024, um armazém em Dallas, Texas: um piloto de 500 caixas, enviado ao longo de três dias. O primeiro dia deu errado imediatamente. As marcações das caixas nas etiquetas não correspondiam aos números das caixas no ASN, e o dock de recebimento do varejista recusou 180 caixas. A causa era trivial: o WMS numerava as caixas na sequência de picking enquanto o ASN as listava na sequência de embalagem, de modo que as duas listas divergiam. Corrigir a lógica de mapeamento levou dois dias; reagendar uma janela de piloto levou uma semana. O piloto de 500 caixas levou 12 dias para ser concluído.

Minha rotina de etiquetas nunca muda: primeiro imprimo 10 etiquetas de amostra e escaneio cada uma à mão, depois confiro cada item com a especificação de etiquetas do varejista; quando as amostras passam, colo etiquetas em 50 caixas e faço um teste ao vivo; só depois disso aprovo uma tiragem completa. Todo projeto que pulou a etapa da amostra falhou nas etiquetas. Todos.

Então, quanto custa de fato um atraso? Um exemplo calculado, rotulado como suposição apenas para dar escala:

Item de custo Atraso de 1 semana Atraso de 4 semanas
Horas extras da equipe do projeto e cobertura no local Cerca de $10,000–20,000 Cerca de $50,000–80,000
Mão de obra temporária e retrabalho Cerca de $10,000 Cerca de $40,000–60,000
Frete urgente e alterações de pedido Cerca de $5,000–10,000 Cerca de $20,000–40,000
Janela de vendas perdida Difícil de quantificar Difícil de quantificar

Os valores são um exemplo ilustrativo, estimado para um armazém de médio porte que envia cerca de 3,000 pedidos por dia; os valores reais dependem do contrato. Deixei a linha de penalidades de fora de propósito: as penalidades do varejista seguem o contrato e os requisitos mais recentes do varejista, e não vou colocar em letra impressa um número que não posso defender.

Dia da virada: encerrando o cronograma

O dia da virada tem duas jogadas: rodar em paralelo ou virar a frio. Rodar em paralelo significa que os processos antigo e novo rodam lado a lado por 3 a 7 dias, o antigo cobrindo enquanto o novo é exercitado. Uma virada a frio significa escolher um momento, parar o processo antigo e ligar o novo. Minha decisão: para uma primeira conexão com um varejista novo, rodar sempre em paralelo. O custo extra de rodar em paralelo aparece na fatura. O custo de uma virada a frio dar errado é invisível até acontecer: pedidos que não podem ser enviados, ASNs que não batem, um dock de recebimento parado. Qualquer um deles custa mais do que a operação em paralelo.

A parte contraintuitiva, dita sem rodeios: passar na certificação não significa estar pronto para entrar em produção. A certificação verifica o formato das mensagens. Um pedido-piloto verifica um lote pequeno. No dia real da virada, o armazém envia 5,000 pedidos, os ASNs voltam um a um em tempo real, e todos os problemas de desempenho que estavam escondidos aparecem de uma vez. Já vi projetos com 100% de aprovação nos testes falharem no dia da virada. Duas vezes.

Minha lista de verificação da noite anterior à virada é a mesma folha de sempre: o instantâneo de inventário está congelado no momento imediatamente anterior à virada; a fila de ASNs de saída está vazia; uma pessoa nomeada é responsável pelo interruptor de reversão; a escala de plantão lista um contato direto no varejista; há uma impressora de etiquetas reserva. Cinco verificações, todas marcadas, antes de alguém dormir. Se faltar uma, não viramos.

Um cronograma é, no fim, um problema de filas. Código pode ser apressado. Filas, não. Etiquetas podem ser corrigidas. Janelas, não. Coloque o tempo de espera honestamente no plano, e o cronograma de integração edi ainda estará de pé na manhã após a virada.

Por Lin Xiao, Consultor de Implementação de WMS Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.