O WC JadLog gerencia códigos de rastreio de três formas: manualmente no painel do pedido, automaticamente quando você gera uma etiqueta, ou via REST API a partir de outro sistema.
Adicionar código manualmente
- Abra o pedido em WooCommerce → Pedidos.
- Localize o metabox JadLog na lateral direita.
- Cole o código de rastreio no campo correspondente e salve.
Ao salvar:
- O código fica disponível ao cliente na página Minha conta → Pedidos.
- Um e-mail automático é enviado ao cliente avisando que o pacote saiu.
- Se você configurou Status após informar rastreio, o pedido muda de status sozinho.
Se precisar reenviar o e-mail com o código (cliente apagou, marcou como spam etc), use o menu Ações dentro do pedido — tem uma opção pra disparar a notificação de novo.
Forma de rastreio
A configuração Forma de rastreio (em WooCommerce → Configurações → JadLog) define qual identificador o plugin envia à JadLog para consultar status:
- CTE — número do CT-e (mais comum quando você gera nota fiscal).
- Código de rastreio — código no formato JadLog (padrão para a maioria das operações).
- ID da solicitação — identificador interno gerado quando você emite a etiqueta pelo plugin.
- Número do pedido — usa o número do próprio pedido WooCommerce como referência (só funciona se a JadLog tem isso amarrado ao seu contrato).
Se você configura a Forma de rastreio como CTE mas adiciona códigos de rastreio normais nos pedidos, a consulta automática vai falhar. Mantenha a configuração e o tipo de código que você cola no metabox alinhados.
Atualização automática de status
Um cron interno roda a cada 4 horas e faz o seguinte:
- Busca pedidos cujo status está em Status para se verificar.
- Pega o código de rastreio de cada pedido.
- Consulta a JadLog para ver se houve novidade.
- Se o status mudou, envia e-mail ao cliente com os eventos novos.
- Se o pacote foi entregue e você configurou Status após entrega realizada, atualiza o status do pedido.
- Registra o evento numa nota interna do pedido.
Status JadLog reconhecidos
- EMISSAO — objeto postado.
- TRANSFERENCIA — em transferência entre filiais.
- ENTRADA — chegou no centro de distribuição de destino.
- EM ROTA — saiu para entrega.
- ENTREGUE — entregue ao destinatário.
Múltiplos códigos por pedido
Um mesmo pedido pode ter mais de um código de rastreio (envio dividido em duas caixas, por exemplo). O plugin trata cada código separadamente e atualiza o pedido só quando todos estão entregues.
Adicionar código via REST API
O campo jadlog_tracking_code está disponível no endpoint padrão de pedidos do WooCommerce.
GET /wp-json/wc/v3/orders/123
Resposta:
{
"id": 123,
"jadlog_tracking_code": "12345678901234",
...
}
Para definir ou atualizar:
PUT /wp-json/wc/v3/orders/123
Content-Type: application/json
{
"jadlog_tracking_code": "12345678901234"
}
Para múltiplos códigos, separe por vírgula: "123...,456...".
A autenticação é a mesma da REST API do WooCommerce (API keys em WooCommerce → Configurações → Avançado → API REST). Setar via API dispara as mesmas notificações que adicionar manualmente.
Mais detalhes em REST API.
Forçar consulta agora
Se você quer consultar o status agora sem esperar a próxima execução do cron, vá em WooCommerce → Status → Ferramentas → Executar cron JadLog. Veja resolução de problemas.