Saltar al contingut principal
POST
Verifica les dades d’entrada amb les dades de Credit Header obtingudes d’un Credit Bureau d’Itàlia. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritativa i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: ~ 80%
  • País: Itàlia
  • ID del servei: ita_credit_bureau
  • Domini de dades: Financer
  • Categoria: CreditBureau

Entrades

  • Entrades obligatòries: first_name, last_name, address.street_1, address.postal_code, tax_number
  • Entrades opcionals: date_of_birth, address.street_2, address.city, address.region, vendor_data
  • Consentiment: No requerit
  • Disponibilitat en el flux de treball: Disponible al flux de treball
  • Cobertura: ~ 80%
  • Preu: $3.25 per consulta satisfactòria
No tots els documents que accepta aquest servei contenen l’identificador amb què consulta. Quan l’identificador no s’extreu del document, la comprovació queda registrada com a no aplicable: no es consulta cap base de dades i no se’t cobra, cosa que en alguns països 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:"ITA"
requerit
Codi de país ISO 3166-1 alfa-3 d’aquest servei de base de dades.Exemple: ITA
string
predeterminat:"ita_credit_bureau"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: ita_credit_bureau
string
predeterminat:"John"
requerit
Nom de pila a validar.Exemple: John
string
predeterminat:"Doe"
requerit
Cognom a validar.Exemple: Doe
object
requerit
Objecte d’adreça residencial estructurat. Utilitza street_1, street_2, city, region, postal_code i country. Encara s’accepta una cadena d’adreça en el format heretat completa, però no es recomana.Exemple: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
predeterminat:"SAMPLE-TAX-12345"
requerit
Identificador fiscal o número d’identificació tributària.Exemple: SAMPLE-TAX-12345
string
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"user-1234"
La teva referència d’usuari estable per a aquesta persona, com ara el teu ID d’usuari intern. 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ó

  • tax_number ha de tenir exactament 16 caràcters.
  • Per als serveis d’adreça, envia els camps d’adreça estructurats en lloc d’una única cadena address quan sigui possible.
  • address.street_1 és l’adreça del carrer, incloent-hi el número i el tipus de via.
  • address.street_2 és l’apartament, la unitat, l’edifici, el pis o qualsevol línia addicional d’adreça. Envia’l només quan el tinguis.
  • address.city és la ciutat, el suburbi, el districte, la localitat o el barri.
  • address.region és l’estat, la província, la regió o la població.
  • address.postal_code és el codi postal.
  • Els serveis de base de dades basats en l’adreça requereixen com a mínim l’adreça del carrer i el codi postal; les sol·licituds rebutjades abans de la consulta a la font no es cobren.

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 ita_credit_bureau documenta actualment aquesta estructura normalitzada:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Preus i SLA

Les consultes a Italy Credit Bureau només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $3.25 USD.
  • Facturació: per consulta satisfactòria. No se’t factura 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ípica inferior a 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font en aval varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026