Validació en bases de dades: advertències i codis

La funcionalitat de Validació en bases de dades de Didit verifica les dades d’identitat amb registres civils oficials (RENAPER a l’Argentina, Receita Federal al Brasil, Tribunal Electoral a Panamà —biomètric—, Junta Central Electoral a la República Dominicana, entre d’altres), facturant per consulta satisfactòria sense mínims mensuals. Quan cap servei no es pot executar (falten camps obligatoris o estan mal formats, el registre no està disponible), el document en si no es pot comprovar (no inclou l’identificador que necessiten els serveis configurats, per exemple, un passaport sense número d’identitat nacional) o el resultat agregat no és concloent (coincidència parcial, sense coincidència), la funcionalitat emet una advertència a la sessió. Si l’estat emissor no està habilitat al flux de treball, el pas s’omet de manera silenciosa sense advertència ni cap càrrec. Aquesta pàgina documenta cada codi d’advertència, què el desencadena i com configurar la resposta del flux de treball.

Visió general

Les advertències es generen tant a les sessions del flux de treball com a través de l’API independent (POST /v3/database-validation/). Tots cinc riscos estan etiquetats amb la funcionalitat DATABASE_VALIDATION, apareixen a l’informe sota database_validations[].warnings[] i segueixen l’estructura estàndard de l’objecte d’advertència (feature, risk, additional_data, log_type, short_description, long_description, node_id). No hi ha activadors de rebuig automàtic fixos per a la Validació en bases de dades. Els dos riscos relacionats amb el resultat de la coincidència, el risc de document substituït i el risc de no aplicable s’associen a una acció configurable (DECLINE, REVIEW o NO_ACTION); COULD_NOT_PERFORM_DATABASE_VALIDATION és l’únic comportament fix: sempre envia la funcionalitat a En revisió.

Riscos configurables

Configuració	Codi de risc	Comportament
Acció per falta de coincidència	`DATABASE_VALIDATION_NO_MATCH`	`REVIEW` (per defecte al flux de treball) passa la funcionalitat a En revisió; `DECLINE` la rebutja; `NO_ACTION` registra l’advertència sense afectar l’estat. El paràmetre `no_match_action` de l’API independent té com a valor per defecte `DECLINE`.
Acció per coincidència parcial	`DATABASE_VALIDATION_PARTIAL_MATCH`	`NO_ACTION` (per defecte) registra l’advertència sense afectar l’estat; `REVIEW` passa la funcionalitat a En revisió; `DECLINE` la rebutja.
Acció per falta de coincidència	`DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`	Comparteix la configuració d’Acció per falta de coincidència; no hi ha cap opció independent. El registre contradiu allò presentat, de manera que una organització que rebutja en cas de no coincidència també rebutja les credencials obsoletes.
Acció per no aplicabilitat	`DATABASE_VALIDATION_NOT_APPLICABLE`	`NO_ACTION` (per defecte) registra l’advertència sense afectar l’estat; `REVIEW` passa la funcionalitat a En revisió; `DECLINE` la rebutja. S’activa quan el document no es pot comprovar en absolut: no inclou l’identificador pel qual consulten els serveis configurats (per exemple, un passaport sense número d’identitat nacional).

L’acció configurada també determina el log_type de l’advertència: DECLINE → error, REVIEW → warning, NO_ACTION → information. El resultat de coincidència en si s’agrega a partir de les entrades individuals de validation de cada servei (qualsevol coincidència total → full_match; si no, qualsevol coincidència parcial → partial_match; si no, no_match); consulta Mètodes de coincidència per conèixer la lògica de decisió completa que obté els resultats 1×1 / 2×2.

Advertències generades

