Indien-GSTIN-Prüfzeichen

Nicht alphanumerische Eingaben, falsche Längen und Rümpfe, die der Standardform Staat plus PAN nicht entsprechen, scheitern mit invalid_input statt stiller Bereinigung, sodass Sie nie eine halb bereinigte Steuer-ID speichern. Dieselbe reine Arithmetik läuft kostenlos im Browser und zum veröffentlichten API-Preis.

Eingabevertrag, Modi und Fehlerverhalten

Senden Sie ein number-Feld, das nur Zeichen A bis Z und null bis neun enthält; Kleinbuchstaben werden automatisch großgeschrieben. Falsche Länge ist ein expliziter Fehler, der Modus und gesendete Länge benennt—vierzehn für compute, fünfzehn für validate—damit Client-Formulare eine präzise Meldung zeigen können, ohne zu raten. Leere Strings, fehlendes number, ungültige mode-Werte und Rümpfe, die die Form Staat plus PAN verfehlen, scheitern, bevor einer gewichteten Summe vertraut wird, und werden nicht abgerechnet. Bevorzugen Sie compute beim Erzeugen oder Vervollständigen von Kennungen; bevorzugen Sie validate, wenn Sie eine Abfrage oder einen Import an eine vollständige GSTIN aus Nutzer- oder Partnerdatei knüpfen. Leerzeichen, Punkte, Bindestriche, Schrägstriche und andere Symbole werden als nicht alphanumerische Eingabe mit invalid_input abgelehnt, damit ein still bereinigter Wert nie den Speicher erreicht. Der Modus compute ist Standard: die Engine verlangt genau vierzehn Zeichen in der Standardform des GSTIN-Rumpfs (zweistelliger Staat, PAN-Segment aus fünf Buchstaben, vier Ziffern und einem Buchstaben, dann zwei abschließende Körperzeichen für Entität und Standardwert), liefert check_character als einzelnes Zeichen und with_check als die fünfzehnstellige GSTIN, die Sie drucken oder speichern können. Der Modus validate verlangt genau fünfzehn Zeichen; die Antwort meldet valid true, wenn das Endzeichen dem neu berechneten expected_check_character entspricht, und enthält payload (die ersten vierzehn), die gegebenen und erwarteten Prüfzeichen sowie length fünfzehn. Alias-Schlüssel wie gstin, code und text werden für dasselbe Payload-Feld akzeptiert, sodass Integrationen, die bereits «gstin» sprechen, nichts umbenennen müssen. Weil der Pfad pure parse ohne Uhr, Zufallsquelle oder Netz ist, liefert derselbe JSON-Body auf dem kostenlosen Browser-Tool und auf der API zu $0.002 pro erfolgreicher Anfrage immer dasselbe Ergebnis.

Wo GSTIN-Prüfzeichen in echten Abläufen Platz finden

Kreditorenportale prüfen fünfzehnstellige GSTINs beim Lieferanten-Onboarding, damit eine einzige Vertauschung keinen Phantomlieferanten und keine Zahlungsabweichung unter Reverse Charge erzeugt. Data-Quality-Jobs laufen über jede GSTIN-Spalte in einem CRM- oder ERP-Export, rufen den Modus validate auf und stellen Zeilen mit valid false unter Quarantäne—sowohl menschliche Edits als auch Generator-Bugs. Finance- und Stammdaten-Teams erhalten interne vierzehnstellige Steuerzahler-Rümpfe und müssen das offizielle GSTIN-Prüfzeichen anhängen, bevor die Kennung auf Steuerrechnungen, E-Invoice-Payloads oder Marketplace-Verkäuferprofilen landet, die ungültige GST-Nummern ablehnen. E-Commerce- und B2B-Anmeldeformulare können expected_check_character neu berechnen und eine freundliche Korrektur zeigen, wenn ein indisches Unternehmen eine Nummer mit vertipptem letztem Zeichen einfügt. Behandeln Sie eine bestandene GSTIN-Prüfung nicht als Nachweis aktiver Registrierung bei der Steuerbehörde oder eines bestimmten Schemas; sie belegt nur, dass das Base-36-Prüfzeichen mit dem vierzehnstelligen Rumpf unter den standardmäßigen Wechselgewichten übereinstimmt.