A loja aceita uma compra que o armazém não consegue preparar. Ou o painel mostra unidades, mas o cliente vê «esgotado». Estes sintomas não provam a mesma falha: podem nascer da contagem, da variante escolhida, de uma reserva ou apenas da apresentação. Antes de corrigir o stock WooCommerce, identifique qual dos valores diverge e em que momento.
Neste artigo
Que sintoma está a observar?
Comece por um produto concreto, não por uma alteração em massa. Registe o SKU, o ID do produto e, quando exista, o ID da variante. Uma variante sem SKU próprio pode herdar o do produto principal: confirme o ID, não use só o SKU para distinguir opções. Compare a contagem física, o valor guardado no painel e a disponibilidade mostrada ao comprador. Se um sistema externo fornecer as quantidades, identifique quem pode autorizar um acerto nessa origem.
Use este mapa para escolher a investigação: quantidade que não desce aponta primeiro para gestão de inventário e encomenda; variante errada exige conferir a correspondência dos atributos; zero com compra permitida pede revisão das encomendas em atraso; indisponibilidade temporária exige distinguir reservas de esgotamento; diferença só na montra pede verificar apresentação; valor que regressa após um ajuste exige investigar sincronizações.

Abra uma ficha para a divergência e guarde a evidência antes de editar. O exemplo abaixo é hipotético: os valores não representam uma loja real e a diferença entre a prateleira e o painel ainda não é uma autorização para subtrair unidades.
| Campo | Registo de exemplo |
|---|---|
| Produto e identificação | T-shirt azul M; SKU fictício CAM-AZ-M; anotar também o ID da variante |
| Nível e origem | Quantidade própria da variante; introdução manual pela equipa da loja |
| Momento da conferência | Registar data, hora e movimentos ocorridos durante a contagem |
| Valores observados | Contagem física: 8; campo da variante: 10; reservas e saídas ainda por conferir |
| Investigação e responsável | Conferir encomendas, reservas e devoluções; responsável a designar |
| Decisão e evidência | Ajuste pendente; guardar motivo e valores antes/depois quando autorizado |
A quantidade não desce depois da compra
Causa a verificar: o estado «em stock» pode estar definido sem controlo numérico. Outra hipótese é estar a observar uma contagem diferente da usada pela variante. Não conclua que o pagamento falhou apenas porque o número não mudou.

Evidência: em WooCommerce > Definições > Produtos > Inventário, confirme a gestão de inventário global. Depois abra Produtos > Dados do produto > Inventário e verifique se o produto acompanha quantidades. Num produto variável, abra Variações e confira o nível que controla a opção comprada. Os nomes podem variar com a tradução e o editor.
Confronte o ID comprado com o ID cuja quantidade está a ler. Registe ainda o estado, o meio de pagamento e as notas da encomenda: uma encomenda criada não é, por si só, prova de pagamento confirmado. A documentação de diagnóstico de encomendas recomenda consultar estas notas e os registos do meio de pagamento antes de atribuir a falha ao inventário.
Decisão: se o controlo numérico estiver desligado e a operação exigir contagens, configure-o no nível correto com uma quantidade conferida. Se já estiver ativo, não volte a introduzir o mesmo valor para disfarçar o problema: reproduza o movimento numa cópia isolada e compare as notas com a contagem efetivamente alterada.
A opção Vendido individualmente limita a compra por encomenda. Não significa que só exista uma unidade em armazém nem impede compras noutras encomendas; não substitui a gestão de quantidade.
A compra altera a variante errada
Causas possíveis: contagem partilhada interpretada como individual, configuração mista mal compreendida ou variantes com atributos sobrepostos. A documentação de produtos variáveis distingue os níveis de inventário e explica a correspondência quando se usa «Qualquer» atributo.
Quantidade partilhada ou própria? Se todas as variantes usam o mesmo conjunto físico de unidades, a contagem pode ficar no produto principal. Quando cada cor ou tamanho tem unidades distintas, controle-as nas variantes. Numa configuração mista, as variantes com gestão própria usam a sua contagem; as restantes podem consumir a do produto principal, se estiver ativa. Não some os dois níveis como se fossem inventários independentes.
Separar partilha legítima de correspondência errada
Exemplo hipotético: uma loja vende uma caneca lisa ou a mesma caneca com um ficheiro digital. Ambas podem consumir o mesmo conjunto físico de canecas no produto principal. Uma caneca de edição especial, fisicamente distinta, pode ter contagem própria na variante. Uma venda da edição especial deve afetar essa contagem, não a das canecas comuns. Este raciocínio ilustra a configuração; não relata um ensaio realizado.
Evidência: selecione todos os atributos na cópia da loja, anote o ID que entrou na encomenda e confronte-o com o campo alterado. Se existirem opções com «Qualquer» atributo, procure combinações sobrepostas: WooCommerce usa a primeira variante compatível na ordem do painel. Não confunda a etiqueta escolhida pelo cliente com a identificação efetivamente registada.
Decisão: mantenha a contagem partilhada apenas quando as opções consomem as mesmas unidades físicas. Para existências distintas, use contagens próprias. Se a correspondência estiver errada, corrija os atributos e valide a seleção na cópia antes de aplicar a mudança; aumentar a quantidade da variante errada não resolve a causa.
As Ações em massa no separador de variantes abrangem todas as opções do produto e podem guardar imediatamente. Não atribua a mesma quantidade a existências diferentes. Registe os valores anteriores, ensaie numa cópia e confira as variantes afetadas; para uma divergência isolada, investigue e corrija apenas a opção identificada.
Há zero unidades, mas a loja continua a aceitar pedidos
Causa a verificar: permitir encomendas em atraso autoriza pedidos sem quantidade disponível e pode levar o valor abaixo de zero. Isso é diferente de prometer expedição imediata. Uma quantidade negativa, por si só, não prova uma venda duplicada.

