A matemática do Código de Barras (EAN-13 / GTIN): Como funciona o algoritmo Módulo 10 da GS1
Qualquer produto que você compra no supermercado, na farmácia ou em marketplaces como Amazon, Mercado Livre e Shopee possui uma sequência de 13 dígitos impressa abaixo de barras pretas e brancas: é o EAN-13 (conhecido internacionalmente como GTIN-13).
E para quem programa ERPs, e-commerces ou emissão de notas fiscais (NF-e modelo 55 e NFC-e modelo 65), validar esse código é obrigatório: a SEFAZ rejeita notas fiscais caso o campo <cEAN> contenha um código de barras com dígito verificador inválido.
Abaixo está a explicação exata de como a matemática do algoritmo Módulo 10 ponderado pela GS1 funciona e como implementá-lo em código limpo.
1. A Estrutura dos 13 Dígitos
Um código EAN-13 é dividido em quatro partes:
7 8 9 1 2 3 4 5 6 7 8 9 [D]
│─────││─────────││─────────│ │─│
▲ ▲ ▲ ▲
│ │ │ └─ 13º dígito: Dígito Verificador (DV)
│ │ └───────── Código do Produto (definido pela empresa)
│ └──────────────────── Prefixo da Empresa (licenciado pela GS1)
└───────────────────────────── Prefixo do País (789 e 790 = Brasil)
Os 12 primeiros dígitos identificam a origem e o item. O 13º dígito é puramente matemático e serve para garantir que o leitor a laser do caixa ou o scanner não leu nenhuma barra errada.
2. A Matemática do Cálculo (Módulo 10)
O cálculo do dígito verificador segue uma regra de multiplicação alternada por 1 e 3, da esquerda para a direita (posições ímpares multiplicadas por 1, posições pares multiplicadas por 3):
Passo a Passo:
- Pegue os 12 primeiros dígitos.
- Multiplique os dígitos nas posições ímpares (1ª, 3ª, 5ª, 7ª, 9ª, 11ª) por 1.
- Multiplique os dígitos nas posições pares (2ª, 4ª, 6ª, 8ª, 10ª, 12ª) por 3.
- Some todos os resultados das multiplicações.
- Calcule o resto da divisão dessa soma por 10 ().
- O Dígito Verificador:
- Se o resto for
0, o dígito verificador é0. - Se o resto for maior que zero, o dígito verificador é
10 - resto.
- Se o resto for
3. Exemplo Prático Manual
Vamos calcular o dígito para o código fictício 789123456789:
| Posição | Dígito | Peso | Multiplicação |
|---|---|---|---|
| 1ª | 7 | × 1 | 7 |
| 2ª | 8 | × 3 | 24 |
| 3ª | 9 | × 1 | 9 |
| 4ª | 1 | × 3 | 3 |
| 5ª | 2 | × 1 | 2 |
| 6ª | 3 | × 3 | 9 |
| 7ª | 4 | × 1 | 4 |
| 8ª | 5 | × 3 | 15 |
| 9ª | 6 | × 1 | 6 |
| 10ª | 7 | × 3 | 21 |
| 11ª | 8 | × 1 | 8 |
| 12ª | 9 | × 3 | 27 |
- Soma total:
- Resto por 10:
- Dígito Verificador (DV):
O código EAN-13 completo e válido é 7891234567895.
4. Implementação em JavaScript / TypeScript
/**
* Calcula o 13º dígito verificador a partir dos 12 primeiros dígitos do EAN
*/
function calcularDVEan13(primeiros12) {
if (!/^\d{12}$/.test(primeiros12)) return null;
let soma = 0;
for (let i = 0; i < 12; i++) {
const digito = parseInt(primeiros12[i], 10);
// Posições ímpares (índice par 0, 2, 4...) peso 1; pares (índice ímpar 1, 3, 5...) peso 3
soma += (i % 2 === 0) ? digito * 1 : digito * 3;
}
const resto = soma % 10;
return resto === 0 ? 0 : 10 - resto;
}
/**
* Valida se um código EAN-13 de 13 dígitos é matematicamente legítimo
*/
function validarEan13(ean) {
if (!/^\d{13}$/.test(ean)) return false;
const dvEsperado = calcularDVEan13(ean.slice(0, 12));
const dvInformado = parseInt(ean[12], 10);
return dvEsperado === dvInformado;
}
// Testes
console.log(validarEan13("7891234567895")); // true
console.log(validarEan13("7891234567890")); // false (DV errado)
5. Implementação em Python
def calcular_dv_ean13(primeiros_12: str) -> int:
if len(primeiros_12) != 12 or not primeiros_12.isdigit():
raise ValueError("São necessários exatamente 12 dígitos numéricos.")
soma = sum(int(d) * (1 if i % 2 == 0 else 3) for i, d in enumerate(primeiros_12))
resto = soma % 10
return 0 if resto == 0 else 10 - resto
def validar_ean13(ean: str) -> bool:
if len(ean) != 13 or not ean.isdigit():
return False
return int(ean[12]) == calcular_dv_ean13(ean[:12])
Vocês já precisaram gerar códigos de barras em lote para cadastros ou validar regras da GS1 nas notas fiscais de vocês?
Gerador e validador de códigos de barras EAN-13 em lote: tecmestre.com.br/gerador-de-codigo-de-barras-ean-13/