Validador EAN-13

Propósito e intenção do usuário: a ferramenta valida códigos EAN-13 para qualidade de dados em catálogos de produtos, fluxos ERP e sistemas de inventário. Usuários-alvo incluem engenheiros de dados, gerentes de catálogo e equipes de QA que processam dados de códigos de barras durante a ingestão ou catalogação. Visa detecção precoce de erros, formatação GS1 conforme e processamento confiável a jusante.
Lógica central e recursos: normalização de entradas, imposição de comprimento de 13 dígitos, validação numérica e verificação de checksum modulo-10. Funções obrigatórias: entrada estritamente de 13 dígitos, apenas dígitos, checksum correto. Funções opcionais/avançadas: aceitar separadores, relatar razões de falha detalhadas, e fornecer um resultado legível por máquina para pipelines.
Entradas e saídas: aceita uma única string; a normalização remove espaços ou traços e produz um valor de 13 dígitos. Saídas: booleano de validade, checksum calculada, código normalizado e uma explicação estruturada da validação para auditoria.
Algoritmos e cálculos: checksum usa pesos 1 e 3 nos primeiros 12 dígitos; soma = Σ (dígito(i) × (3 se i for ímpar, senão 1)); checksum = (10 − (soma mod 10)) mod 10.
Erros e casos limites: tratamento de comprimento incorreto, caracteres não numéricos após normalização, zeros à esquerda e desvios de checksum; retorna causas explícitas como erro de comprimento ou checksum inválido.
Indústria/Região e localização: alinhado com padrões GS1/EAN-13; tolera separadores comuns; localização além do formato não é relevante.
Suposições e Exclusões: assume uma única entrada EAN-13; não valida dados do fabricante nem cruza com bases GS1 externas; exclui formatos EAN-13-2, EAN-8 ou não-GS1.