Disponibilidade, aviso e visibilidade são decisões diferentes
Nas opções de encomendas em atraso, distinga não permitir, permitir com aviso ao cliente e permitir. Esta última não substitui a comunicação de disponibilidade e prazo. Com atrasos permitidos, a quantidade pode ficar negativa. Confira a opção em cada variante aplicável.
Ocultar esgotados afeta a exposição no catálogo, não repõe quantidades. Nas variantes, a ocultação depende também de gerir a quantidade nesse nível e de não permitir atrasos. Separadamente, o formato de apresentação permite mostrar sempre a quantidade, só quando baixa ou nunca. Não mostrar um número não prova que o controlo esteja desligado.
As definições oficiais de produtos detalham limites, destinatários e apresentação. Para os avisos de stock baixo, confira o limite específico do produto ou variante e a regra de herança. Distinga-o do limite geral de esgotado, que determina a passagem a indisponível.
Evidência: confira a opção de atrasos no produto e em cada variante aplicável. Na cópia, observe a mensagem depois de escolher a combinação exata e tente uma quantidade superior à disponível, sem usar pagamentos reais. Registe se a compra é impedida ou aceite com a comunicação pretendida.
Decisão: não permita atrasos quando a equipa não consegue cumprir e acompanhar esses pedidos. Se os permitir, comunique disponibilidade e prazo de forma coerente.
Os avisos de stock baixo e esgotado ajudam a equipa a agir, mas não repõem mercadoria. Verifique a receção num ensaio controlado: o envio de um email não prova entrega. O alerta de encomendas em atraso é distinto e exige gestão de quantidade e atrasos permitidos.
O produto fica indisponível enquanto aguarda pagamento
Causa a verificar: uma reserva temporária pode reduzir a disponibilidade sem corresponder a uma saída física. Em Reter stock (minutos), o prazo aplica-se a encomendas elegíveis em «Pagamento pendente»; quando expira, estas podem ser canceladas e o stock libertado. Não se aplica a «Em espera» e deixar o campo vazio desativa esse limite.
Evidência: registe o estado exato da encomenda, a hora, o meio de pagamento e o prazo configurado. «Pagamento pendente» e «Em espera» não são intercambiáveis: no estado «Em espera», o stock já foi reduzido, embora a confirmação do pagamento ainda esteja pendente. O prazo de retenção não liberta essas unidades. Confronte as descrições oficiais dos estados com as notas da encomenda antes de tratar a indisponibilidade como uma simples reserva expirada.
E o checkout por blocos? A documentação atual dos estados de encomenda distingue o rascunho temporário da encomenda já submetida. Num checkout novo, as interações com o formulário ficam primeiro na sessão; o rascunho é criado quando o cliente tenta efetuar a encomenda, não apenas ao abrir a página. Quando o processo chega à reserva de unidades, esta pode existir em Rascunho ou Pagamento pendente e usa a definição de retenção da loja. Assim, não encontrar um rascunho antes da submissão não prova ausência de atividade, nem uma reserva prova pagamento. Confira a versão e o percurso reais da loja: não aplique um prazo fixo copiado de instruções antigas.
Decisão: ajuste o prazo à forma de pagamento e à operação, não a um valor universal. Não cancele encomendas reais nem altere estados apenas para libertar unidades. No painel do prestador, distinga autorização de captura: uma autorização pode apenas bloquear fundos, sem os transferir. Se houver cobrança confirmada mas a encomenda continuar pendente, confira o webhook ou retorno segundo a documentação desse meio de pagamento e reconcilie a encomenda antes de expedir. Não peça ao cliente para pagar novamente enquanto não excluir uma cobrança ou autorização anterior.
O painel está certo, mas a montra mostra outra disponibilidade
Causas a distinguir: apresentação configurada, seleção de outra variante ou conteúdo em cache. Investigue esta última hipótese sem confundir uma mensagem desatualizada com uma divergência na contagem guardada.
Evidência: compare a mesma variante no painel e numa sessão sem autenticação, anotando os atributos e a hora. Confira o formato de apresentação, o limite que determina o estado esgotado e a regra de ocultação: um limite de esgotado acima de zero pode tornar indisponível um artigo que ainda tem unidades. Se uma variante nem aparecer, confirme também se está ativa e tem preço; a documentação de produtos variáveis indica que as variantes sem preço não são mostradas. Só investigue cache depois de excluir estas diferenças de configuração.
A combinação aparece, mas não pode ser comprada? Por defeito, em produtos com mais de 30 variantes, os menus de atributos deixam de filtrar dinamicamente as combinações. Podem mostrar opções incompatíveis até o cliente concluir a seleção e receber a mensagem de indisponibilidade. A documentação de produtos variáveis distingue este comportamento de um erro de contagem. Compare a combinação completa com as variantes existentes antes de alterar quantidades; não aumente esse limite técnico como primeira tentativa de correção.
Se a diferença persistir só na montra: peça ao responsável pela cache para comparar a página do produto antes e depois de uma limpeza dirigida, mantendo o mesmo ID de variante e sem alterar quantidades. Registe a camada intervencionada, a hora e o resultado; limpar apenas o navegador não distingue uma resposta antiga no servidor ou na CDN. A documentação de diagnóstico do checkout exige excluir Carrinho, Finalizar compra e A minha conta da cache de página e impedir respostas guardadas nos pedidos AJAX e Store API do WooCommerce. Não aplique cache a esses percursos para tentar corrigir a disponibilidade.
Decisão: corrija a apresentação se a contagem estiver certa; não altere unidades para obter uma mensagem visual diferente. Para a organização do catálogo, consulte o guia de categorias de produtos no WooCommerce. A organização e a disponibilidade são problemas distintos.
A quantidade volta a mudar ou não regressa após reembolso
Causas possíveis: uma sincronização volta a impor o valor da origem, existem movimentos posteriores à contagem ou o reembolso não incluiu reposição. Antes de editar, compare as horas das encomendas, devoluções, ajustes e sincronizações com o momento da divergência.
Quando existe ERP, ponto de venda ou outro conetor: construa uma linha temporal para o mesmo SKU e ID de variante: valor na origem, última exportação, receção na loja e movimento posterior. Consulte a documentação do conetor para saber se envia uma quantidade absoluta ou movimentos de entrada e saída, e qual a direção autorizada. Esta distinção orienta a investigação: receber novamente um valor absoluto pode sobrescrever um acerto; repetir um movimento pode duplicá-lo. Guarde o identificador da operação e a resposta ou erro disponível, sem segredos. Não reenvie lotes nem force uma sincronização antes de o responsável confirmar o efeito esperado.
E se a encomenda passou a «Falhada»? A documentação de diagnóstico de encomendas distingue uma reposição automática de um reembolso: no WooCommerce 11.0 e posteriores, a passagem a «Falhada» devolve unidades apenas quando estas tinham sido reduzidas nessa encomenda. Procure nas notas a mudança de estado e a entrada de aumento de stock. Uma recusa imediata sem redução anterior não deve gerar uma reposição adicional. Confirme a versão instalada e os movimentos antes de autorizar qualquer ajuste manual.
E no cancelamento? Segundo os estados oficiais de encomenda, o cancelamento devolve unidades ao inventário quando a gestão está ativa. Isso não devolve automaticamente o dinheiro ao cliente. Antes de voltar a disponibilizar mercadoria, confira as notas, os movimentos já registados e a situação do pagamento; não some uma reposição manual à que o sistema já efetuou.
Reembolso não equivale sempre a reposição. Na cópia, confirme as unidades abrangidas e a opção Repor artigos reembolsados em stock. Num reembolso parcial, a encomenda não muda para «Reembolsado»: confira as linhas e as notas, não apenas o estado. Reembolsar dinheiro e repor mercadoria são decisões diferentes. Leia as notas da encomenda antes e depois; não faça um segundo acerto se a primeira operação já repôs as unidades.
Evidência: guarde as notas da encomenda antes e depois da operação e confirme o sistema que controla as quantidades. Um reembolso manual regista a operação no WooCommerce, mas não devolve o dinheiro através do meio de pagamento; o movimento monetário tem de ser tratado separadamente. Não infira entrada física de mercadoria a partir do estado «Reembolsado».
Decisão: se um conetor for a origem da contagem, investigue e autorize a correção nesse sistema em vez de repetir ajustes locais que serão sobrescritos. Se já houve reposição, não faça um segundo acerto. Não desligue integrações de produção para experimentar nem transforme um problema de stock numa alteração financeira não verificada.
Como confirmar a causa sem afetar encomendas reais
Teste a redução e a reposição apenas numa cópia isolada, sem ligações operacionais à produção. Não sobreponha a base de dados de teste à loja com encomendas atuais. WordPress — cópias de segurança explica o que incluir numa cópia para poder planear a recuperação.

