ForHosting KIT · Strumenti per sviluppatori

Cifra di controllo EAN-13

Inserisca le dodici cifre del prodotto e ottenga la tredicesima: 400638133393 riceve la cifra di controllo 1 e si stampa come 4006381333931. Incolli un EAN-13 completo per scoprire un codice digitato male prima di stampare le etichette o importare il file di un fornitore. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Numero
400638133393
Ottiene
Modalità di calcolo
Compute
Input
400638133393
Cifra di controllo
1
Ean13
4006381333931

I prodotti retail, le linee di confezionamento e i cataloghi identificano quasi sempre ogni articolo con un codice a barre EAN-13 di tredici cifre (detto anche GTIN-13). Dodici di queste cifre portano il prefisso azienda GS1 e il riferimento articolo; la tredicesima è una cifra di controllo derivata da una formula a pesi alternati fissi, così un errore di digitazione o una trasposizione falliscono molto più spesso che assomigliare a un altro prodotto valido. Questa capacità calcola quella cifra di controllo a partire da un numero prodotto di dodici cifre, oppure convalida un codice a barre completo di tredici e indica se la cifra finale memorizzata coincide con il valore ricalcolato.

Come si calcola la cifra di controllo EAN-13

La specifica GS1 dell’EAN-13 (identica in struttura al GTIN-13) definisce una cifra di controllo deterministica sui primi dodici digit. Numeri quelle posizioni dati da sinistra a partire dall’indice zero: ogni cifra viene moltiplicata per peso uno quando l’indice è pari e per peso tre quando è dispari; poi si sommano i dodici valori ponderati. La cifra di controllo è dieci meno quella somma modulo dieci, ripresa di nuovo modulo dieci, così una somma già divisibile per dieci produce cifra di controllo zero.

Aggiungendo quell’unica cifra si ottiene il codice completo di tredici cifre stampato sotto le barre e codificato nel simbolo. La convalida è l’operazione inversa: si ricalcola la cifra attesa dai primi dodici caratteri e la si confronta con la tredicesima. *

Come calcolare una cifra di controllo o convalidare un codice completo

Invii un campo number che contenga solo i caratteri da zero a nove. La modalità validate si aspetta esattamente tredici cifre. Quella forma rende facile mostrare «Lei ha digitato X, atteso Y» in un’interfaccia di packaging senza una seconda richiesta.

Stringhe vuote, number assente, valori di mode non validi e lunghezze errate (ad esempio undici o quattordici cifre) falliscono prima di qualsiasi somma ponderata e non vengono fatturati. Preferisca compute quando crea o completa un nuovo codice prodotto; preferisca validate quando riceve un codice a barre completo da uno scanner, un CSV o un feed fornitore e le serve un gate booleano prima di salvare lo SKU.

Dove le cifre di controllo EAN-13 si inseriscono nei flussi reali

I brand e i team di private label ricevono un prefisso azienda GS1 e assegnano riferimenti articolo; prima di mandare la grafica in stampa devono aggiungere la cifra di controllo corretta affinché gli scanner retail accettino il simbolo al primo passaggio. Magazzini e sistemi 3PL importano CSV di fornitori con codici a tredici cifre e devono rifiutare le righe la cui cifra di controllo non coincide più, intercettando sia modifiche umane sia bug di uno nei generatori a monte.

Gli strumenti di catalogo e-commerce che consentono al commerciante di digitare un EAN possono convalidare alla perdita del focus e bloccare la pubblicazione finché valid non è true, riducendo gli invii falliti al marketplace. Le tipografie che compongono etichette da scaffale a partire da numeri prodotto a dodici cifre chiamano la modalità compute una volta per SKU e collocano ean13 sotto il grafico del codice a barre.

Non tratti una cifra di controllo valida come prova di allocazione GS1 o di proprietà del brand — dimostra solo che la stringa di tredici cifre è aritmeticamente corretta secondo la regola EAN-13, lo stesso criterio di onestà che applica a qualsiasi checksum retail.

Completare un numero prodotto a dodici cifre per la stampa

Prenda il prefisso GS1 più il riferimento articolo (dodici cifre), chiami la modalità compute e stampi ean13 sotto le barre così l’etichetta porta un EAN-13 valido per lo scanner.

Revisionare le colonne GTIN dei fornitori

