Cifra di controllo GTIN-14

Questa capacità applica la regola standard mod-10 su un payload di tredici cifre — pesi contati da destra, posizioni dispari per tre e pari per uno — e restituisce la cifra di controllo più la stringa completa di quattordici cifre, oppure convalida un codice a quattordici cifre con un flag valid esplicito e la cifra attesa. Input non numerici e lunghezze errate falliscono con invalid_input invece di un taglio silenzioso, così Lei non memorizza mai un codice di scatolone a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato per l’automazione.

Come si calcola la cifra di controllo GTIN-14

Per calcolarla, prenda le tredici cifre di payload e le percorra da destra a sinistra: moltiplichi la cifra più a destra per tre, la successiva per uno, alternando, poi formi la cifra di controllo come dieci meno quella somma ponderata modulo dieci, di nuovo modulo dieci così che un resto zero produca cifra di controllo zero. Rispetto ai validatori multi-simbologia, l’intento di ricerca qui è stretto: chi serve la calcolatrice della cifra di controllo GTIN-14 per payload di tredici cifre, non un verificatore generico UPC o ISBN.

Contratto di input, modalità e comportamento di errore

Invii un campo number che contenga solo caratteri da zero a nove. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata — tredici per compute, quattordici per validate — così i form client possono mostrare «servono tredici cifre» senza indovinare. Stringhe vuote, number assente e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non sono fatturati. Preferisca compute quando crea o completa GTIN logistici da un indicatore più la base; preferisca validate quando condiziona una scansione di magazzino, una riga ASN o l’import di un file partner a un codice completo a quattordici cifre. Spazi, trattini, lettere e punti decimali sono rifiutati come input non numerico con invalid_input affinché un valore troncato in silenzio non raggiunga mai l’archivio. La modalità compute è il predefinito: il motore richiede esattamente tredici cifre, restituisce check_digit come stringa di un carattere e restituisce with_check come il GTIN-14 a quattordici cifre che Lei può stampare su un’etichetta di scatolone o persistere in un PIM. La modalità validate richiede esattamente quattordici cifre; la risposta indica valid true quando la cifra finale coincide con expected_check_digit ricalcolato, e include sempre payload (le prime tredici cifre), check_digit, expected_check_digit e length quattordici. Alias come digits, gtin e code sono accettati per lo stesso campo payload, così le integrazioni che già parlano di «gtin» non devono rinominare. Poiché il percorso è parse puro senza orologio, sorgente casuale né rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento gratuito del browser e sull’API a $0.002 per richiesta riuscita.

Dove le cifre di controllo GTIN-14 entrano nei flussi reali

I team di magazzino e logistica ricevono numeri interni di scatolone a tredici cifre — indicatore più corpo del GTIN di consumo senza controllo — e devono aggiungere la cifra di controllo GTIN-14 ufficiale prima di stampare etichette ITF-14 o GS1-128 per pallet e cartoni esterni. Le app di ricezione convalidano codici a quattordici cifre al molo così che una sola trasposizione non crei uno SKU di scatolone fantasma né uno scostamento di scorte rispetto all’ASN. I job di qualità dati percorrono ogni colonna GTIN-14 in un catalogo o export EDI, chiamano la modalità validate e mettono in quarantena le righe dove valid è false, catturando sia modifiche umane sia bug di generatori che hanno riempito male un GTIN-13. I form di onboarding e-commerce e marketplace possono ricalcolare expected_check_digit e mostrare una correzione amichevole quando un venditore incolla un GTIN di scatolone con l’ultima cifra sbagliata. Non tratti un GTIN-14 che supera il controllo come prova di proprietà del marchio, correttezza della gerarchia di imballo o registrazione GS1; dimostra solo che la cifra mod-10 è coerente con il payload di tredici cifre sotto i pesi standard GS1.