> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Validació en bases de dades: advertències i codis > Guia de Didit sobre advertències de validació en bases de dades: COULD_NOT_PERFORM_DATABASE_VALIDATION, registres inaccessibles o camps que falten. La funcionalitat de [Validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md) 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](https://docs.didit.me/ca/reference/data-models.md#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](https://docs.didit.me/ca/core-technology/database-validation/database-validation-matching-methods.md) 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**. | > [!NOTE] > > `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. > [!NOTE] > > 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 ```json theme={null} { "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](https://docs.didit.me/ca/core-technology/database-validation/overview.md) — com funciona la funcionalitat d'extrem a extrem i registres admesos. * [Informe de validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/database-validation-report.md) — estructura completa de la resposta incloent `validations[]` per servei. * [Mètodes de coincidència](https://docs.didit.me/ca/core-technology/database-validation/database-validation-matching-methods.md) — 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](https://docs.didit.me/ca/core-technology/database-validation/database-validation-outcome-codes.md) — taxonomia completa per resultat amb codis de detall específics per país. * [Països i serveis admesos](https://docs.didit.me/ca/core-technology/database-validation/database-validation-supported-countries.md) — tots els registres actius, camps obligatoris i preu per crida. * [Models de dades — validació en bases de dades](https://docs.didit.me/ca/reference/data-models.md#validació-en-bases-de-dades) — esquema canònic camp per camp. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.