Validatore EAN-13

Scopo e intento utente: lo strumento convalida i codici EAN-13 per la qualità dei dati in cataloghi di prodotto, feed ERP e sistemi di inventario. Gli utenti mirati sono data engineer, responsabili di catalogo e team QA che elaborano dati di codici a barre durante l'ingestione o la catalogazione. Mira alla rilevazione precoce degli errori, al formato GS1 conforme e a un'elaborazione affidabile a valle.
Logica centrale e funzionalità: normalizzazione degli input, imposizione di una lunghezza di 13 cifre, validazione numerica e verifica della checksum modulo-10. Funzioni obbligatorie: input rigorosamente a 13 cifre, solo cifre, checksum corretto.Funzioni opzionali/ avanzate: accettare separatori, riportare motivi di errore dettagliati e fornire un risultato leggibile da macchina per pipeline.
Ingressi e uscite: accetta una singola stringa; la normalizzazione rimuove spazi o trattini e restituisce un valore a 13 cifre. Uscite: booleano di validità, checksum calcolata, codice normalizzato e una descrizione strutturata della validazione per audit.
Algoritmi e calcoli: checksum utilizza pesi 1 e 3 sui primi 12 cifre; somma = Σ (cifra(i) × (3 se i è dispari, altrimenti 1)); checksum = (10 − (somma mod 10)) mod 10.
Errori e casi limite: gestione di lunghezza errata, caratteri non numerici dopo la normalizzazione, zeri iniziali e deviazioni di checksum; restituisce motivi espliciti come errore di lunghezza o checksum non valido.
Industria/Regione e localizzazione: allinea agli standard GS1/EAN-13; tollera separatori comuni; localizzazione oltre al formato non è rilevante.
Assunzioni ed esclusioni: presuppone un solo input EAN-13; non valida dati del produttore o confronti con database GS1 esterni; esclude formati EAN-13-2, EAN-8 o non-GS1.