O essencial primeiro: quando a integração WMS–TMS quebra, continue embarcando primeiro e corrija os dados depois. Um fluxo de status de embarque parado não interrompe o armazém — a carga ainda precisa sair. Em novembro de 2024, na alta temporada, o fluxo de callbacks TMS de um cliente ficou fora do ar por seis horas. Mais de 400 pedidos já haviam sido embarcados, e todos estavam presos em «aguardando embarque» no WMS. Naquela noite, seguramos a operação com um registro em papel: zero pedidos perdidos, zero embarques errados.

Já vi essa falha exata três vezes. As três mortes foram diferentes. O caminho para sair foi o mesmo todas as vezes.

Quando a integração WMS–TMS quebra, proteja estas três coisas

Primeiro, a carga não pode parar. A expedição é a linha principal do armazém; a sincronização de status é a linha secundária. Quando a secundária quebra, a principal continua funcionando. Quem interrompe a expedição para esperar o fluxo voltar acabou de transformar um problema pequeno em um grande.

Segundo, os dados não podem se perder. Para cada pedido que sai, anote quatro coisas na hora: número de rastreamento, transportadora, hora do embarque e quantidade de volumes. Se faltar uma, a recomposição depois não vai fechar. Um registro manual anota exatamente essas quatro — mais é inútil, menos não basta.

Terceiro, os clientes não podem ficar sem saber. Quando o fluxo para, tudo o que o cliente vê é «aguardando embarque», e as ligações começam em meia hora. Avise primeiro e depois responda uma por uma — não espere que liguem para você. Os clientes conseguem conviver com «as atualizações de status estão algumas horas atrasadas». Não conseguem conviver com «ninguém sabe se meu pedido foi embarcado».

Por que quebra: três formas como já vi isso morrer

A morte mais comum: o token de API da transportadora expirou. Em março de 2025, o token de uma transportadora expirou numa sexta-feira à noite e ninguém percebeu até segunda-feira de manhã — mais de 900 status de embarque se acumularam, sem sincronizar. A data de expiração estava escrita no documento de integração. Ninguém configurou um lembrete. Ninguém era responsável.

A segunda morte: a transportadora atualizou sua API sem avisar ninguém. Os nomes dos campos mudaram, os códigos de resposta mudaram, e o WMS continuou interpretando o formato antigo. As interpretações com falha eram descartadas em silêncio — sem erro, sem alerta. É o pior tipo: o sistema parece perfeitamente saudável enquanto nada se move.

A terceira morte: callbacks perdidos. O TMS enviou o status, o WMS nunca o recebeu, o TMS acreditou que havia entregado, o WMS acreditou que nada havia sido enviado. Nenhum dos lados tinha um mecanismo de repetição, então o status morreu no meio do caminho. A interrupção de seis horas de 2024 foi essa — os logs mostravam «enviado» do lado do TMS e nada do lado do WMS.

Duas em cada três vezes, a culpa não era do armazém. Mas o cliente só vê o armazém: foi você quem embarcou, é você quem deve o status. De quem é a API não importa para eles.

Os primeiros 90 minutos: cinco passos para se manter de pé

Passo um, em 10 minutos: encontre a falha. Verifique três lugares — o log de integração do WMS, o log de envio do TMS e a própria página de rastreamento da transportadora. Na maioria dos casos, dez minutos bastam para identificar qual trecho está morto. Antes de localizá-la, não deixe ninguém reiniciar um serviço; um reinício apaga os logs ativos.

Passo dois, em 20 minutos: passe para o registro manual. Imprima um registro de saídas ou abra uma planilha compartilhada com quatro colunas: número de rastreamento, transportadora, hora do embarque e quantidade de volumes. Cada pedido que sai pela porta ganha uma linha, e o supervisor confere uma vez por hora. Caligrafia bagunçada não tem problema; o que conta são os números corretos.

Passo três, em 30 minutos: avise os clientes. O aviso precisa de três frases: as atualizações de status estão pausadas, a carga está sendo embarcada normalmente, tempo previsto de recuperação. Dispense a frase vazia «atualização do sistema» — o que o cliente quer saber é «onde está meu pedido».

Passo quatro, em 60 minutos: dê ao atendimento ao cliente uma lista que ele possa realmente consultar. Quando o telefone toca, o agente olha o registro manual e responde — sem precisar correr até o armazém para perguntar. Naquela noite, reduzimos o volume de ligações em mais da metade; a líder do atendimento me disse depois que foi seu turno noturno mais tranquilo da alta temporada em ligações de «meu pedido já foi embarcado?».

Passo cinco, em 90 minutos: combine o plano de recuperação. O responsável pela integração dá um prazo de correção; o armazém combina a recomposição: os status da janela da interrupção são reenviados em ordem cronológica e depois conferidos um por um. Escreva o plano e envie a todos os envolvidos — não apenas uma promessa verbal.

Escrevi esses cinco passos na lista de verificação da noite de go-live de três clientes. Todas as vezes, o cliente disse «provavelmente nunca vamos precisar disso». Todas as vezes que precisaram, ficaram felizes por estar escrito.

Depois que a integração WMS–TMS se recuperar: recompor, conciliar, prevenir

A recuperação não é o fim — é o começo da segunda metade do trabalho. Recompor: reenvie os status da janela da interrupção em ordem cronológica, marcando cada um no registro manual; um ticket só está concluído quando está marcado. Conciliar: depois da recomposição, compare os registros de saída do WMS com os registros de entrega do TMS pedido por pedido e persiga cada divergência — sem verificações por amostragem para economizar tempo. Prevenir: três coisas — um lembrete automático sete dias antes da expiração do token, repetições mais uma fila de mensagens não entregues na integração e um simulado mensal de interrupção que executa exatamente esses cinco passos.

Simulados não são teatro. Uma vez por mês, numa terça-feira à tarde, simulamos uma interrupção por uma hora: callbacks desligados, registro em papel ativado, ligações reais para o atendimento ao cliente. Depois, revisamos três números: tempo para localizar a falha, linhas perdidas no registro manual, minutos até o aviso ao cliente sair. Se os números melhoram a cada vez, o simulado está funcionando.

E aqui está a parte contraintuitiva. A maioria trata um registro em papel como um passo para trás — prova de que o sistema falhou. Eu vejo ao contrário: uma integração sem alternativa manual nunca foi concluída. Quanto mais automatizado o sistema, mais a alternativa para o dia em que ele quebra precisa estar escrita com antecedência. A automação cuida dos dias normais. O plano manual cuida do dia em que as coisas dão errado.

Na próxima noite de go-live, imprima a folha de alternativa manual e cole-a no cais de saída. Espero que você nunca a use. Mas no dia em que o fluxo morrer, essa folha é o seu sistema.

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.