O Correios Updater não cadastra códigos de rastreio nos pedidos — ele consulta códigos que outros plugins (ou seu código) já colocaram lá. Esta página lista os plugins suportados e como ligar cada um.
WooCommerce Correios (Claudio Sanches)
Plugin gratuito no repositório do WordPress que adiciona métodos de envio dos Correios ao WooCommerce e tem um painel pra colocar códigos de rastreio nos pedidos.
Como ativar: nada. O Correios Updater detecta automaticamente, lendo via wc_correios_get_tracking_codes().
Quando usar: é a opção mais comum no Brasil. Se você só usa Correios, esse é o caminho padrão.
Notificação para qualquer transportadora
Plugin que permite cadastrar códigos de rastreio de qualquer transportadora (Correios, Jadlog, Loggi etc.) com URLs customizadas.
Como ativar: em WooCommerce → Configurações → Correios Updater, marque Notificação para qualquer transportadora.
Quando ativo, o Correios Updater vai usar wc_any_shipping_get_tracking_codes() pra ler os códigos. Apenas códigos dos Correios entram na consulta — códigos de outras transportadoras passam batido.
Quando usar: se você despacha por mais de uma transportadora e centraliza tudo nesse plugin.
Infixs Correios Automático
Plugin completo dos Correios que cobre cálculo de frete, geração de etiquetas e cadastro de rastreios.
Como ativar: em WooCommerce → Configurações → Correios Updater, marque Infixs Correios Automático.
Quando usar: se você já está no ecossistema do Infixs e quer que o Correios Updater monitore os códigos cadastrados por ele.
Sim. Você pode ativar Notificação para qualquer transportadora e Infixs Correios Automático ao mesmo tempo. O Correios Updater junta os códigos de todas as fontes habilitadas. Se o mesmo código aparece em mais de uma fonte, ele é deduplicado.
Implementação própria via filtro
Se seu plugin custom (ou um ERP/integração) coloca códigos em campos específicos do pedido, use o filtro wc_correios_status_updater_tracking_code pra incluir esses códigos.
add_filter( 'wc_correios_status_updater_tracking_code', function( $codes, $order ) {
$custom_code = $order->get_meta( '_meu_campo_codigo_correios' );
if ( $custom_code ) {
$codes[] = $custom_code;
}
return $codes;
}, 10, 2 );
Os códigos são normalizados (uppercase + trim) antes da consulta.
Mais detalhes em Filtros disponíveis.
Como saber qual fonte está funcionando
A função helper correios_updater_get_order_tracking_codes( $order ) retorna o array final de códigos que o plugin vai consultar pra um pedido específico. Útil pra debugar se um código está sendo lido como esperado.
$codes = correios_updater_get_order_tracking_codes( wc_get_order( 123 ) );
// ['AA123456789BR', 'BB987654321BR']
Mais helpers em Funções auxiliares.