Saltar al contingut principal
POST
Verifica les dades d’entrada amb SUNAT. Didit exposa aquest servei mitjançant POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats. Format d’entrada: personal_number accepta el DNI peruà (exactament 8 dígits).

Cobertura

  • Cobertura: > 90%
  • País: Perú
  • ID del servei: per_tax_registration
  • Domini de dades: Financer
  • Categoria: TaxRegistry

Entrades

  • Entrades obligatòries: first_name, last_name, date_of_birth, personal_number
  • Entrades opcionals: vendor_data
  • Consentiment: No cal
  • Disponibilitat al flux de treball: Disponible en un flux de treball
  • Cobertura: > 90%
  • Preu: $2.92 per consulta satisfactòria
No tots els documents que accepta aquest servei porten l’identificador amb què es consulta. Quan l’identificador no s’extreu del document, la comprovació es registra com a no aplicable: no es consulta cap base de dades i no se’t cobra. En alguns països això representa una part important dels usuaris reals. Per cobrir-los, recull també l’identificador d’una resposta d’un Qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i assigna’l al pas de Validació en bases de dades.

Paràmetres del cos

string
predeterminat:"PER"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: PER
string
predeterminat:"per_tax_registration"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei fa que la sol·licitud es limiti a aquesta base de dades exacta.Exemple: per_tax_registration
string
predeterminat:"John"
requerit
Nom de pila a validar.Exemple: John
string
predeterminat:"Doe"
requerit
Cognom a validar.Exemple: Doe
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"11111111"
requerit
Número d’identitat personal específic del país.Exemple: 11111111
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per vincular les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • DNI peruà (exactament 8 dígits)
  • personal_number ha de contenir només dígits; elimina espais, guions i signes de puntuació abans d’enviar la sol·licitud.
  • personal_number ha de tenir exactament 8 caràcters.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a per_tax_registration documenta actualment aquesta estructura normalitzada:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Preus i SLA

Les consultes del registre fiscal del Perú (SUNAT) es facturen només quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $2.92 USD.
  • Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font subjacent varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026