Todas as opções estão em WooCommerce → Configurações → Correios Updater. Esta página descreve cada campo e o que ele faz.
Status do pedido
São os campos que dizem ao plugin quais pedidos verificar e pra qual status mover quando algo acontece nos Correios.
Status para se verificar
Status de pedido que entram na fila de verificação automática. Padrão: Processando.
Apenas pedidos nesses status e com um código de rastreio válido serão consultados. Pedidos Concluído ou Cancelado não entram na fila — se você usa um fluxo customizado (ex: status "Em entrega"), adicione aqui.
Status após inserir código de rastreamento
O pedido muda automaticamente pra esse status assim que você adiciona um código de rastreio. Útil pra marcar o pedido como "despachado" sem precisar fazer manualmente.
A detecção acontece através das notas internas do pedido — quando uma nota com o texto "Adicionado o código de rastreamento dos Correios" é criada.
Status após entrega realizada
Status final do pedido quando todos os pacotes (caso o pedido tenha mais de um código) foram marcados como entregues pelos Correios. Geralmente: Concluído.
Status Aguardando Retirada
Pedidos cujo objeto está esperando retirada em uma agência dos Correios. O endereço da agência é salvo no meta correios_updater_address e adicionado como nota do pedido.
Status 'Saiu para entrega'
Aplicado quando o objeto está em rota final de entrega ("Objeto saiu para entrega ao destinatário").
Status para Pedido não entregue
Aplicado em mais de 100 cenários de falha — devolução, recusa, endereço incorreto, retenção em alfândega, prazo encerrado, e por aí vai. O admin também recebe um e-mail nesse momento.
Credenciais da API dos Correios
Os três campos abaixo vêm da sua conta no cws.correios.com.br.
Login
Login do CWS.
Chave API
A senha/chave gerada no CWS. Não confunda com a senha de acesso ao portal — é uma chave separada, gerada na seção de credenciais.
Cartão de postagem
Número do cartão de postagem associado ao seu contrato.
Os três campos são salvos como texto plano nas opções do WordPress (woocommerce_correios-updater_settings). Quem tem acesso ao banco da sua loja consegue ver. Use credenciais dedicadas pra integração se isso é uma preocupação.
Compatibilidade com outros plugins
Notificação para qualquer transportadora
Marque se você usa o plugin WC Notificação para qualquer transportadora e quer que os códigos cadastrados lá sejam considerados pelo Correios Updater. Detalhes em Compatibilidade com plugins de rastreio.
Infixs Correios Automático
Marque se você usa o plugin Infixs Correios Automático com códigos dos Correios.
Usar versão antiga da API
Volta o plugin pra usar a API antiga (SOAP) dos Correios. Não use a não ser que você esteja num cenário muito específico — os Correios estão descontinuando essa API.
Diagnóstico
Rastreio teste
Coloque um código real dos Correios e clique no botão de teste. O plugin faz uma chamada ao vivo e mostra a resposta. Use sempre que mudar credenciais ou suspeitar que a integração parou.
A página também mostra o status do agendamento do cron — se aparecer "O evento de monitoramento está agendado", está tudo certo.
Ativar log
Liga o log detalhado do plugin. Os arquivos vão pra WooCommerce → Status → Logs → correios-updater.
O log é detalhado de propósito — gera arquivos grandes rápido. Use enquanto investiga um problema e desligue depois.
Resetar tudo
Se você quer começar do zero (deletar credenciais, status configurados etc.), basta apagar a opção woocommerce_correios-updater_settings no banco ou voltar tudo pelo formulário.
Próximos passos
- Status automáticos — como cada evento vira mudança de status.
- Solução de problemas — quando algo não roda.