Validador de Código de Rastreio

Como funciona o código de rastreio?

Os Correios usam o padrão AA123456789BR, com 13 caracteres no total: 2 letras de prefixo do serviço (por exemplo, BR para PAC, JT para Sedex), 9 dígitos para o número da etiqueta e 2 letras finais com o código do país, em geral BR.

Aqui validamos só o formato; não há consulta de status na API dos Correios. Se quiser acompanhar a entrega de fato, recorra ao site oficial dos Correios.

Tudo é checado no próprio navegador.

UPU S10: o padrao universal por tras dos codigos de rastreio

Todo codigo de rastreio dos Correios segue o UPU S10, padrao publicado pela Uniao Postal Universal (Berna, Suica) e adotado pelos 192 paises membros. O formato e rigoroso: LL 9 digitos LL — duas letras identificando o servico, nove digitos (oito seriais + um verificador) e duas letras para o pais de destino segundo ISO 3166-1 alpha-2 (BR para Brasil, US para Estados Unidos, DE para Alemanha).

O proposito do S10 e interoperabilidade: um unico numero precisa funcionar entre Correios, USPS, Royal Mail, Deutsche Post e Japan Post. Sem ele, cada repasse alfandegario e cada ultima milha exigiria digitacao manual. O S10 tambem define o codigo de barras (Code 128), o layout legivel impresso na etiqueta e a posicao obrigatoria do digito verificador.

O algoritmo do digito verificador (mod-11)

O 8 digito do bloco numerico e o verificador, calculado a partir dos 7 anteriores por um esquema ponderado mod-11. Os pesos, aplicados em ordem, sao 8, 6, 4, 2, 3, 5, 9, 7. Procedimento:

• Multiplique cada um dos 7 primeiros digitos pelo peso correspondente.
• Some os produtos e calcule soma mod 11.
• Subtraia de 11. Se o resultado for 10, o DV e 0; se for 11, e 5; caso contrario, e a propria subtracao.

codigo = "LB 4 7 8 5 8 6 1 _ BR"
digitos= [4, 7, 8, 5, 8, 6, 1]
pesos  = [8, 6, 4, 2, 3, 5, 9]
soma   = 32+42+32+10+24+30+9 = 179
179 mod 11 = 3
11 - 3 = 8  -> DV = 8

Principais prefixos de servico dos Correios

• LB: carta simples internacional.
• PJ: EMS internacional / Sedex Mundi.
• RA, RB, RL: carta registrada nacional.
• JT, JU: Sedex nacional (expresso).
• AR: aviso de recebimento (servico adicional).
• DU: debito automatico (cobranca).

O Sedex 12 normalmente usa o prefixo JT e o PAC tende a usar OE ou OY. Conhecer o prefixo permite ao CRM direcionar o pedido para a fila certa de SLA sem precisar varrer a pagina de tracking.

Casos de uso reais

Plataformas de e-commerce (Magazine Luiza, Americanas, Mercado Livre) validam o codigo no momento em que a etiqueta e impressa, antes de salva-lo na pagina do pedido. Isso impede que um erro de digitacao gere horas de chamado "codigo nao encontrado". Ferramentas de CRM como Octadesk ou Zendesk usam o mesmo validador no bot: se o cliente cola um codigo malformado, a resposta vem imediata, sem abrir ticket.

APIs agregadoras e o cenario pos-SRO

A API publica SRO (Sistema de Rastreamento de Objetos) dos Correios foi descontinuada e substituida por um canal corporativo pago que requer contrato. As alternativas pragmaticas sao:

• 17track.net: agregador multi-transportadora (Correios, Loggi, FedEx, DHL, USPS, China Post). Free tier + API paga.
• BrasilAPI: endpoint comunitario que faz scraping do tracker web dos Correios. Best-effort, nao serve para SLA.
• Melhor Envio: marketplace de fretes brasileiro com webhook unificado.
• Frenet, Kangu: APIs de frete enterprise com tracking lado transportadora.

As concorrentes de ultima milha — Loggi, Total Express, Mercado Envios, J&T Express, Jadlog — usam formatos proprios e nao estao vinculadas ao UPU S10. Validar codigos dessas redes exige regex por transportadora ou tabela de lookup tipo BIN.

FAQ

AR e um codigo de rastreio independente? Nao. O AR (aviso de recebimento) e um servico adicional sobre uma carta registrada; o AR em si nao e rastreavel sozinho. Ele apenas sinaliza que um comprovante assinado deve retornar ao remetente.

Existe uma ferramenta unica que rastreia todas as transportadoras? Em escala, nao. O 17track.net e similares chegam perto, mas dependem de scraping em varias redes brasileiras de ultima milha, entao a confiabilidade varia. Para tracking critico, integre cada transportadora diretamente.

Prefixo JT significa sempre Sedex 12? Em geral sim — JT e JU mapeiam para servicos Sedex expressos. O SLA (Sedex 10, 12, hoje) e definido no contrato e aparece nos eventos de tracking, nao no prefixo.

Como rastrear encomenda internacional que chega ao Brasil? Use o codigo original do remetente no 17track ou no Correios Rastreio Internacional. Quando o objeto entra no Brasil, a Receita Federal pode reter para processo de importacao formal; os eventos refletirao "Aguardando pagamento" ou "Tributado".

O sufixo do pais e sempre BR? Apenas para objetos postados a partir do Brasil. Um codigo terminado em US, CN ou DE tambem passa no S10, mas identifica a autoridade postal de origem, nao os Correios.