slug: wcs-wms-count-discrepancy-troubleshooting-guide lang: pt title: Quando as contagens do WCS não batem com o WMS: guia de solução de discrepâncias excerpt: Quando as contagens do WCS não batem com o WMS, 90% dos casos se resumem a cinco causas raiz. O checklist de solução de problemas em 10 etapas de Lin Xiao encontra a maioria das lacunas antes da etapa 4. section: software subcategory: wcs region: common tags: ['wcs','wms','conciliação','discrepância','contagem-em-transportador'] author: 林晓

Quando as contagens do WCS não batem com o WMS: guia de solução de discrepâncias

Aqui está o veredito logo de cara: quando as contagens do WCS e o estoque do WMS não batem, nove vezes em dez a causa se encaixa em exatamente cinco categorias — leituras erradas de sensores fotoelétricos e scanners, perda de pacotes na rede e desvio de relógio, fluxos reversos que nunca fecham o ciclo, intervenções manuais que nunca são escaneadas e definições de contagem que nunca foram alinhadas. Eu vi essa falha exata três vezes, e todas as vezes o primeiro instinto do cliente foi "recontar o prédio inteiro hoje à noite". Todas as vezes, isso estava errado. Aqui está o porquê, seguido de um checklist de solução de problemas em 10 etapas. Execute as etapas em ordem, e noventa por cento das discrepâncias se revelam até a etapa quatro.

Um desastre real: 3,000 unidades de diferença na véspera do go-live

Em outubro de 2024, um armazém de e-commerce de 50,000 pés quadrados processando 20,000 unidades por dia em uma nova linha de separação controlada por WCS estava há três semanas em operação quando o estoque do WMS e as contagens de máquina do WCS começaram a divergir — em mais de 3,000 unidades acumuladas. O diretor de operações exigiu uma contagem física completa naquela noite. Eu o impedi: uma contagem diz o quanto você está fora, não de onde veio a lacuna. Três horas de investigação encontraram duas causas raiz. Primeiro, um sensor fotoelétrico de feixe direto no separador havia sido cegado pela poeira de papelão, subcontando cerca de 1,200 unidades. Segundo, o processo de devoluções rodava offline — mais de 1,800 unidades devolvidas nunca passaram por um ponto de escaneamento. Somando: cerca de 3,000 unidades. A lição cabe em uma frase: descubra de onde vem a lacuna antes de tentar fechar os números.

As cinco causas verdadeiras das discrepâncias de contagem WCS–WMS

Causa 1: Leituras erradas de sensores fotoelétricos e scanners. A mais comum. Sensores sujos, feixes desalinhados, pacotes muito próximos causando disparos duplos. Scanners fixos têm uma taxa de não leitura — isso é uma probabilidade, não um defeito. Faça as contas: com 20,000 unidades por dia e uma taxa de não leitura de 0.5%, você fica fora em 100 unidades por dia, 3,000 por mês. Foi exatamente assim que o armazém acima construiu sua lacuna de 3,000 unidades.

Causa 2: Perda de rede e desvio de relógio. Quando o controlador do WCS e o servidor do WMS não compartilham o mesmo relógio, a ordem dos eventos quebra. O WCS informa "separado", o WMS deduplica por carimbo de data e hora, decide que já viu aquele evento e o descarta. Eu vi isso três vezes, e nas três vezes a TI jurou que "a rede está boa" — até encontrarmos o relógio do controlador rodando 40 segundos ou mais atrasado.

Causa 3: Fluxos reversos sem ciclo fechado. Devoluções, desvios de exceção, reembalagem — tudo fora do caminho principal. O WCS nunca conta essas unidades, mas o estoque do WMS se move. Nove em cada dez armazéns tratam fluxos reversos manualmente, offline. É aqui que as discrepâncias se criam.

Causa 4: Intervenções manuais sem reescaneamento. Um engarrafamento, um operador carrega caixas à mão até a calha de exceção, sem escanear. Uma retirada de QA de algumas unidades, esquecida. Uma ou duas vezes não é nada; dezenas de vezes por dia na alta temporada, e os números nunca batem.

Causa 5: Definições de contagem que nunca foram alinhadas. A mais injusta: os dois lados estão certos, mas não estão contando a mesma coisa. O WCS conta "unidades que passaram pela máquina", o WMS conta "unidades em estoque" — em trânsito, calhas de exceção, áreas de retenção de QA: quem é o dono? Com definições desalinhadas, as contagens nunca podem bater.

