Como funciona o Correios Updater

O Correios Updater consulta a API dos Correios em horários definidos, lê o histórico de eventos de cada código de rastreio que está nos seus pedidos e atualiza o status do pedido sempre que algo muda. O cliente recebe um e-mail automático no mesmo passo.

Você não precisa ficar entrando no site dos Correios pra cada pedido — o plugin faz isso pra você, em silêncio, no plano de fundo da loja.

O fluxo, do início ao fim

1. Pedido recebe um código de rastreio. Vem do plugin oficial do WooCommerce Correios, do Notificação para qualquer transportadora, do Infixs Correios Automático, ou de uma integração própria sua.
2. A cada 3 horas (padrão), o cron do WordPress dispara o plugin. Ele monta uma fila com todos os pedidos cujo status está marcado em Status para se verificar e que tenham códigos de rastreio.
3. O Action Scheduler do WooCommerce processa a fila. Cada pedido vira uma chamada à API dos Correios. Isso evita travar o site quando há muitos pedidos.
4. A resposta dos Correios é comparada com o último evento conhecido. Se nada mudou, o pedido é ignorado nessa rodada.
5. Se mudou, o plugin reage:
   • Entregue? Atualiza o status pra o que você definiu em Status após entrega realizada e dispara wc_correios_status_updater_order_delivered.
   • Saiu pra entrega? Vai pra Status 'Saiu para entrega'.
   • Aguardando retirada na agência? Vai pra Status Aguardando Retirada e salva o endereço da agência no pedido.
   • Falha (devolvido, recusado, retido)? Vai pra Status para Pedido não entregue e o admin recebe um e-mail.
6. O cliente recebe um e-mail. A não ser que você tenha desativado, ou que o pedido tenha mais de 40 dias.

O que o plugin não faz

• Não inclui código de rastreio sozinho. O código tem que vir de outro plugin (lista no item 1 acima) ou de uma integração sua.
• Não consulta os Correios em tempo real a cada visita do cliente. A consulta é em lote, em intervalos. Pra forçar uma rodada agora, use a opção em WooCommerce → Configurações → Correios Updater ou abra ?correios-updater-force-cron no admin.
• Não armazena os eventos completos no banco. Só o timestamp do último evento de cada código (pra evitar duplicar notificação).

Por onde começar

• Instalação e primeiros passos — credenciais CWS, ativação, configuração mínima.
• Configurações do plugin — referência completa de todos os campos.
• Status automáticos — como cada evento dos Correios vira mudança de status no WooCommerce.
• Solução de problemas — quando o cron não roda, e-mail não chega, ou pedidos parecem travados.