Cifra di controllo GSTIN India

Input non alfanumerici, lunghezze errate e corpi che non rispettano la forma standard stato più PAN falliscono con invalid_input invece di una pulizia silenziosa, così non memorizza mai un ID fiscale a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato.

Come si calcola il carattere di controllo del GSTIN indiano

Le prime due cifre codificano lo stato; i dieci caratteri successivi sono il permanent account number (PAN) del contribuente nello schema familiare di cinque lettere, quattro cifre e una lettera; il tredicesimo carattere distingue entità che condividono lo stesso PAN; il quattordicesimo è tipicamente Z per un’iscrizione ordinaria del contribuente; e il quindicesimo è il carattere di controllo che non deve inventare a mano.

Contratto di input, modalità e comportamento in errore

Invii un campo number che contenga solo caratteri da A a Z e da zero a nove; le minuscole vengono convertite automaticamente in maiuscole. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata—quattordici per compute, quindici per validate—così i form client mostrano un messaggio preciso senza indovinare. Stringhe vuote, number mancante, valori di mode non validi e corpi che falliscono la forma stato più PAN falliscono prima di fidarsi della somma pesata e non vengono fatturati. Preferisca compute quando emette o completa identificativi; preferisca validate quando subordina una ricerca o un import a un GSTIN completo da un utente o da un file partner. Spazi, punti, trattini, barre e altri simboli sono rifiutati come input non alfanumerico con invalid_input affinché un valore troncato in silenzio non raggiunga mai lo storage. La modalità compute è il predefinito: il motore richiede esattamente quattordici caratteri nella forma standard del corpo GSTIN (stato a due cifre, segmento PAN di cinque lettere, quattro cifre e una lettera, poi due caratteri finali di entità e valore predefinito), restituisce check_character come un solo carattere e with_check come il GSTIN di quindici caratteri che può stampare o persistere. La modalità validate richiede esattamente quindici caratteri; la risposta riporta valid true quando il carattere finale coincide con l’expected_check_character ricalcolato e include payload (i primi quattordici), i caratteri dati e attesi, e length quindici. Alias come gstin, code e text sono accettati per lo stesso campo di payload, così le integrazioni che già parlano di «gstin» non devono rinominare. Poiché il percorso è pure parse senza orologio, sorgente casuale né rete, lo stesso corpo JSON produce sempre lo stesso risultato sullo strumento gratuito del browser e sull’API a $0.002 per richiesta riuscita.

Dove le cifre di controllo GSTIN entrano nei flussi reali

I portali di conti da pagare convalidano GSTIN di quindici caratteri all’onboarding fornitori così una sola trasposizione non crea un fornitore fantasma e uno scostamento di pagamento in reverse charge. I job di qualità dati scorrono ogni colonna GSTIN in un export CRM o ERP, chiamano la modalità validate e mettono in quarantena le righe con valid false—catturando sia modifiche umane sia bug dei generatori. Non tratti un controllo GSTIN superato come prova di iscrizione attiva presso l’autorità fiscale o di un regime specifico; dimostra solo che il carattere base-36 è coerente con il corpo di quattordici caratteri sotto i pesi alternati standard. I team finance e anagrafica ricevono corpi interni di quattordici caratteri e devono aggiungere il carattere di controllo ufficiale del GSTIN prima di scrivere l’identificativo su fatture fiscali, payload e-invoice o profili venditore di marketplace che rifiutano numeri GST non validi. I form di iscrizione e-commerce e B2B possono ricalcolare expected_check_character e mostrare una correzione chiara quando un’impresa indiana incolla un numero con l’ultimo carattere errato.