ForHosting KIT · Finanza e denaro

Cifra di controllo GTIN

Inserisca le cifre iniziali 629104150021 e ottenga la cifra di controllo 3 e il codice completo 6291041500213, un GTIN-13. Intercetti un codice prodotto digitato male prima che finisca su un'etichetta, presso un rivenditore o in un marketplace. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Cifre
629104150021
Ottiene
Cifra di controllo
3
GTIN
6291041500213
Lunghezza dei dati
12
Lunghezza del GTIN
13

Un Global Trade Item Number (GTIN) è l’identificatore GS1 stampato come codice a barre EAN, UPC o ITF su pack di consumo, pack interni e unità logistiche. L’ultimo carattere è una cifra di controllo calcolata dalle cifre iniziali, così un errore di battitura o una sostituzione dello scanner viene di solito rifiutato prima che il codice sia memorizzato, stampato o inviato a un marketplace. La cifra di controllo è il valore che rende tale somma un multiplo di dieci.

Come si calcola la cifra di controllo GS1 di un GTIN

Un GTIN termina sempre con una sola cifra di controllo che il marchio non sceglie: è una funzione pura delle cifre iniziali che la precedono. Parta da destra delle cifre iniziali. Sommi i prodotti ponderati per ottenere la somma ponderata.

La cifra di controllo è dieci meno tale somma modulo dieci, con un secondo modulo dieci così un resto zero produce la cifra zero e non dieci. Non è l’algoritmo di Luhn delle carte di pagamento: Luhn raddoppia ogni seconda cifra da destra e spezza i prodotti maggiori di nove, mentre GS1 usa un peso stretto di tre o uno e non spezza mai. Il calcolo è locale e deterministico: nessuna chiamata al registro GS1, nessuna rete e nessuno orologio.

Dove una calcolatrice della cifra di controllo GTIN rende

I team di catalogo e PIM ricevono stringhe di prefisso aziendale più riferimento articolo dai sistemi SKU interni e devono aggiungere la cifra di controllo GS1 ufficiale prima di pubblicare il codice a un rivenditore, un marketplace o un’etichetta di spedizione. Le app di ricevimento al dettaglio ricalcolano la cifra di controllo dalle cifre iniziali di un GTIN scansionato così una sola trasposizione non crea uno SKU fantasma né uno scostamento di scorte rispetto all’avviso di spedizione anticipato.

I moduli di onboarding e-commerce possono mostrare la cifra di controllo attesa accanto a un campo di incolla e bloccare l’invio quando il carattere finale digitato dal venditore non coincide, il che costa meno di un rifiuto successivo dell’inserzione. I lavori di qualità dei dati percorrono ogni colonna GTIN di un export di catalogo, tolgono l’ultimo carattere, ricalcolano e mettono in quarantena le righe la cui cifra memorizzata non coincide più, catturando sia le modifiche umane sia i bug di generatori che hanno riempito la famiglia con la lunghezza sbagliata.

Rispetto a un validatore solo GTIN-14 o a un verificatore multi-symbologia, l’intento di ricerca qui è la frase generica che le persone digitano: una cifra di controllo GTIN dalle cifre iniziali, non una modalità logistica a quattordici cifre né un percorso specifico ISBN.

Individuare GTIN digitati male in ricevimento o onboarding

Ricalcoli la cifra di controllo dalle cifre iniziali di un GTIN scansionato o incollato e blocchi lo stoccaggio o l’inserzione quando il carattere finale non coincide.

Verificare le colonne GTIN in cataloghi ed export EDI

Tolga l’ultimo carattere di ogni GTIN memorizzato, ricalcoli con questa calcolatrice e metta in quarantena le righe la cui cifra di controllo non coincide più con la somma ponderata GS1.

Che cos’è una cifra di controllo GTIN?

È l’ultima cifra di un Global Trade Item Number, calcolata con una somma ponderata alternata GS1 modulo 10 così gli errori di una sola cifra in battitura o scansione vengono di solito intercettati prima di memorizzare o stampare il codice.

Quali lunghezze di GTIN sono supportate?

La stessa regola GS1 copre GTIN-8, GTIN-12, GTIN-13 e GTIN-14.

Che succede se l’ingresso contiene lettere, spazi o trattini?

Il motore non ritaglia mai la punteggiatura in silenzio, così un incolla con trattini non può diventare un codice prodotto errato. La convalida fallita non è fatturata.

La calcolatrice della cifra di controllo GTIN è gratuita?

Lo strumento del browser è gratuito e gira in locale.

Come verifico un GTIN che ho già?

