Solução de problemas

Quando alguma coisa não roda como esperado, esta lista cobre 90% dos casos. Vá pelo problema que se parece com o seu.

Status do pedido não está sendo atualizado

Faça esta lista, em ordem:

Em WooCommerce → Configurações → Correios Updater, os status estão definidos? Pelo menos Status para se verificar precisa ter algo (padrão: Processando). Se nenhum status de destino estiver preenchido, o plugin lê os Correios mas não muda nada — então pode parecer "quebrado" sem estar.
O rastreio teste retorna sucesso? Coloque um código real em Rastreio teste e clique em testar. Se vier erro, o problema está nas credenciais ou no acesso à API CWS.
A seção de saúde dos eventos agendados mostra "agendado"? Se mostra que o cron não está agendado, há um problema com o cron do WordPress.
O pedido em questão tem código de rastreio? O plugin só consulta pedidos que têm pelo menos um código (vindo de qualquer plugin compatível — veja Compatibilidade).

Se passou por tudo e nada funciona, ative o log e veja os arquivos em WooCommerce → Status → Logs → correios-updater.

Em WooCommerce → Configurações → E-mails, o e-mail Andamento da entrega dos Correios (cliente) ou Falha na entrega dos Correios (admin) está habilitado?
O pedido tem menos de 40 dias? Pedidos mais antigos não disparam e-mail por padrão. Veja Notificações por e-mail pra mudar essa janela.
Outros e-mails do WooCommerce estão chegando? Se nem o e-mail de "novo pedido" sai, o problema é de SMTP/envio do site, não do plugin. Instale um plugin SMTP (ex: WP Mail SMTP) e configure um relay.
Tem código personalizado bloqueando? Filtros como wc_correios_status_updater_trigger_email podem desativar o envio. Procure no seu functions.php ou em outros plugins.

Quase sempre é credencial.

Verifique Login, Chave API e Cartão de postagem.
Entre em cws.correios.com.br e confirme que o cartão está ativo (não suspenso).
A API de rastreamento está habilitada na sua conta? Não vem por padrão. É preciso solicitar ao gerente da sua conta nos Correios.
Se as credenciais estão corretas e a API foi liberada, o problema pode ser indisponibilidade temporária. Tente daqui a algumas horas.

Se a tela de configurações mostra que o evento de monitoramento não está agendado:

Cron desabilitado por código? Procure DISABLE_WP_CRON no wp-config.php. Se estiver true, o WordPress não agenda nada — você precisa de um cron externo (como o wget/curl chamando o wp-cron.php periodicamente).
Use o WP Crontrol pra investigar. Instale o plugin WP Crontrol e vá em Ferramentas → Eventos Cron. Procure correios_updater_queue — se não estiver lá, o agendamento falhou.
Muitos eventos com "agora"? Se o WP Crontrol mostra dezenas/centenas de eventos com horário "agora", a fila de cron do site não está sendo executada. Fale com a hospedagem ou seu desenvolvedor.

Use a opção em WooCommerce → Configurações → Correios Updater ou abra esta URL no navegador (com sessão de admin):

https://sua-loja.com/wp-admin/?correios-updater-force-cron

Isso processa todos os pedidos elegíveis na hora. Útil quando você acabou de adicionar credenciais ou está debugando.

WP Crontrol mostra dois ou mais eventos correios_updater_queue? Pode ter ficado duplicado depois de uma migração. Apague os extras manualmente.
Nenhum código custom está chamando do_action( 'correios_updater_queue' ) direto? Se sim, o agendamento natural soma com o manual.
Quanto tempo entre as duplicatas? Se for o intervalo do cron (3h padrão), provavelmente é uma meta_query quebrada — confira filtros em wc_correios_status_updater_get_orders_args.

Se um pedido específico nunca atualiza:

No banco, procure o meta _wc_correios_status_updater_count desse pedido. Apague.
Se possível, remova e adicione o código de rastreio de novo.
Force a verificação manual (link acima).

Pra investigar com mais detalhes, ative Ativar log nas configurações. Os arquivos vão pra:

Desligue depois

O log é detalhado de propósito. Em produção, mantenha desligado — os arquivos crescem rápido.