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
Esegui gratis nel browser
Esempio risolto
- Numero
- 400638133393
- 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.
Casi d'uso
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.
Domande frequenti
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.
Strumenti correlati
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/enc/ean-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"400638133393"}'const res = await fetch("https://api.kit.forhosting.com/enc/ean-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "400638133393"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/ean-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "400638133393"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/ean-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"400638133393"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"400638133393"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/ean-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"number": "400638133393"
}Esempio di risposta
{
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
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.
Casi di integrazione
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.
Domande tecniche
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.