Debug e logs

Quando o prazo aparece errado no checkout — soma a mais, número diferente, cálculo que não bate — o jeito mais rápido de diagnosticar é ativar o debug e olhar o log.

Como ativar

Vá em WooCommerce > Configurações > Entrega > Opções de entrega, seção "Dias adicionais", e ative Debug dos métodos.

A partir desse momento, o plugin registra cada operação de cálculo nos logs do WooCommerce.

Onde ver os logs

Vá em WooCommerce > Status > Logs.

No seletor, procure pelo arquivo wc-additiona-days-per-product. Cada linha do log mostra:

O ID e instance ID do método de envio que disparou o cálculo.
Os argumentos que o método recebeu (label, custos, metadados).
A identificação de qual integração foi acionada (Correios, Melhor Envio, etc).
Os dias adicionais calculados para o carrinho.
O resultado final (prazo base + dias adicionais).

O que o log ajuda a investigar

Soma duplicada: o log mostra duas operações onde deveria ter uma — provavelmente outro plugin já está adicionando o prazo de produção.
Número errado: o log indica qual número do label foi substituído. Se foi o número errado (ex: o CEP em vez do prazo), use o filtro wc_additional_days_per_product_not_replace.
Sem soma nenhuma: o log mostra o método de envio, mas o cálculo não roda — é sinal de que a integração com aquele plugin de frete não está sendo detectada.
Prazo zero quando deveria ter prazo: o log mostra os dias adicionais calculados para cada item do carrinho. Cruze com o que está configurado em produto/categoria/global.

Exemplo de entrada no log

2026-04-15T14:23:01+00:00 INFO flat_rate:1 new: Array
(
    [id] => flat_rate:1
    [label] => Taxa fixa
    [cost] => 25.00
    [meta_data] => Array (...)
)

Cada cálculo gera múltiplas entradas (uma por método de envio cotado).

Cuidado em produção

Desative o debug após o diagnóstico

Logs em produção:

Aumentam o uso de disco rápido (carrinho ativo gera muita entrada).
Tornam o checkout perceptivelmente mais lento em sites com tráfego alto.
Podem expor informação sensível dos métodos de envio.

Use só pelo tempo necessário para reproduzir o problema. Depois desative.

Forçar o debug por código

Se você quer ativar o debug condicionalmente (ex: só em ambiente de staging), use o filtro:

add_filter( 'wc_additional_days_per_product_debug', function() {
    return 'staging' === wp_get_environment_type();
});

Detalhes em Filtros disponíveis.