Zum Hauptinhalt springen
POST
Prüft die Eingabedaten gegen SUNAT. 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. Eingabeformat: personal_number akzeptiert die peruanische DNI (genau 8 Ziffern).

Abdeckung

  • Abdeckung: > 90%
  • Land: Peru
  • Service-ID: per_tax_registration
  • Datenbereich: Finanzen
  • Kategorie: TaxRegistry

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, personal_number
  • Optionale Eingaben: vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: > 90%
  • Preis: $2.92 pro erfolgreicher Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält die Kennung, über die abgefragt wird. Wenn die Kennung nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht zutreffend erfasst: Es wird keine Datenbank abgefragt und Ihnen wird nichts berechnet. Bei manchen Ländern ist dies ein großer Anteil der realen Nutzer. Um auch diese Nutzer abzudecken, erfassen Sie die Kennung zusätzlich aus einer Antwort auf einen Fragebogen, einem Extraktionsfeld von Document AI oder einem Wert, den Sie beim Erstellen der Sitzung senden, und ordnen Sie sie im Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"PER"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: PER
string
Standard:"per_tax_registration"
erforderlich
Array mit dieser Service-ID. Wenn Sie den Dienst festlegen, bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: per_tax_registration
string
Standard:"John"
erforderlich
Zu prüfender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu prüfender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"11111111"
erforderlich
Länderspezifische persönliche Identitätsnummer.Beispiel: 11111111
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Rauschen bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • Peruanische DNI (genau 8 Ziffern)
  • personal_number darf nur Ziffern enthalten; entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • personal_number muss genau 8 Zeichen lang sein.

So rufen Sie es auf

Zurückgegebene Daten

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

Preise und SLAs

Abfragen bei Peru Tax Registration (SUNAT) werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $2.92 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95-Wert < 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