Tolga l'ultima cifra, inserisca il resto e confronti la cifra di controllo ottenuta con quella stampata. Se non coincidono, il codice è stato digitato o letto male. Un codice corretto supera anche la prova completa: pesando tutte le cifre per tre e uno da destra, la somma è multipla di dieci.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/fin/gtin-check-digit

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/fin/gtin-check-digit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"digits":"629104150021"}'
{
  "digits": "629104150021"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.gtin_check_digit",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_digits32
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Questa calcolatrice della cifra di controllo GTIN applica la regola ufficiale GS1 modulo 10: una somma ponderata alternata contata da destra del payload, con la cifra iniziale più a destra moltiplicata per tre e i pesi uno e tre verso sinistra. Invii le cifre iniziali di un GTIN-8, GTIN-12, GTIN-13 o GTIN-14 — senza la cifra di controllo — e la risposta restituisce la cifra di controllo, il GTIN completo, la somma ponderata e la famiglia quando la lunghezza del payload è standard. Qualsiasi carattere non cifra fallisce con invalid_input invece di un ritaglio silenzioso, così un incolla con trattini non diventa mai un codice prodotto errato. La stessa aritmetica pura alimenta lo strumento gratuito del browser e il percorso API prepagato.

Come si calcola la cifra di controllo GS1 di un GTIN

GS1 usa una stessa regola modulo 10 per GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN-13) e GTIN-14, per questo questa calcolatrice può completare ciascuna di quelle famiglie dal solo payload. Moltiplichi la cifra più a destra del payload per tre, la successiva a sinistra per uno, la successiva per tre, e continui ad alternare finché ogni cifra iniziale ha un peso. Dopo aver aggiunto la cifra di controllo, lo stesso schema tre-uno da destra a sinistra applicato al codice completo produce un multiplo di dieci: è il test di accettazione che uno scanner o un sistema di magazzino deve applicare. Le lunghezze tipiche del payload sono sette cifre per GTIN-8, undici per GTIN-12, dodici per GTIN-13 e tredici per GTIN-14, e tali lunghezze sono etichettate nel campo family quando coincidono.

Contratto di ingresso, forma della risposta ed errori

Una stringa vuota o un campo assente fallisce anche prima di qualsiasi somma ponderata. L’esempio predefinito 629104150021 è un corpo GTIN-13 di dodici cifre la cui cifra di controllo è tre, così gtin diventa 6291041500213. La convalida fallita non è fatturata. Invii in POST un corpo JSON con digits pari alle sole cifre iniziali del GTIN: non includa la cifra di controllo che desidera calcolare. Il campo deve essere una stringa di caratteri da zero a nove; gli alias number, text, gtin, code e payload sono accettati così le integrazioni che già usano quei nomi non devono rinominare. Gli zeri iniziali contano (un corpo UPC-A spesso inizia con zero), quindi invii una stringa JSON e non un numero JSON se il payload può iniziare con zero. Spazi, trattini, lettere e punteggiatura sono caratteri non cifra e falliscono con invalid_input indicando il campo digits, invece di essere ritagliati in silenzio. In caso di successo il corpo riecheggia digits, restituisce check_digit come stringa di un carattere da zero a nove, restituisce gtin come identificatore completo (payload più cifra di controllo), riporta payload_length e gtin_length, include weighted_sum per le piste di audit e imposta algorithm a gs1-mod-10. Quando la lunghezza del payload è sette, undici, dodici o tredici, family è GTIN-8, GTIN-12, GTIN-13 o GTIN-14 rispettivamente; altre lunghezze omettono family invece di inventare un nome. Poiché il percorso è parse puro senza orologio, casualità 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. Conservi le richieste in una stringa breve di cifre; questo endpoint calcola una cifra di controllo, non cerca prodotti né disegna barre.

Dove una calcolatrice della cifra di controllo GTIN rende

Le tipografie che emettono simboli EAN-13, UPC-A o ITF-14 fissano gtin nei test affinché la libreria di codici a barre e questa API non divergano. In ogni flusso il contratto è lo stesso: solo cifre, JSON strutturato che Lei può testare con goldens, comportamento identico tra browser gratuito e API prepagata, e invalid_input onesto quando la stringa contiene un carattere non cifra. Non tratti una cifra di controllo corretta come prova di titolarità del marchio o di registrazione GS1; dimostra soltanto che la cifra mod-10 è coerente con il payload sotto i pesi GS1 standard.

Completare un GTIN per etichette e inserzioni

Invii le cifre iniziali del payload, memorizzi check_digit e gtin e alimenti l’identificatore completo in una stampante di etichette EAN-13, UPC-A o ITF-14 o in un modulo di inserzione su un marketplace.

Come si calcola una cifra di controllo GTIN con questa API?

Invii un POST con digits pari al solo payload iniziale (senza cifra di controllo). Le lunghezze tipiche sono 7, 11, 12 o 13. La risposta include check_digit e gtin (l’identificatore completo).

Leggi la documentazione completa del KIT →