Modo debug e logs

O Frete para Marketplace tem um modo debug que grava todas as decisões do plugin (split de carrinho, leitura de CEP por vendedor, integração com método de envio) em arquivos de log. É a primeira ferramenta pra investigar problemas de cálculo.

Quando ativar

Use o modo debug pra investigar:

• Frete não está dividindo por vendedor.
• Cálculo de frete está retornando valor estranho ou erro.
• O CEP do vendedor parece não estar sendo lido.
• Conflito com outro plugin de envio.

Como ativar

1. Vá em WooCommerce → Configurações → Entrega.
2. Procure a seção Frete para marketplace.
3. Marque a opção Debug mode.
4. Clique em Salvar alterações.

Onde ficam os logs

Os logs do plugin seguem o sistema de log nativo do WooCommerce. Eles ficam em:

/wp-content/uploads/wc-logs/wc-split-shipping-*.log

O nome do arquivo inclui um hash de segurança gerado pelo WooCommerce (algo como wc-split-shipping-2024-02-02-abc123.log).

Você também pode ver pela interface em WooCommerce → Status → Logs — selecione o arquivo wc-split-shipping-* no dropdown.

O que aparece no log

Trecho típico de uma sessão de checkout:

Vendedores no carrinho: Array
(
    [123] => Loja do João
    [456] => Loja da Maria
)
Correios: Dados de vendedor encontrados: 01001-000. Vendor ID: 123
Correios: Dados de vendedor encontrados: 80010-000. Vendor ID: 456
Melhor envio: CEP do vendedor 01001-000. vendor id: 123

O que cada linha diz:

• Vendedores no carrinho: lista de IDs e nomes de vendedores que o plugin detectou. Se aparece vazio, o plugin não conseguiu identificar o vendedor de nenhum produto — confira se o marketplace está ativo e se os produtos têm vendedor atribuído.
• Correios: Dados de vendedor encontrados: o CEP do vendedor X foi lido com sucesso e usado no cálculo do Correios. Se aparece com CEP vazio, o cadastro do vendedor está incompleto.
• Melhor envio: CEP do vendedor: idem pra integração com Melhor Envio.

Checklist de investigação

Quando algo não funciona, com debug ligado:

1. Limpe o log atual (deleta o arquivo ou abre o painel e clica em "Limpar").
2. Reproduza o problema uma vez (adicione produto, vai pro checkout, simula um CEP de destino).
3. Abra o log novo e procure por:
   • A lista Vendedores no carrinho aparece e está completa? Se não, problema de detecção do vendedor (marketplace).
   • Os CEPs dos vendedores aparecem preenchidos? Se aparecem vazios, problema de cadastro.
   • O método de envio (Correios, Melhor Envio) aparece processando? Se nem aparece, o plugin de envio não está hookado.

Debug avançado: outros plugins

O log do Frete para Marketplace cobre apenas o que o Frete para Marketplace faz. Pra investigar o método de envio em si (Correios, Melhor Envio), ative também o log do plugin correspondente — cada um tem o próprio toggle de debug.

Em WooCommerce → Status → Logs dá pra ver todos os arquivos juntos, ordenados por data.

Próximos passos

• Solução de problemas
• Helper remove_class_hook() — útil quando precisa neutralizar um hook conflitante