Código de Rastreamento Postal
Confira códigos de rastreamento dos Correios com JavaScript.
Código no formato XX000000000BR (ex.: Sedex, carta registrada) — 13 caracteres. Esta página documenta a API de funções soltas (isTrackingCode, fake...) da versão 1.x da validation-br, biblioteca JavaScript para Node.js e navegador. As funções abaixo cobrem validação, normalização e criação de códigos fake para testes. Para projetos novos, veja a versão 2.0, com API orientada a classes.
Exemplos (API)
// Importação direta
import { isPostalCode } from 'validation-br';
isPostalCode('XF892043372BR'); // -> true
// Importação de submódulo
import { validate, validateOrFail, mask, normalize, fake, dv } from 'validation-br/dist/postalCode';
validate('XF892043372BR'); // -> true
validateOrFail('XF892043372BR'); // -> true (lança ValidationBRError se inválido)
normalize('xf892043372br'); // -> 'XF892043372BR'
fake(); // -> código fake válido (não recebe parâmetro de máscara)
// dv() recebe os 8 dígitos numéricos centrais
dv('89204337'); // -> '2'
mask()é apenas um alias denormalize(): o código não tem separadores, só normaliza para maiúsculas.
Como o cálculo é feito
O código tem 13 caracteres: 2 letras identificando o tipo do objeto, 8 dígitos sequenciais, 1 dígito verificador (DV) e 2 letras do país de origem (BR).
Se o resto da divisão por 11 for 0, o DV é
5; se for 1, o DV é0.