Dígito verificador EAN-13

Produtos de varejo, linhas de embalagem e sistemas de catálogo quase sempre identificam itens com um código de barras EAN-13 de treze dígitos (também chamado GTIN-13). Doze desses dígitos carregam o prefixo de empresa GS1 e a referência do item; o décimo terceiro é um dígito verificador derivado de uma fórmula de pesos alternados fixos, de modo que um erro de digitação ou uma transposição falhe com bem mais frequência do que parecer outro produto válido. Esta capacidade calcula esse dígito verificador a partir de um número de produto de doze dígitos, ou valida um código de barras completo de treze e informa se o dígito final armazenado coincide com o valor recalculado.

Como o dígito verificador EAN-13 é calculado

A especificação GS1 do EAN-13 (idêntica em estrutura ao GTIN-13) define um dígito verificador determinístico sobre os primeiros doze dígitos. Numere essas posições de dados da esquerda para a direita a partir do índice zero: cada dígito é multiplicado por peso um quando o índice é par e por peso três quando é ímpar; em seguida os doze valores ponderados são somados. O dígito verificador é dez menos essa soma módulo dez, tomado de novo módulo dez, de forma que uma soma já divisível por dez produza dígito verificador zero.

Ao acrescentar esse único dígito obtém-se o código completo de treze dígitos impresso sob as barras e codificado no símbolo. A validação é a operação inversa: recalcule o dígito esperado a partir dos primeiros doze caracteres e compare com o décimo terceiro. *

Como calcular um dígito verificador ou validar um código completo

Envie um campo number que contenha apenas os caracteres de zero a nove. O modo validate espera exatamente treze dígitos. Essa forma facilita mostrar «você digitou X, o esperado era Y» em uma interface de embalagem sem uma segunda requisição.

Strings vazias, number ausente, valores de mode inválidos e comprimentos errados (por exemplo onze ou catorze dígitos) falham antes de qualquer soma ponderada e não são cobrados. Prefira compute ao criar ou completar um código de produto novo; prefira validate quando receber um código de barras completo de um scanner, um CSV ou um feed de fornecedor e precisar de um gate booleano antes de gravar o SKU.

Onde os dígitos verificadores EAN-13 se encaixam em fluxos reais

Marcas e equipes de marca própria recebem um prefixo de empresa GS1 e atribuem referências de item; antes de enviar a arte à impressão precisam acrescentar o dígito verificador correto para que os scanners de varejo aceitem o símbolo na primeira leitura. Armazéns e sistemas 3PL importam CSV de fornecedores com códigos de treze dígitos e devem rejeitar linhas cujo dígito verificador não coincida mais, o que captura edições humanas e bugs de um em geradores anteriores.

Ferramentas de catálogo de e-commerce que permitem ao lojista digitar um EAN podem validar ao sair do campo e bloquear o anúncio até valid ser true, reduzindo envios falhos ao marketplace. Gráficas que montam etiquetas de prateleira a partir de números de produto de doze dígitos chamam o modo compute uma vez por SKU e colocam ean13 sob o gráfico do código de barras.

Não trate um dígito verificador válido como prova de alocação GS1 ou de propriedade de marca — ele só prova que a string de treze dígitos é aritmeticamente correta sob a regra EAN-13, o mesmo critério de honestidade que você aplica a qualquer checksum de varejo.