Zum Hauptinhalt springen
POST
Prüft Eingabedaten anhand von Kreditauskunftsdaten (Credit Header) einer italienischen Kreditauskunftei. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 80%
  • Land: Italien
  • Dienst-ID: ita_credit_bureau
  • Datenbereich: Finanzen
  • Kategorie: CreditBureau

Eingaben

  • Pflichteingaben: first_name, last_name, address.street_1, address.postal_code, tax_number
  • Optionale Eingaben: date_of_birth, address.street_2, address.city, address.region, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 80%
  • Preis: $3.25 pro erfolgreiche Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält den Identifikator, anhand dessen die Abfrage erfolgt. Wenn der Identifikator nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht anwendbar erfasst: Es wird keine Datenbank abgefragt und Ihnen wird nichts berechnet. In einigen Ländern betrifft das einen großen Anteil der realen Nutzer. Erfassen Sie deshalb den Identifikator zusätzlich über eine Fragebogen-Antwort, ein Document-AI-Extraktionsfeld oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie ihn dem Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"ITA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ITA
string
Standard:"ita_credit_bureau"
erforderlich
Array mit dieser Dienst-ID. Die Festlegung des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: ita_credit_bureau
string
Standard:"John"
erforderlich
Zu validierender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu validierender Nachname.Beispiel: Doe
object
erforderlich
Strukturiertes Objekt für die Wohnadresse. Verwenden Sie street_1, street_2, city, region, postal_code und country. Eine vollständige Adresse als einzelne Zeichenfolge wird weiterhin akzeptiert, ist aber nicht empfohlen.Beispiel: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Standard:"SAMPLE-TAX-12345"
erforderlich
Steuer- oder steuerliche Identifikationsnummer.Beispiel: SAMPLE-TAX-12345
string
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"user-1234"
Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Fehlmeldungen bei der Duplikatserkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • tax_number muss genau 16 Zeichen lang sein.
  • Senden Sie bei Adressdiensten nach Möglichkeit strukturierte Adressfelder statt einer einzelnen address-Zeichenfolge.
  • address.street_1 ist die Straßenadresse einschließlich Hausnummer und Straßentyp.
  • address.street_2 ist eine Wohnungs-, Einheiten-, Gebäude- oder Etagenangabe oder eine zusätzliche Adresszeile. Senden Sie sie nur, wenn Sie sie haben.
  • address.city ist die Stadt, der Vorort, der Bezirk, der Ort oder das Stadtviertel.
  • address.region ist das Bundesland, die Provinz, die Region oder der Ort.
  • address.postal_code ist die Postleitzahl.
  • Datenbankdienste, die auf Adressen basieren, benötigen mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

Aufruf

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für ita_credit_bureau dokumentiert derzeit diese normalisierte Struktur:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Preise & SLAs

Abfragen des Italy Credit Bureau werden nur abgerechnet, wenn Didit ein abschließendes Ergebnis von der Validierungsquelle erhält.
  • Preis pro Abfrage: $3.25 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn erforderliche Felder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026