Logs e solução de problemas

Quando o estoque parece "não bater", a primeira pergunta é sempre a mesma: o plugin está agindo? O log responde isso.

Ativar log

1. Vá em WooCommerce → Configurações → Pagamento.
2. Role até a seção Debug.
3. Marque Ativar Log.
4. Salve.

A descrição do campo é literal: "Registrar atividades do plugin WC Redução e restauração de estoque".

Onde encontrar o log

Os logs são gravados no sistema padrão do WooCommerce. Pra visualizar:

1. WooCommerce → Status → Logs (no menu admin).
2. No seletor de arquivos, escolha o arquivo que começa com wc-stock-reducer-manager-.

Cada dia gera um arquivo separado. O plugin registra tanto operações de sucesso quanto avisos quando alguma checagem bloqueou uma ação.

Problemas comuns

Estoque não está sendo reduzido

Verifique nesta ordem:

1. Em WooCommerce → Configurações → Produtos → Inventário, a opção Gerenciar estoque? está marcada?
2. No produto específico, na aba Inventário, a opção Gerenciar estoque para este produto? está marcada?
3. Algum outro plugin (ou snippet no tema) está usando o filtro woocommerce_can_reduce_order_stock pra retornar false?
4. O pedido foi criado por algum fluxo que não passa pelo checkout normal (importação, API REST, etc)?

Com o log ativado, você verá entradas explicando o que o plugin pulou e por quê.

Pedido não está sendo cancelado depois do prazo

Para cancelamento por método de pagamento (Action Scheduler):

Em WooCommerce → Status → Ações agendadas, filtre pela ação wc_stock_manager_cancel_single_order. Veja se a ação do pedido em questão está agendada, falhou, ou já rodou. Se está como Pendente com data passada, pode ser falha do Action Scheduler — verifique se o WP-Cron está rodando.

Para cancelamento por dias:

Confirme que o cron wc_stock_manager_cancel_orders está agendado:

wp cron event list --fields=hook,next_run_relative | grep wc_stock_manager_cancel_orders

Se não aparecer, salve as opções do plugin novamente — o agendamento é recriado em qualquer carregamento do admin. Se o WP-Cron está desativado no wp-config.php (DISABLE_WP_CRON), você precisa configurar um cron do servidor que dispare o WP-Cron.

Estoque sendo restaurado em duplicidade

Cada item carrega a marca _reduced_stock que evita restauração dupla. Se mesmo assim você está vendo casos de duplicação, geralmente é porque outro plugin está disparando os mesmos hooks de status do WooCommerce. Desative outros plugins de gestão de estoque temporariamente pra confirmar.

Pedido reembolsado parcialmente devolveu estoque que eu não queria

A partir da v2.0.2, o plugin respeita a checkbox Restaurar estoque na tela de reembolso parcial. Se você ainda está vendo restauração indesejada, confirme que está na v2.0.2 ou superior em WooCommerce → Status → Sistema (procure pelo plugin na lista).

Reportar um problema

Se nada disso ajudou, anexe ao seu chamado:

• O arquivo de log do dia em que o problema aconteceu.
• O ID do pedido afetado.
• Versão do WooCommerce e do plugin (em WooCommerce → Status → Sistema).