Etiqueta	Descripció breu	Descripció
`COULD_NOT_PERFORM_DATABASE_VALIDATION`	No s’ha pogut fer la validació en bases de dades	Cap servei ha retornat un resultat utilitzable (`match_type` es manté com a `null`) — generalment perquè manquen camps obligatoris o estan mal formats, o el registre ha retornat un error. `additional_data` conté el resum, per servei, dels salts (`reason`, `database_validation_errors`, `missing_required_fields_by_service`, `invalid_format_fields_by_service`, `field_reasons_by_service`); l’API independent utilitza `{ "validation_errors": [...] }` en el seu lloc. No se’t cobra quan s’activa aquesta advertència; la funcionalitat passa a en revisió fins que les dades es corregeixin.
`DATABASE_VALIDATION_NOT_APPLICABLE`	La validació en bases de dades no és aplicable a aquest document	El document proporcionat no inclou l’identificador que requereixen els serveis de base de dades configurats (`match_type` es manté com a `null`) — per exemple, un passaport brasiler no conté cap CPF, de manera que no es pot consultar el registre de CPF. Això és esperat per al tipus de document i no indica un problema amb el document. `additional_data` conté el resum, per servei, dels salts. No se’t cobra quan s’activa aquesta advertència. Acció configurable (per defecte `NO_ACTION`).
`DATABASE_VALIDATION_PARTIAL_MATCH`	Coincidència parcial de la validació en bases de dades	El `match_type` agregat és `partial_match` — alguns camps examinats han coincidit amb el registre però no tots. Acció configurable (per defecte `NO_ACTION`).
`DATABASE_VALIDATION_NO_MATCH`	Cap coincidència en la validació en bases de dades	El `match_type` agregat és `no_match` — el registre no ha pogut confirmar la identitat examinada. Acció configurable (per defecte `REVIEW` en fluxos de treball, `DECLINE` a l’API independent).
`DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`	Edició del document substituïda	Un servei ha retornat `DOCUMENT_SUPERSEDED`: el registre ha confirmat la identitat de la persona, però l’edició del document presentada no és la que figura als arxius — se n’ha emès una edició més nova des de llavors. Es genera independentment de `match_type`, que es manté com a `full_match` perquè tots els camps personals han coincidit, de manera que la troballa quedaria altrament invisible. `additional_data` indica els serveis que l’han reportat. Segueix la configuració de No Match Action.

COULD_NOT_PERFORM_DATABASE_VALIDATION cobreix dues situacions diferents, i la long_description de l’advertència (i, per a una fallada per servei, database_validation_errors[].message) ara indica quina s’ha aplicat en lloc d’una sola frase genèrica: mancaven dades examinades o estaven mal formades abans que es pogués consultar cap servei, o es va consultar un servei i no va retornar cap resultat utilitzable. En el segon cas, quan el registre ha reportat el seu propi detall diagnòstic per a aquest intent, aquest detall s’inclou al missatge perquè no hagis de contactar amb suport per esbrinar el motiu. El servei d’origen no s’esmenta mai a la resposta.

Quan COULD_NOT_PERFORM_DATABASE_VALIDATION o DATABASE_VALIDATION_NOT_APPLICABLE s’activen en una sessió de flux de treball, la comprovació es reactiva automàticament un cop s’omplen les dades que falten a la pàgina de detall de la sessió a la consola; en desar el camp es torna a executar la validació, i l’advertència s’elimina si té èxit. Això també funciona quan l’acció corresponent a «no aplicable» ha rebutjat la sessió, de manera que una sessió rebutjada es pot esmenar corregint les dades. Per a DATABASE_VALIDATION_NOT_APPLICABLE, la reexecució ajuda quan el document pot contenir l’identificador però no s’ha llegit (per exemple, una targeta de residència el número d’identitat nacional de la qual no s’ha extret); els tipus de document que mai contenen l’identificador (per exemple, passaports sense número d’identitat nacional) mantenen l’advertència. No s’aplica cap càrrec als serveis omesos; només pagues quan un servei retorna un resultat facturable.

Exemple

{
  "warnings": [
    {
      "feature": "DATABASE_VALIDATION",
      "risk": "DATABASE_VALIDATION_NO_MATCH",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Database validation no match",
      "long_description": "The system identified a no match in the database validation, requiring further investigation.",
      "node_id": "feature_db_validation_1"
    }
  ]
}

Tipus d’advertència

A cada risc se li assigna una gravetat basada en la configuració de la teva aplicació. Les gravetats es divideixen en tres categories:

Relacionat

Visió general de la validació en bases de dades — com funciona la funcionalitat d’extrem a extrem i registres admesos.
Informe de validació en bases de dades — estructura completa de la resposta incloent validations[] per servei.
Mètodes de coincidència — com es deriven els resultats 1×1 / 2×2 (validation_type: one_by_one / two_by_two) de les coincidències per servei.
Codis de resultat — taxonomia completa per resultat amb codis de detall específics per país.
Països i serveis admesos — tots els registres actius, camps obligatoris i preu per crida.
Models de dades — validació en bases de dades — esquema canònic camp per camp.

Autenticació

Verificació

Monitoratge

Plataforma

Validació en bases de dades: advertències i codis

Visió general

Riscos configurables

Advertències generades

Exemple

Tipus d’advertència

Relacionat

​Visió general

​Riscos configurables

​Advertències generades

​Exemple

​Tipus d’advertència

​Relacionat

Visió general

Riscos configurables

Advertències generades

Exemple

Tipus d’advertència

Relacionat