1

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:

  1. Pegue os 12 primeiros dígitos.
  2. Multiplique os dígitos nas posições ímpares (1ª, 3ª, 5ª, 7ª, 9ª, 11ª) por 1.
  3. Multiplique os dígitos nas posições pares (2ª, 4ª, 6ª, 8ª, 10ª, 12ª) por 3.
  4. Some todos os resultados das multiplicações.
  5. Calcule o resto da divisão dessa soma por 10 (Soma(mod10)\text{Soma} \pmod{10}).
  6. 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.

3. Exemplo Prático Manual

Vamos calcular o dígito para o código fictício 789123456789:

PosiçãoDígitoPesoMultiplicação
1ª7× 17
2ª8× 324
3ª9× 19
4ª1× 33
5ª2× 12
6ª3× 39
7ª4× 14
8ª5× 315
9ª6× 16
10ª7× 321
11ª8× 18
12ª9× 327
  • Soma total: 7+24+9+3+2+9+4+15+6+21+8+27=1157 + 24 + 9 + 3 + 2 + 9 + 4 + 15 + 6 + 21 + 8 + 27 = \mathbf{115}
  • Resto por 10: 115(mod10)=5115 \pmod{10} = \mathbf{5}
  • Dígito Verificador (DV): 10−5=510 - 5 = \mathbf{5}

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/

Carregando publicação patrocinada...