Generator und Validator für Landessteuernummern
Erzeuge gültige Landessteuernummern (Inscrição Estadual) für deine Tests oder prüfe, ob eine gültig ist, in jedem Bundesstaat.
Beim Öffnen der Seite wird eine Landessteuernummer aus São Paulo erzeugt. Wähle Bundesstaat, Anzahl und Format oder klicke auf "Landessteuernummer erzeugen", um eine neue zu erstellen.
So funktioniert es
- Die Nummer wird auf dem Server erzeugt und nirgends gespeichert.
- Jeder Bundesstaat hat eigene Länge, eigenes Präfix und eigene Prüfziffernberechnung, und der Generator folgt jeweils der SINTEGRA-Spezifikation.
- In São Paulo erzeugt der Generator die 12-stellige Nummer für Industrie und Handel.
- Die Nummer dient nur zum Testen und gehört keiner echten Firma.
- Die zuletzt erzeugten Werte stehen unter der Schaltfläche, bis du die Seite verlässt.
So nutzt du die API
Du kannst den Generator für Landessteuernummern über unsere REST-API in deine Anwendung einbinden.
Endpunkt
GET /api/generators/state-registration
Query-Parameter
- state
- Pflichtfeld. Das Kürzel des Bundesstaats, z. B. "SP".
- quantity
- Optional. Von 1 bis 50. Wenn angegeben, enthält die Antwort die Liste "stateRegistrations" statt "stateRegistration".
- formatted
- Optional. "false" erzeugt nur Ziffern. Standard: "true".
Beispiel mit curl
curl "https://devtools.vmotta.dev/api/generators/state-registration?state=MG&quantity=2"
Antwort
{
"stateRegistrations": [
"062.307.904/0081",
"195.445.174/3240"
]
}Wähle den Bundesstaat, gib die Nummer ein und klicke auf "Landessteuernummer prüfen", um zu erfahren, ob sie gültig ist.
So funktioniert es
- Die Prüfung läuft auf dem Server und nichts wird gespeichert.
- Geprüft werden Länge, Präfix und Prüfziffern, die der gewählte Bundesstaat verlangt.
- Die Nummer kann mit oder ohne Satzzeichen eingegeben werden.
- In São Paulo wird nur die Nummer für Industrie und Handel akzeptiert, nicht die für Landwirte, die mit P beginnt.
- Das Ergebnis erscheint direkt unter dem Feld.
So nutzt du die API
Du kannst den Validator für Landessteuernummern über unsere REST-API in deine Anwendung einbinden.
Endpunkt
POST /api/validators/state-registration
Request-Body
- stateRegistration
- Pflichtfeld. Die Nummer mit oder ohne Satzzeichen.
- state
- Pflichtfeld. Das Kürzel des Bundesstaats, z. B. "SP".
Beispiel mit curl
curl -X POST https://devtools.vmotta.dev/api/validators/state-registration \
-H "Content-Type: application/json" \
-d '{"stateRegistration":"110.042.490.114","state":"SP"}'Beispiel-Body
{
"stateRegistration": "110.042.490.114",
"state": "SP"
}Antwort
{
"isValid": true
}