Überprüfung der Steuernummer eine Person - Italien

Der Service zur Überprüfung der Steuernummer ermöglicht die Validierung der Steuernummer einer Privatperson und ist derzeit ausschließlich für Italien verfügbar.

Die Steuernummer dient der eindeutigen Identifizierung italienischer Bürger und ist unerlässlich für die Registrierung und Überwachung von Personen sowie deren Transaktionen mit öffentlichen und privaten Einrichtungen. Sie wird von der Agenzia delle Entrate (der italienischen Steuerbehörde) vergeben und ist vergleichbar mit der Sozialversicherungsnummer, die in anderen Ländern verwendet wird.

Die API zur Überprüfung der Steuernummer ist in zwei Modi verfügbar:

Die Steuernummer besteht aus 16 alphanumerischen Zeichen:

Die Überprüfung der Steuernummer ist entscheidend, um sicherzustellen, dass sie tatsächlich einer existierenden und im italienischen Steuersystem registrierten Person entspricht. Dieses Tool hilft, Betrug und Missbrauch zu verhindern, indem gewährleistet wird, dass die Nummer gültig ist und zur angegebenen Person gehört.

Im Gegensatz zu anderen APIs prüft der Openapi-Service nicht nur die formale Korrektheit der eingegebenen Steuernummer, sondern verifiziert auch, dass sie tatsächlich bei der Agenzia delle Entrate registriert ist.

Durch die Integration dieses API-Services ist es möglich, die Identität von Kunden und Lieferanten zu überprüfen und sicherzustellen, dass geschäftliche Transaktionen mit legitimen und registrierten Parteien stattfinden.

ASYNCHRONER MODUS

Der asynchrone Modus stellt die leistungsstärkste, skalierbarste und effizienteste Lösung für die Integration des Steuernummer-Überprüfungsdienstes dar. Er wurde für die Verarbeitung massiver Anfragen, automatisierter Workflows und hochvolumiger Enterprise-Architekturen entwickelt.

Dank der implementierten neuen Technologien ermöglicht der asynchrone Endpoint eine Kostenersparnis von 10 % und ist ohne Rate Limit (Zero Rate Limit) verfügbar, wodurch maximale Betriebskontinuität auch bei Verkehrsspitzen gewährleistet wird.

In diesem Modus wird die Anfrage sofort entgegengenommen und eine eindeutige Kennung (Anfrage-ID) zurückgegeben. Die Verarbeitung erfolgt im Hintergrund und das Ergebnis kann später über den entsprechenden Endpoint abgerufen werden.

Zusätzlich kann ein Webhook (Callback) konfiguriert werden, um automatisch über Statusänderungen der Anfrage informiert zu werden. Der Callback liefert nicht das Verifikationsergebnis, sondern benachrichtigt ausschließlich über Statusänderungen. Sobald der Status evaso erreicht ist, muss der Ergebnis-Endpoint aufgerufen werden, um das endgültige Resultat abzurufen.

BEISPIELANFRAGE

POST /IT-verifica_cf

Im Request-Body muss die zu überprüfende Steuernummer angegeben werden. Optional kann eine Webhook-URL (Callback) definiert werden, um Statusaktualisierungen zu erhalten.

POST https://risk.openapi.com/IT-verifica_cf

{
  "codice_fiscale": "RSSMRA85M01H501Z",
  "callback": "https://tuodominio.it/webhook"
}

BEISPIEL FÜR DIE ERSTE ANTWORT

Bei Erstellung der Anfrage gibt das System sofort eine ID und den Verarbeitungsstatus zurück.

{
  "id": "abc123",
  "stato": "in_attesa",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": null
}

Der Status kann zwei Werte annehmen:

ERGEBNISABRUF

Das Ergebnis kann über den Endpoint mit der bei der Erstellung erhaltenen ID abgerufen werden.

GET /IT-verifica_cf/{id}

{
  "id": "abc123",
  "stato": "evaso",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": true
}

SYNCHRONER MODUS

In diesem Modus erfolgt die Überprüfung der Steuernummer in Echtzeit und das Ergebnis wird unmittelbar innerhalb desselben API-Aufrufs zurückgegeben.

Falls das System die Anfrage nicht sofort verarbeiten kann, wird kein Fehler mehr zurückgegeben, sondern ein 201-Status mit einer eindeutigen ID. Das Ergebnis kann anschließend über den entsprechenden Endpoint abgerufen werden.

BEISPIELANFRAGE

GET /IT-verifica_cf/{codice_fiscale}

Als Parameter ist die zu überprüfende Steuernummer anzugeben; die Anfrage muss mit der Methode GET ausgeführt werden.

GET https://risk.openapi.com/IT-verifica_cf/xxxxxxxxxxxxxx

BEISPIELANTWORT

Wenn die Anfrage sofort verarbeitet wird, gibt die Antwort an, ob die überprüfte Steuernummer gültig (true) oder ungültig (false) ist.

{
  "data": { 
   "validita": true
  }, 
  "success": true,
  "message": "Anfrage abgeschlossen",
  "error": null
}

Die Überprüfung der Steuernummer wird bereits von Unternehmen, Fachleuten und öffentlichen Einrichtungen genutzt, die die Identität von Kunden und Lieferanten überprüfen müssen, um sicherzustellen, dass Transaktionen mit registrierten und legitimen Parteien stattfinden und Betrug sowie Missbrauch vermieden werden.