Cifra di controllo UPC-A
Il numero di prodotto 01234567890 riceve la cifra di controllo 5, quindi l'UPC-A completo è 012345678905. Incolli un codice intero di dodici cifre arrivato da un partner o da un lettore per vedere se l'ultima cifra è giusta. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Numero
- 01234567890
- Modalità di calcolo
- Compute
- Input
- 01234567890
- Cifra di controllo
- 5
- Con cifra di controllo
- 012345678905
I numeri di prodotto al dettaglio in Nord America terminano quasi sempre con una cifra di controllo UPC-A: undici cifre di carico che identificano il produttore e l'articolo, più una cifra finale che dimostra che l'intera stringa è stata digitata o scansionata senza un errore di una sola cifra. Questa capacità implementa la regola standard GTIN-12 mod-10 usata su ogni UPC-A a dodici cifre: le posizioni dispari da sinistra sono ponderate per tre, le pari per uno, e la cifra di controllo è l'importo necessario per raggiungere il multiplo di dieci successivo. Usi la modalità compute quando dispone solo del numero di prodotto a undici cifre e le serve la cifra per un'etichetta, un database o un generatore di codici a barre; usi la modalità validate quando un partner, uno scanner o un modulo invia un codice completo a dodici cifre e le serve un flag valid chiaro più la cifra attesa per i messaggi di errore.
Come si calcola la cifra di controllo UPC-A
Un codice UPC-A ha sempre dodici cifre. Le prime undici formano il numero di prodotto (spesso un prefisso azienda GS1 più un riferimento articolo); la dodicesima è la cifra di controllo. Per calcolarla, scorri le undici cifre di carico da sinistra a destra con posizioni basate su 1: moltiplichi ogni cifra in posizione dispari per tre e ogni cifra in posizione pari per uno, sommi quei prodotti e prenda la cifra di controllo come (10 meno quella somma modulo 10) modulo 10.
In modo equivalente, la stringa completa di dodici cifre inclusa la di controllo deve avere una somma ponderata multipla di dieci sotto gli stessi pesi di posizione. È la stessa famiglia di regole mod-10 usata per GTIN-8, GTIN-12, GTIN-13 e GTIN-14; l'UPC-A è specificamente la forma a dodici cifre comune sugli imballaggi di USA e Canada. L'algoritmo è deterministico e locale: nessuna consultazione di catalogo, nessuna chiamata di rete e nessun orologio.
Rispetto ai validatori multi-simbologia, l'intento di ricerca qui è stretto: chi ha bisogno del calcolatore di cifra di controllo UPC-A per carichi a undici cifre, non di un verificatore generale EAN o ISBN.
Dove le cifre di controllo UPC-A entrano nei flussi reali
I team di catalogo e PIM ricevono numeri di prodotto interni a undici cifre e devono aggiungere la cifra di controllo UPC-A ufficiale prima di stampare etichette da scaffale o pubblicare su marketplace che rifiutano GTIN non validi. Scanner di magazzino e app di ricezione convalidano codici a dodici cifre al molo affinché una sola trasposizione non crei uno SKU fantasma né uno scostamento di stock.
I job di qualità dei dati scorrono ogni colonna UPC in un export CSV, chiamano la modalità validate e mettono in quarantena le righe in cui valid è false, catturando sia modifiche umane sia bug dei generatori. Non tratti un UPC-A che passa il controllo come prova di proprietà del marchio o di registrazione GS1; dimostra solo che la cifra mod-10 è coerente con il carico sotto i pesi standard.
Casi d'uso
Revisionare colonne UPC negli export di catalogo
Convalidi in batch ogni UPC a dodici cifre in un CSV di PIM o partner e metta in quarantena le righe la cui cifra di controllo non coincide più con il valore atteso ricalcolato.
Domande frequenti
Che cos'è una cifra di controllo UPC-A?
È la dodicesima cifra di un codice UPC-A, calcolata con una somma ponderata mod-10 affinché gli errori di una sola cifra in digitazione o scansione siano di solito rilevati prima di archiviare o stampare il codice.
Cosa succede con lunghezza errata, lettere o trattini?
Le attività di validazione fallite non vengono addebitate.
Lo strumento per la cifra di controllo UPC-A è gratuito?
Lo strumento nel browser è gratuito e gira in locale.
Come si calcola la cifra di controllo UPC-A?
Leggendo le undici cifre da sinistra, moltiplichi per 3 quelle in posizione dispari e per 1 quelle in posizione pari, poi sommi tutto. La cifra di controllo è ciò che porta la somma al multiplo di dieci successivo, oppure 0 se lo è già.
Un UPC-A è la stessa cosa di un EAN-13?
Appartengono alla stessa famiglia di regole di controllo, ma l'UPC-A è la forma a dodici cifre, detta anche GTIN-12, diffusa sulle confezioni negli Stati Uniti e in Canada. Questo strumento tratta solo quella forma, non EAN-13 né ISBN.
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/upc-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"01234567890"}'const res = await fetch("https://api.kit.forhosting.com/enc/upc-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "01234567890"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/upc-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "01234567890"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/upc-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"01234567890"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"01234567890"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/upc-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": "01234567890"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.upc_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
Input non numerici e lunghezze errate falliscono con invalid_input invece di una pulizia silenziosa, così non archivia mai un codice a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato.
Contratto di input, modalità e comportamento di errore
Invii un campo number che contenga solo i caratteri da zero a nove. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata — undici per compute, dodici per validate — così i moduli client possono mostrare «servono undici cifre» senza indovinare. Stringhe vuote, number mancante e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non vengono addebitati. Preferisca compute quando crea o completa numeri di prodotto; preferisca validate quando condiziona una ricerca o un import a un codice completo da un utente o un file partner. Spazi, trattini, lettere e punti decimali sono rifiutati come input non numerico con invalid_input affinché un valore silenziosamente spogliato non raggiunga mai l'archiviazione. La modalità compute è quella predefinita: il motore richiede esattamente undici cifre, restituisce check_digit come stringa di un carattere e restituisce with_check come l'UPC-A a dodici cifre che può stampare o persistere. La modalità validate richiede esattamente dodici cifre; la risposta riporta valid true quando la cifra finale corrisponde all'expected_check_digit ricalcolato, e include sempre payload (le prime undici cifre), check_digit, expected_check_digit e length dodici. Alias come digits, upc e code sono accettati per lo stesso campo di carico, così le integrazioni che già parlano di «upc» non devono rinominare. Poiché il percorso è parse puro senza orologio, sorgente casuale o 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 UPC-A entrano nei flussi reali
I moduli di onboarding e-commerce possono ricalcolare expected_check_digit e mostrare una correzione chiara quando un venditore incolla un codice con l'ultima cifra errata. In ogni flusso il contratto è lo stesso: solo cifre, lunghezza fissa per modalità, JSON strutturato che può testare con goldens, comportamento identico browser gratuito e API prepagata, e invalid_input onesto quando la stringa non è una sequenza pura di cifre della lunghezza corretta.
Casi di integrazione
Completare un numero di prodotto a 11 cifre per le etichette
Chiami la modalità compute con il carico a undici cifre, memorizzi with_check e invii l'UPC-A a dodici cifre alla stampante di codici a barre o all'inserzione sul marketplace.
Convalidare UPC-A scansionati o digitati in ingresso
Quando uno scanner o un modulo invia dodici cifre, chiami la modalità validate e blocchi la ricerca se valid è false, mostrando expected_check_digit per correggere un solo refuso.
Domande tecniche
Come calcola una cifra di controllo UPC-A con questa API?
POST con number impostato a esattamente undici cifre e mode compute (o ometta mode). La risposta include check_digit e with_check (l'UPC-A completo a dodici cifre).
Come convalida un UPC-A completo a dodici cifre?
POST con la stringa a dodici cifre e mode validate. La risposta include valid, check_digit, expected_check_digit e payload (cifre senza l'ultima).