Resolução de problemas

Cenários comuns e como diagnosticar.

Métodos JadLog não aparecem no checkout

Sintoma: o cliente faz simulação de frete e nenhuma modalidade JadLog aparece.

Checklist:

1. Token e CNPJ corretos em WooCommerce → Configurações → JadLog. Se você não tem Conta Corrente ou Contrato, informe 0 em vez de deixar em branco.
2. Método adicionado à zona de envio. Vá em WooCommerce → Configurações → Entrega, verifique se a zona que cobre o CEP do cliente tem ao menos uma modalidade JadLog ativa.
3. CEP de origem preenchido em cada método.
4. Classe de entrega: se você restringiu o método a uma classe específica, confirme que o produto do carrinho está marcado com aquela classe.
5. Ordem das zonas: se você tem várias zonas, ordene da mais específica (CEP exato ou faixa) para a mais ampla. O WooCommerce usa a primeira zona que casar.
6. Log do método: edite o método de envio na zona, marque Log de depuração, salve, simule um frete no carrinho e abra WooCommerce → Status → Logs. Procure por arquivos wc_jadlog_....

Etiqueta não gera

Sintoma: clique em Gerar etiqueta retorna erro.

Checklist:

1. Endereço do remetente completo em WooCommerce → Configurações → JadLog.
2. Unidade / Ponto emissor preenchido.
3. Token e CNPJ corretos (mesmo do passo anterior).
4. Endereço do cliente completo no pedido — sem CEP, número ou cidade, a JadLog rejeita.
5. Série da NF e CFOP preenchidos, se a operação exige.
6. Tente outra modalidade — algumas têm cobertura limitada para certos CEPs.

A mensagem de erro retornada pela JadLog aparece no painel ou no console do navegador. Esse texto é o que orienta a correção.

E-mails de rastreio não chegam

Sintoma: cliente não recebe nenhum aviso quando você adiciona código de rastreio ou quando o status muda.

Checklist:

1. E-mail habilitado: vá em WooCommerce → Configurações → E-mails e confirme que JadLog - Andamento da entrega e JadLog - Código de rastreio estão ativos.
2. Verifique notas do pedido — o plugin registra cada disparo. Se não tem nota mencionando envio de e-mail, o disparo não rolou.
3. Teste o envio do WooCommerce com a opção de e-mail de teste em WooCommerce → Configurações → E-mails. Se nem isso chega, é problema de SMTP do site.
4. Spam do cliente — peça pra ele conferir caixa de spam, especialmente em domínios Gmail/Outlook.

Rastreio não atualiza sozinho

Sintoma: pedidos com código de rastreio ficam parados no mesmo status há dias.

Checklist:

1. O status atual do pedido está em Status para se verificar? Se não está, o cron não consulta esse pedido.
2. Forma de rastreio está alinhada com o tipo de código que você adiciona? Se a config é CTE e você cola código no formato comum, a consulta sempre falha.
3. WP Cron está rodando no site? Vá em WooCommerce → Status → Ferramentas de sistema → Ações agendadas e veja se há ações pendentes acumulando.
4. Forçar execução: vá em WooCommerce → Status → Ferramentas → Executar cron JadLog e clique. Isso roda a fila imediatamente, independente do schedule. O plugin gera um log jadlog-force-execution informando se a fila estava travada.

Erros de conexão com a API

Sintoma: cálculo de frete demora ou retorna vazio. Logs mostram timeout.

Checklist:

1. JadLog fora do ar — confira em https://www.jadlog.com.br.
2. Servidor sem acesso a jadlog.com.br — firewall, proxy ou WAF bloqueando saída.
3. Contrato exigido pelo seu cadastro mas configurado como 0.
4. Volume muito alto de simulações simultâneas — algumas modalidades têm limite de chamada por segundo.

Habilitar e desabilitar log

Para diagnosticar:

1. Em WooCommerce → Configurações → JadLog, marque Ativar log.
2. Em cada método de envio na zona, marque Log de depuração.
3. Reproduza o problema.
4. Veja os arquivos em WooCommerce → Status → Logs.

Onde os logs ficam

No servidor, em /wp-content/uploads/wc-logs/:

• jadlog-*.log — logs do plugin (rastreio, fila, etiquetas).
• woocommerce-*.log — logs dos métodos de envio (cálculo de frete).

Quando pedir suporte

Antes de abrir um chamado, tenha em mãos:

• Print das configurações de WooCommerce → Configurações → JadLog.
• Print das zonas de envio e dos métodos JadLog adicionados.
• Conteúdo do log relevante colado em https://snippets.fernandoacosta.net (link gerado é o que vai no chamado).
• Versão do WooCommerce e versão do WC JadLog (rodapé das configurações ou wp-admin → Plugins).

Com esse pacote, o diagnóstico é direto.