Estoque errado no WooCommerce: como corrigir a contagem

Tipo WooCommerce

Nome do erro Estoque do WooCommerce mostrando errado EN: WooCommerce stock showing incorrect quantity

Severidade Grave

Descrição O estoque errado no WooCommerce acontece quando a quantidade exibida não bate com o real: produto disponível aparece esgotado, a contagem não baixa após a venda, ou somem unidades sem pedido. Quase sempre vem de cache antigo, de pedidos presos reduzindo estoque, ou de sincronização externa fora de hora.

O que é o estoque do WooCommerce mostrando errado?

O controle de estoque do WooCommerce guarda, para cada produto ou variação, a quantidade disponível e o status (em estoque, esgotado, sob encomenda). Ele baixa a quantidade quando um pedido é pago e a repõe se o pedido é cancelado. O ‘estoque errado’ é quando esse número diverge do real: o site mostra esgotado com produto em depósito, não atualiza após vendas, ou conta unidades fantasmas. A causa costuma ser cache, pedidos presos ou integração externa.

Como identificar

Um produto com estoque físico aparece como ‘Esgotado’ ou ‘Fora de estoque’ na loja.
A quantidade exibida não baixa depois que o pedido é pago e concluído.
O estoque some sem venda correspondente, com pedidos presos em ‘Pagamento pendente’ segurando unidades.
Mensagem no checkout ‘Desculpe, não temos [produto] em estoque suficiente’ para um item que deveria ter saldo.

Antes de começar: Faça backup do banco antes de corrigir estoque em massa ou de pausar integrações em uma loja no ar, porque ajustes manuais podem ser sobrescritos pela próxima sincronização. Confirme qual sistema é a fonte da verdade do estoque antes de alterar.

Como prevenir

Mantenha um único sistema como fonte da verdade do estoque e evite editar manualmente o que a integração sobrescreve
Configure ‘Manter estoque (minutos)’ com um valor curto para não travar unidades em carrinhos abandonados
Revise periodicamente pedidos presos em pagamento pendente, que seguram estoque sem concluir a venda

Causa

Cache de página ou de objeto servindo a contagem de estoque antiga, anterior à última venda ou reposição.
Pedidos presos em 'Pagamento pendente' ou 'Aguardando' reduzindo o estoque sem nunca serem concluídos nem liberados.
A opção 'Manter estoque (minutos)' segurando unidades de pedidos não pagos por tempo longo demais.
Sincronização com ERP, marketplace ou planilha sobrescrevendo a quantidade com um valor desatualizado.
Gerenciamento de estoque ativado no produto mas não nas variações (ou o inverso), gerando contagem inconsistente.

Como resolver

Confirme a configuração de estoque do produto: no editor do produto, aba Inventário, verifique se 'Gerenciar estoque' está ligado e a quantidade está correta. Em produto variável, cada variação tem seu próprio controle de estoque.
Limpe o cache de página e de objeto: limpe o cache do plugin e o cache de objeto (Redis/Memcached, se houver). A loja pode estar mostrando uma contagem antiga mesmo com o banco já atualizado.
Libere pedidos presos: em WooCommerce > Pedidos, filtre por 'Pagamento pendente' e 'Aguardando'. Cancele ou conclua os pedidos antigos que estão segurando estoque sem pagamento confirmado.
Ajuste 'Manter estoque (minutos)': em WooCommerce > Configurações > Produtos > Inventário, defina um valor razoável (ex.: 60) para 'Manter estoque'. Valores altos seguram unidades de carrinhos abandonados por tempo demais.
Verifique a sincronização externa: se um ERP, marketplace ou planilha alimenta o estoque, pause a sincronização e corrija a quantidade no produto. Depois confirme que a fonte externa está enviando o número certo antes de religar.

PHP

// functions.php do tema filho — registra no log toda alteracao de estoque
// com o motivo, para rastrear quem (pedido, sync, ajuste) mudou a contagem
add_action( 'woocommerce_product_set_stock', function ( $product ) {
    error_log( sprintf(
        'WooCommerce estoque: produto #%d agora com %s unidades',
        $product->get_id(),
        $product->get_stock_quantity()
    ) );
}, 10, 1 );

