Instalação e primeiros passos

A configuração inicial leva uns 15 minutos. Você precisa de credenciais ativas dos Correios e ter um plugin que adicione códigos de rastreio aos pedidos.

Pré-requisitos

• WooCommerce 6.0 ou superior.
• PHP 7.4 ou superior.
• Cron do WordPress habilitado (a constante DISABLE_WP_CRON não pode estar ligada — se estiver, o plugin não consegue agendar nada).
• Credenciais ativas no portal CWS dos Correios:
  • Login CWS
  • Chave API (senha)
  • Cartão de postagem
• Um plugin que coloque códigos de rastreio nos pedidos (lista abaixo).

Plugins compatíveis pra adicionar o código de rastreio

Veja a lista detalhada em Compatibilidade com plugins de rastreio. Resumo:

• WooCommerce Correios (Claudio Sanches) — funciona direto.
• Notificação para qualquer transportadora — habilite a opção Notificação para qualquer transportadora nas configurações.
• Infixs Correios Automático — habilite Infixs Correios Automático.
• Implementação própria — use o filtro wc_correios_status_updater_tracking_code (veja Filtros disponíveis).

Passos de instalação

1. Instale e ative o plugin pelo zip ou pelo painel do WordPress.
2. Vá pra WooCommerce → Configurações → Correios Updater.
3. Preencha as credenciais CWS:
   • Login — login do CWS.
   • Chave API — senha/chave gerada no CWS.
   • Cartão de postagem — número do cartão associado ao login.
4. Em Status para se verificar, selecione os status de pedido que devem ser monitorados. Padrão é Processando — adicione outros se você usa um fluxo diferente.
5. Configure os status de destino (todos opcionais — só preencha o que faz sentido pra sua loja):
   • Status após inserir código de rastreamento — status que o pedido recebe quando você adiciona o código.
   • Status após entrega realizada — quando todos os pacotes foram entregues.
   • Status 'Saiu para entrega' — quando o objeto saiu pra entrega.
   • Status Aguardando Retirada — quando o destinatário precisa retirar na agência.
   • Status para Pedido não entregue — quando há falha de entrega.
6. Teste a conexão. Em Rastreio teste, coloque um código real de rastreio dos Correios e clique em testar. Se a resposta vier com os eventos, está tudo certo.
7. Habilite os e-mails em WooCommerce → Configurações → E-mails:
   • Andamento da entrega dos Correios (cliente).
   • Falha na entrega dos Correios (admin).

Próximos passos

• Configurações do plugin — referência detalhada de cada campo.
• Notificações por e-mail — personalizar texto, assunto e destinatários.
• Solução de problemas — quando algo não roda como esperado.