> ## 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.

# Regles i advertències de Document AI

> Regles de Document AI de Didit: documents il·legibles, camps obligatoris absents, manipulacions, discrepàncies de nom i referències creuades.

## Visió general

Document AI genera un estat per a cada document carregat a partir de dues capes de regles, i els estats de cada document es combinen en l'estat de la funcionalitat utilitzant la precedència **Rebutjat > En revisió > Aprovat**.

1. **Regles bàsiques**: comprovacions integrades, cadascuna associada a una acció configurable: `DECLINE`, `REVIEW` o `NO_ACTION`.
2. **Regles d'estat personalitzades**: les teves pròpies condicions sobre qualsevol camp extret, incloses referències creuades amb altres passos.

## Regles bàsiques

Cada regla següent es detecta automàticament durant l'extracció i l'anàlisi forense. Configura l'acció de cadascuna a la pestanya **Regles** de la funcionalitat Document AI.

| Regla | Camp de configuració | S'activa quan |
| - | - | - |
| **Document il·legible** | `document_ai_unreadable_document_action` | El document no es pot llegir, no es pot extreure cap dada o no s'ha pogut revisar el fitxer completament |
| **Falten camps obligatoris** | `document_ai_missing_required_fields_action` | No es pot extreure un camp marcat com a **obligatori** |
| **Manipulació de documents** | `document_ai_document_tampering_action` | L'anàlisi forense detecta indicis de manipulació |
| **Discrepància de nom** | `document_ai_name_mismatch_action` | El nom que consta al document no coincideix amb el subjecte verificat: la identitat del titular en un flux de treball de persona (KYC), o l'empresa en un flux de treball d'empresa (KYB) (per sota de `document_ai_name_match_score_threshold`) |
| **Fitxer no compatible** | `document_ai_unsupported_file_action` | El tipus de fitxer pujat no és compatible |
| **Intents superats** | `document_ai_max_attempts_exceeded_action` | L'usuari supera `document_ai_max_retry_attempts` |

La comprovació de **discrepància de nom** compara el camp de nom indicat del document amb el subjecte verificat mitjançant una puntuació de 0 a 100: en un flux de treball de persona (KYC), amb el document d'identitat verificat (i els detalls esperats indicats en crear la sessió), i en un flux de treball d'empresa (KYB), amb l'empresa verificada (l'empresa que coincideix amb el registre mercantil, o el nom d'empresa esperat). Defineix el llindar amb `document_ai_name_match_score_threshold`.

## Regles d'estat personalitzades

Les regles d'estat personalitzades et permeten establir un estat (`Approved`, `In Review`, `Declined` o `No Action`) quan es compleix una condició relativa a un camp extret. Cada regla és:

```json theme={null}
{
  "field": "document_ai.balance",
  "operator": "greater_than",
  "value": 50000,
  "status": "In Review"
}
```

Per fer una **referència creuada amb un altre pas**, defineix `value_type: "field"` i apunta `value` cap a una altra ruta de camp:

```json theme={null}
{
  "field": "document_ai.account_holder",
  "operator": "fuzzy_match",
  "value": "kyc.full_name",
  "value_type": "field",
  "score": 80,
  "status": "Declined"
}
```

Cada regla que coincideix aporta el seu estat, i guanya l'estat més estricte d'entre aquests i l'estat base (Rebutjat > En revisió > Aprovat). Per tant, una regla pot augmentar la gravetat, però mai tornar a elevar un estat `Declined`/`In Review` derivat del risc. Les regles amb `No Action` es registren però no modifiquen l'estat.

> [!NOTE]
>
> Els camps extrets són accessibles com a `document_ai.<field_key>` utilitzant la `key` que hagis configurat per a cada camp. Els camps numèrics i de data admeten operadors de comparació (`greater_than`, `less_than`, intervals de dates); els camps de text admeten igualtat, `contains` i `fuzzy_match`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.