Perguntas frequentes

Tenho o produto em estoque mas o site mostra esgotado. Por quê?

Costuma ser cache servindo a contagem antiga, ou pedidos presos em pagamento pendente segurando as unidades. Limpe o cache de página e de objeto e libere pedidos antigos não pagos em WooCommerce > Pedidos.

O estoque não baixa depois da venda. O que verificar?

Confirme que 'Gerenciar estoque' está ligado no produto e que o pedido chegou a um status que reduz estoque (Processando ou Concluído). Pedidos que ficam em pendente não baixam o estoque definitivamente.

O que é a opção 'Manter estoque (minutos)'?

É o tempo que o WooCommerce reserva o estoque de um pedido não pago antes de liberá-lo. Se estiver muito alto, carrinhos abandonados seguram unidades por horas e o estoque parece menor do que o real. Use um valor curto, como 60 minutos.

Uma integração com marketplace pode bagunçar meu estoque?

Sim. Se um ERP, marketplace ou planilha sincroniza o estoque, ele pode sobrescrever a quantidade com um número desatualizado. Pause a sincronização, corrija no produto e confirme que a fonte externa envia o valor certo antes de religar.

Em produto variável, onde fica o controle de estoque?

Cada variação tem seu próprio campo de estoque na aba Variações. Se você ativou 'Gerenciar estoque' só no produto pai e não nas variações (ou o contrário), a contagem fica inconsistente. Padronize onde o estoque é gerenciado.

Como descobrir o que está mudando minha contagem de estoque?

Use o gancho woocommerce_product_set_stock para registrar no log toda alteração com ID e quantidade. Comparando os horários do log com as vendas reais, você identifica se a causa é pedido, sincronização externa ou ajuste manual.

Grave

Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro

A product page do WooCommerce com Astra quebrar significa que a tela do produto abre com layout desalinhado, galeria empilhada ou botão de comprar fora do lugar. Quase sempre vem de template do WooCommerce desatualizado no tema filho, do módulo WooCommerce do Astra Addon desativado ou de um page builder assumindo a single product.

Grave

Como corrigir email de pedido do WooCommerce não enviado

Quando o WooCommerce não envia o email de pedido, o cliente não recebe a confirmação e a loja não é avisada da venda. A causa quase sempre é a função mail() do PHP sendo bloqueada pela hospedagem ou marcada como spam; configurar um SMTP autenticado resolve a maioria dos casos.

Grave

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

O botão add to cart do WooCommerce não funcionar significa que o cliente clica em comprar mas o produto não entra no carrinho: o botão fica girando, recarrega a página sem somar, ou nada acontece. Quase sempre vem de requisições AJAX bloqueadas, conflito de JavaScript de plugin ou tema, ou do produto sem estoque ou sem preço.

Crítico

Como corrigir o formulário de pagamento Stripe que não processa no WPForms

O pagamento Stripe não processa no WPForms quando o formulário é enviado mas a cobrança no cartão não é criada, o envio trava no botão ou o pedido fica sem confirmação. As causas reais mais comuns são AJAX desativado no formulário, o addon Stripe Pro inativo, o modo Teste ligado em produção e SSL ou webhook mal configurados.

Crítico

Como corrigir o erro de checkout do WooCommerce causado pelo cache do WP Rocket

O checkout do WooCommerce com WP Rocket não funciona quando a página de finalizar compra é servida em cache ou tem o JavaScript do gateway adiado: o botão de finalizar pedido não responde, a página recarrega sem avançar ou retorna nonce expirado. A correção é garantir a exclusão de cache do checkout e liberar os scripts essenciais.

Atenção

Como corrigir o cálculo de frete errado no WooCommerce

O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.

Setores

Extensões

Integrações

Como corrigir o estoque do WooCommerce mostrando errado

O que é o estoque do WooCommerce mostrando errado?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro

Como corrigir email de pedido do WooCommerce não enviado

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

Como corrigir o formulário de pagamento Stripe que não processa no WPForms

Como corrigir o erro de checkout do WooCommerce causado pelo cache do WP Rocket

Como corrigir o cálculo de frete errado no WooCommerce

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos