JadLog e Latam só geram etiqueta se você indicar qual agência vai coletar a encomenda. O plugin pede essa informação na página de integração e usa o mesmo valor pra todos os pedidos da loja.
Onde configurar
Em WooCommerce → Configurações → Integrações → Melhor Envio:
- Agência Jadlog — select com a lista de agências da JadLog. Por padrão, é filtrada pelo estado do CEP da loja, pra reduzir a lista a algo navegável.
- Agência Latam — select com a lista de agências da Latam.
- CNAE — código de atividade econômica da sua empresa. Obrigatório pra Latam, ignorado pelas demais transportadoras.
Salve. A próxima geração de etiqueta vai usar a agência selecionada.
Atualizar a lista de agências
A lista de agências é puxada do Melhor Envio e fica em cache. Quando o Melhor Envio adiciona ou remove agências, a sua lista local pode ficar defasada. Pra atualizar:
- Vá em WooCommerce → Status → Ferramentas.
- Encontre as ferramentas Atualizar agências JadLog, Atualizar agências Latam e Atualizar agências Loggi.
- Clique na que precisa.
Recarregue a página de integração e o select já deve estar com a lista nova.
A Loggi opera com coleta automática e não tem campo de agência no plugin. Basta ativar o método na zona de envio.
Mudar a agência por pedido
Se você precisa rotear um pedido específico pra uma agência diferente da configurada (galpão diferente, agência mais próxima do destinatário, etc), use o filtro melhor_envio_agency no functions.php do tema ou num plugin auxiliar:
add_filter( 'melhor_envio_agency', function( $agency_id, $order, $company_id ) {
// 2 = JadLog, 6 = Latam, 14 = Loggi
if ( $company_id === 2 && $order->get_shipping_state() === 'SP' ) {
return '12345'; // ID da agência JadLog em SP
}
return $agency_id;
}, 10, 3 );
Veja filtros pra referência completa.
Por que a agência importa
A agência define onde sua encomenda vai ser coletada (ou pra onde você vai postar). A escolha tem dois efeitos práticos:
- Custo logístico interno. Agência mais próxima do galpão = menos deslocamento.
- Velocidade de entrega. Agências em hubs maiores costumam despachar mais rápido.
Vale revisar a escolha quando a loja muda de endereço ou quando o volume cresce a ponto de compensar usar uma agência maior.
Erros comuns
Se a etiqueta JadLog ou Latam falha com mensagem de agência inválida, geralmente é porque a lista cacheada está velha (a agência foi desativada do lado do Melhor Envio). Atualize a lista nas Ferramentas e selecione uma agência ativa.