Vai al contenuto principale
POST
Verifica i dati di input rispetto a SUNAT. Didit espone questo servizio tramite POST /v3/database-validation/ in modo che tu possa verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: personal_number accetta il DNI peruviano (esattamente 8 cifre).

Copertura

  • Copertura: > 90%
  • Paese: Perù
  • ID servizio: per_tax_registration
  • Dominio dei dati: Finanziario
  • Categoria: TaxRegistry

Input

  • Input obbligatori: first_name, last_name, date_of_birth, personal_number
  • Input facoltativi: vendor_data
  • Consenso: non richiesto
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: > 90%
  • Prezzo: $2.92 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui viene effettuata la query. Quando l’identificativo non viene estratto dal documento, il controllo viene registrato come non applicabile: non viene interrogato alcun database e non ti viene addebitato nulla. Per alcuni paesi questa situazione riguarda una quota rilevante degli utenti reali. Per coprire anche questi casi, raccogli l’identificativo anche da una risposta a un questionario, da un campo di estrazione di Document AI o da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database.

Parametri del body

string
predefinito:"PER"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: PER
string
predefinito:"per_tax_registration"
obbligatorio
Array che contiene l’ID di questo servizio. Impostare questo servizio limita la richiesta a questo database specifico.Esempio: per_tax_registration
string
predefinito:"John"
obbligatorio
Nome da validare.Esempio: John
string
predefinito:"Doe"
obbligatorio
Cognome da validare.Esempio: Doe
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"11111111"
obbligatorio
Numero di identità personale specifico del paese.Esempio: 11111111
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dei rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • DNI peruviano (esattamente 8 cifre)
  • personal_number deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • personal_number deve essere lungo esattamente 8 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per per_tax_registration documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Prezzi e SLA

Le query Peru Tax Registration (SUNAT) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $2.92 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026