O ensaio deve responder à hipótese escolhida, não percorrer definições ao acaso. Use dados fictícios, pagamentos sandbox e uma cópia sem emails, webhooks, faturação ou expedição de produção. Registe o identificador, a quantidade inicial, a operação, o estado e as notas da encomenda e a quantidade final. Não foram executados testes numa loja para este artigo.
Se as notas não explicarem o movimento, procure os registos do meio de pagamento em WooCommerce > Estado > Registos (os nomes variam com a tradução), filtrando o dia e a integração usados. Conforme a documentação de diagnóstico, ativar registos só recolhe operações futuras: não reconstrói uma tentativa antiga. Se for necessário reproduzir a falha, faça-o na cópia isolada e em modo de teste. Ao partilhar evidência com o suporte, remova dados pessoais e credenciais; não envie exportações indiscriminadas de encomendas.
Ficha de verificação e critério de fecho
Modelo em branco: substitua «Por executar» por observado, divergente ou não aplicável, com evidência e data. Não contém resultados de testes reais.
| Cenário | Registar | Conferir | Resultado |
|---|---|---|---|
| Compra simples | Quantidade antes/depois | Identificador comprado e movimento registado | Por executar |
| Variante própria | Quantidade antes/depois | Alteração apenas na contagem pretendida | Por executar |
| Variante partilhada | Quantidade antes/depois | Movimento na contagem do produto principal | Por executar |
| Última unidade, sem atrasos | Quantidade antes/depois | Disponibilidade após a compra e tentativa acima do disponível | Por executar |
| Reposição de unidade fictícia | Quantidade antes/depois | Opção escolhida, unidades e ausência de segundo acerto | Por executar |
Feche a ocorrência apenas quando a evidência distinguir a causa da consequência: o ID comprado corresponde à opção escolhida, o movimento atinge a contagem prevista e a mensagem ao comprador reflete a política aprovada. Acrescente à ficha a causa confirmada, o responsável, a data e a decisão tomada. Se a origem continuar incerta, mantenha o ajuste pendente e encaminhe os registos para análise, em vez de declarar o problema resolvido.