Cifra di controllo ISBN-13

Questa capacità applica la regola standard ISBN-13 mod-10 su un payload di dodici cifre — pesi alternati uno e tre da sinistra — e restituisce la cifra di controllo più il codice a barre completo a tredici cifre, oppure convalida una stringa di tredici cifre con un indicatore valid esplicito e la cifra attesa. Input non numerico e lunghezze errate falliscono con invalid_input invece di una pulizia silenziosa, così Lei non archivia mai un ISBN a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato per le pipeline di automazione.

Come si calcola la cifra di controllo ISBN-13

Le prime dodici cifre formano il payload del numero del libro: un prefisso GS1 a tre cifre (quasi sempre 978 o 979 per i libri), un elemento di gruppo di registrazione, un elemento registrante (editore) e un elemento di pubblicazione le cui lunghezze variano secondo le regole dell’agenzia. Per calcolarla, scorra le dodici cifre del payload da sinistra a destra con posizioni base 1: moltiplichi ogni cifra in posizione dispari per uno e ogni cifra in posizione pari per tre, sommi quei prodotti, poi prenda la cifra di controllo come dieci meno quella somma modulo dieci, di nuovo modulo dieci così un resto zero produce cifra di controllo zero. Rispetto ai validatori multi-simbologia, l’intento di ricerca qui è stretto: chi ha bisogno del calcolatore di cifra di controllo ISBN-13 per payload di dodici cifre, non di un verificatore generale UPC o GTIN di cassa.

Contratto di input, modalità e comportamento degli errori

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 — dodici per compute, tredici per validate — così i moduli client possono mostrare «servono dodici cifre» senza indovinare. Stringhe vuote, number assente e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non vengono fatturati. Preferisca compute quando crea o completa numeri di libro da un corpo di dodici cifre; preferisca validate quando subordina un’importazione di catalogo, una scansione POS o un annuncio marketplace a un codice a barre ISBN-13 completo a tredici cifre. Spazi, trattini, lettere e punti decimali sono respinti come input non numerico con invalid_input affinché un valore ripulito in silenzio non raggiunga mai lo storage — se incolla 978-0-306-40615 senza la cifra di controllo, deve prima togliere i trattini lato client oppure inviare la forma solo cifre. La modalità compute è il predefinito: il motore richiede esattamente dodici cifre, restituisce check_digit come stringa di un carattere e restituisce with_check come l’ISBN-13 a tredici cifre che Lei può stampare su un codice a barre o persistere in un catalogo. La modalità validate richiede esattamente tredici cifre; la risposta indica valid true quando la cifra finale coincide con l’expected_check_digit ricalcolato, e include sempre payload (le prime dodici cifre), check_digit, expected_check_digit e length tredici. Alias come digits, isbn e code sono accettati per lo stesso campo di payload così le integrazioni che già parlano di «isbn» non devono rinominare. Poiché il percorso è parse puro senza orologio, fonte 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 ISBN-13 si inseriscono nei flussi reali

Editori e team di catalogo ricevono numeri interni di libro a dodici cifre — prefisso più gruppo di registrazione, registrante e titolo — e devono aggiungere la cifra di controllo ISBN-13 ufficiale prima di stampare codici a barre EAN-13 su copertine, sovraccoperte o adesivi. Le app POS di libreria e di ricezione convalidano codici a tredici cifre al bancone affinché una sola trasposizione non crei un titolo fantasma né uno scostamento di magazzino. I job di qualità dati di biblioteche e aggregatori percorrono ogni colonna ISBN-13 in un export MARC, ONIX o CSV, chiamano la modalità validate e mettono in quarantena le righe dove valid è false — catturando sia modifiche umane sia bug di generatori che emettono ancora ISBN-10 legacy senza conversione corretta. I moduli di onboarding e-commerce e marketplace possono ricalcolare expected_check_digit e mostrare una correzione amichevole quando un venditore incolla un ISBN con l’ultima cifra digitata male. Non tratti un ISBN-13 che supera il controllo come prova di proprietà del titolo, di registrazione presso l’agenzia o di gruppi di trattini corretti; dimostra solo che la cifra mod-10 è coerente con il payload di dodici cifre secondo i pesi standard ISBN-13.