Um julgamento contraintuitivo: nunca confie na contagem acumulada do próprio WCS; confie no fluxo de eventos com carimbo de data e hora. Um contador acumulado que perde um evento fica errado para sempre. Um fluxo de eventos com uma lacuna pode ser reconstruído a partir dos logs. Sempre solucione a partir dos eventos, nunca olhando para o total.

O checklist de 10 etapas: solucione nesta ordem

1. Puxe o relatório de variação e fatie-o. Fatie por SKU, por calha/destino e por janela de tempo. Variação concentrada em poucas calhas aponta para o equipamento; variação uniformemente distribuída aponta para interfaces e definições.
2. Leia o log de eventos do WCS. Concentre-se nos registros de não leitura e anomalias fotoelétricas, e alinhe-os com o momento em que a variação começou.
3. Teste os sensores fotoelétricos. Teste de bloqueio em cada um: limpe os sujos, realinhe os desviados. Se o espaçamento mínimo dos pacotes cair abaixo de 300 milímetros, disparos duplos são quase certos — corrija o espaçamento ou aceite o erro e construa uma lógica de compensação.
4. Verifique rede e relógios. Verifique a sincronização do controlador com o servidor do WMS; qualquer desvio além de 5 segundos é corrigido antes de tudo. Verifique a fila de interface por acúmulos, novas tentativas e perdas.
5. Audite os fluxos reversos. Percorra a última semana de devoluções, desvios de exceção e tickets de reembalagem, e verifique se cada um chegou ao WMS.
6. Revise os registros de intervenções manuais. Logs manuais da calha de exceção, registros de desengatamento, retiradas de QA — concilie um por um.
7. Alinhe as definições de contagem. Escreva as definições dos dois lados e compare linha por linha: em trânsito, calhas de exceção, retenção de QA, staging — quem é dono do quê. Metade de todas as "discrepâncias" evapora nesta etapa.
8. Verifique os dados mestres. Códigos de barras SKU duplicados, um produto com vários códigos — o scanner leu o código de barras corretamente, mas o código estava vinculado ao SKU errado.
9. Reconstrua uma hora de ponta a ponta. Pegue a pior hora, puxe as imagens de câmera mais os logs, e concilie unidade por unidade. É trabalho pesado, mas é a única coisa que encerra o caso.
10. Corrija, reteste e depois conte. Depois de corrigir a causa raiz, rode 4 horas e observe a variação convergir. Se convergir, faça uma contagem física para alinhar a linha de base; se não, a causa raiz estava errada — volte e verifique de novo.

Quatro erros clássicos

• Começar com uma recontagem. Uma recontagem converte uma "lacuna de eventos" em uma "lacuna de estoque" enquanto a causa raiz continua vazando. No dia seguinte, a lacuna volta.
• Verificar o equipamento, mas não as interfaces. Pela minha experiência, mais da metade das divergências são problemas de software e interface, não de sensores.
• Reunir antes de alinhar as definições. Os dois lados falam sem se entender por uma tarde inteira. Escreva primeiro as definições, discuta depois.
• Declarar vitória sem retestar. Sensores limpos, problema "resolvido", a lacuna volta em três dias. Rode 4 horas, prove a convergência com dados.

O checklist da noite do go-live: impeça o retorno das discrepâncias

Esta é a lista que eu passo na noite anterior a cada go-live. Publicando aqui:

1. Teste de bloqueio em cada sensor fotoelétrico, com registros
2. Taxa de não leitura do scanner abaixo da linha de aceitação do projeto por 2 horas consecutivas
3. Relógios do controlador e do servidor do WMS sincronizados, desvio abaixo de 5 segundos
4. Fila de eventos WCS→WMS drenada, zero acúmulo
5. Fluxos reversos (devoluções/desvios de exceção) percorridos de ponta a ponta, eventos chegando ao WMS
6. Procedimento de reescaneamento manual impresso e afixado na estação de exceção
7. Ensaio do relatório de variação: as três dimensões de fatiamento retornando dados
8. Snapshot do estoque completo — seu último ponto de reversão

Um último conselho: quando o WCS e o WMS discordam, sempre pergunte "de onde vem a lacuna" antes de "qual é o tamanho da lacuna". Inverta a ordem e ninguém pode salvá-lo.

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.