Convalidi in batch ogni EAN-13 di un CSV partner o di un export ERP e metta in quarantena le righe la cui cifra di controllo non coincide più con il valore atteso ricalcolato.

Cos’è una cifra di controllo EAN-13?

È la tredicesima cifra di un codice a barre retail, calcolata dai primi dodici con pesi GS1 alternati di 1 e 3, così un errore di una sola cifra fa fallire la convalida molto più spesso che assomigliare a un altro prodotto.

Cosa succede con lettere, spazi, trattini o lunghezze errate?

Le attività fallite per convalida non vengono addebitate.

Lo strumento per la cifra di controllo EAN-13 è gratuito?

Lo strumento nel browser è gratuito e gira in locale.

Come si calcola la cifra di controllo EAN-13?

Moltiplichi le dodici cifre alternando 1 e 3, partendo da 1 sulla prima, e sommi i risultati. La cifra di controllo è ciò che manca per arrivare al multiplo di dieci successivo, oppure 0 se la somma lo è già.

Un EAN-13 valido dimostra che il prodotto è registrato?

No. Una cifra di controllo corretta dimostra solo che le tredici cifre sono ben formate secondo la regola EAN-13. Non dice se GS1 ha assegnato quel numero né a chi appartiene il marchio.

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/enc/ean-check

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/enc/ean-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"400638133393"}'
{
  "number": "400638133393"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ean_check",
  "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.

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.

Caratteri non numerici e lunghezze errate vengono rifiutati con un errore invalid_input chiaro, senza eliminare silenziosamente i dati spuri. La esegua gratis nel browser oppure chiami l’API KIT al prezzo pubblicato; entrambi i percorsi usano la stessa aritmetica pura, senza rete e senza memorizzare codici a barre.

Come si calcola la cifra di controllo EAN-13

La stessa regola regge identificatori retail affini come l’UPC-A quando è riempito a zero a sinistra fino a tredici cifre, ma questo strumento si concentra strettamente sul layout dodici più uno dell’EAN-13 affinché l’intento di ricerca e i contratti API restino chiari. Poiché l’algoritmo è aritmetica intera pura a pesi fissi, lo stesso numero prodotto produce sempre la stessa cifra di controllo su ogni piattaforma — browser, Worker o harness di test offline —, ecco perché la capacità è consegnata come motore parse di tier A e non come chiamata a un modello.

Come calcolare una cifra di controllo o convalidare un codice completo

Spazi, trattini, lettere e punti decimali vengono rifiutati come input non numerico con invalid_input, così un modulo non accetta mai un valore ripulito in silenzio. La modalità compute è predefinita: fornisca esattamente dodici cifre prodotto; il motore restituisce check_digit come stringa di un carattere, ean13 come quelle dodici cifre più la di controllo, e length tredici. La risposta riporta valid true quando la cifra finale coincide con l’expected_check_digit ricalcolato, e include sempre payload (le prime dodici cifre), check_digit come inviato, expected_check_digit e l’ean13 canonico costruito da payload più la cifra attesa. Poiché il percorso è parse puro, senza orologio, fonte casuale o rete, lo stesso input produce sempre lo stesso JSON sullo strumento gratuito del browser e sull’API. A $0.002 per richiesta riuscita può proteggere importazioni massive di catalogo, stampanti di etichette e audit di file partner senza negoziare un livello personalizzato.

Dove le cifre di controllo EAN-13 si inseriscono nei flussi reali

Test di integrazione e job di qualità dei dati ricalcolano expected_check_digit per ogni colonna GTIN di un export e mettono in quarantena le discrepanze prima del punto vendita.

Convalidare codici scansionati o digitati in ingresso

Quando uno scanner portatile o un modulo invia tredici cifre, chiami la modalità validate e blocchi aggiornamenti di stock o catalogo se valid è false, mostrando expected_check_digit per correggere un errore di battitura.

Come calcolo una cifra di controllo EAN-13 con questa API?

Esegua un POST con number uguale a esattamente dodici cifre e mode compute (oppure ometta mode). La risposta include check_digit e ean13 (il codice completo di tredici cifre).

Come convalido un codice a barre completo di tredici cifre?

Esegua un POST con la stringa di tredici cifre e mode validate. La risposta include valid, check_digit, expected_check_digit, payload e l’ean13 canonico.

Leggi la documentazione completa del KIT →