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

# Document AI: extracció de dades personalitzada

> Didit permet recopilar fins a 3 documents personalitzats i extreure'n camps amb IA per creuar-los amb altres passos i regles pròpies.

Document AI et permet recopilar documents que no s'ajusten a una plantilla fixa —comprovant de fons, nòmines, cartes d'origen del patrimoni, declaracions fiscals i qualsevol altre— i extreure exactament els camps que **tu** defineixis. Tu configures el títol i la descripció en pantalla de cada document (traduïts automàticament a tots els idiomes de verificació) i la llista de punts de dades que cal llegir. La IA de Didit extreu aquests camps, opcionalment els contrasta amb altres passos de verificació i aplica les teves regles per generar un estat.

Prompt d'integració de Document AI
        Copia el prompt al porta-retalls



      
      

\<pre>

\`# Goal
Integrate Didit Document AI (configurable multi-document upload + AI field extraction + cross-checks) into your app.

\# Setup (Business Console or POST /v3/workflows/)
Add the DOCUMENT_AI feature to your workflow and configure:
\- document_ai_documents: up to 3 documents. Each has { document_key, title, description, fields[] }.
Each field is { key, name, instruction, type: "text" | "number" | "date", required, is_full_name }.
title and description are auto-translated into every verification language on save.
\- is_full_name: optional boolean on a field. Marks the field whose value is compared automatically against the
verified subject: on a person (KYC) workflow the document holder's full name (the ID-verification name, or the
session's expected details), and on a business (KYB) workflow the verified company name (the registry-matched
company, or the session's expected company name). A low match below document_ai_name_match_score_threshold
triggers document_ai_name_mismatch_action. At most one field per document may set it, and it is optional — a
document may mark none (no name check runs).
\- Basic rules (per-risk action DECLINE | REVIEW | NO_ACTION): document_ai_unreadable_document_action,
document_ai_missing_required_fields_action, document_ai_document_tampering_action,
document_ai_name_mismatch_action, document_ai_unsupported_file_action, document_ai_max_attempts_exceeded_action.
\- document_ai_name_match_score_threshold (0-100), document_ai_max_retry_attempts (2-5).
\- status_rules[]: custom rules on any extracted field. Reference an extracted field as document_ai.<field_key>
and cross-reference other steps with value_type:"field" (e.g. document_ai.account_holder equals kyc.full_name).

\# Flow
1\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
2\. Open session.url for the user (or mount the Web/Mobile SDK). The user uploads each configured document.
3\. The user uploads documents to POST /v3/document-ai/documents/ (handled by the hosted flow/SDK):
multipart/form-data with { document_key, document, locale? }, Session-Token auth.
Response: { valid?, next_step, document_ai_status, uploaded_document_keys[], required_document_keys[] }.
The step completes once every configured document_key is uploaded.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

\# Decision surface
DOCUMENT_AI appears in the decision features[] array as { feature: "DOCUMENT_AI", node_id }.
Per-document statuses combine via precedence Declined > In Review > Approved.

\# See also
\- Report: /core-technology/document-ai/report-document-ai
\- Rules & warnings: /core-technology/document-ai/warnings-document-ai
\- Configure in the console: /console/workflows
\- Standalone API (server-to-server, no hosted UI): POST /v3/document-ai/ — /standalone-apis/document-ai`

\</pre>



      
      

Enganxa a

> [!NOTE]
>
> Ja tens el document al teu servidor? Crida la [Document AI API](https://docs.didit.me/ca/standalone-apis/document-ai.md) directament: envia el fitxer juntament amb les definicions de camps en una sola sol·licitud `POST /v3/document-ai/` i rep els camps extrets, la coincidència de nom i l'estat de manera síncrona, sense cap flux allotjat. \$0.20 per document.## Com funciona**1. Configurar documents i camps**Al creador de fluxos de treball defineixes fins a **3 documents**. Per a cada document estableixes:| Configuració | Descripció |
| - | - |
| **Títol i descripció** | Es mostren a l'usuari a la pantalla de càrrega. S'introdueixen una sola vegada i es **tradueixen automàticament** a tots els idiomes de verificació. |
| **Camps a extreure** | Una llista de camps tipats —cadascun amb un nom, una instrucció d'extracció per a la IA, un tipus (`text`, `number`, `date`), un indicador d'obligatorietat i un marcador opcional de **nom complet**. |
| **Camp de nom** | Opcionalment marca un camp de text per document com el nom que cal comparar. En un flux de treball de persona (KYC) és el **nom complet**, comparat amb la identitat verificada; en un flux de treball d'empresa (KYB) és el **nom de l'empresa**, comparat amb l'empresa verificada. `document_ai_name_mismatch_action` decideix què passa en cas de discordança. Opcional —deixa'l sense establir per ometre la comprovació de nom per a aquest document. |Comença a partir d'una [plantilla](#plantilles-d’inici) o crea'n una des de zero.**2. L'usuari puja els documents**L'usuari puja un fitxer per cada document configurat (PDF o imatge). Cada càrrega es processa de manera independent; el pas es completa un cop s'han proporcionat tots els documents obligatoris.**3. Extracció mitjançant IA**Didit renderitza cada document i executa un model de visió i llenguatge amb un esquema construït a partir de les teves definicions de camps. Els valors extrets es retornen tipats (els números com a números, les dates com a `YYYY-MM-DD`) i s'emmagatzemen per document. S'executen anàlisis forenses de PDF/EXIF per detectar manipulacions.**4. Contrast i regles**Els camps extrets es poden contrastar amb altres passos —per exemple, el nom del titular del document amb el document d'identitat verificat, o qualsevol camp amb les respostes dels qüestionaris— i amb les teves **regles bàsiques** i **regles d'estat personalitzades**. Els estats resultants per document es combinen en l'estat de la funcionalitat.## Plantilles d'iniciQuan afegeixes un node de Document AI pots començar a partir d'una plantilla ja preparada que emplena prèviament el títol, la descripció i els camps tipats. Personalitza qualsevol element posteriorment.| Plantilla | Camps habituals |
| - | - |
| **Comprovant de fons** | Titular del compte, saldo, divisa, data de l'extracte |
| **Comprovant d'ingressos (nòmina)** | Empresa, nom de l'empleat, salari brut/net, període de liquidació |
| **Origen del patrimoni** | Tipus d'origen, import, data, entitat |
| **Document fiscal** | Nom del contribuent, exercici fiscal, ingressos declarats, identificador fiscal |## Contrastar amb altres passosEls camps de Document AI són accessibles com a `document_ai.<field_key>` i es poden comparar amb camps d'altres passos completats mitjançant una regla d'estat personalitzada amb `value_type: "field"`. Per exemple:- `document_ai.account_holder` **és igual a** `kyc.full_name` — el titular del document coincideix amb la identitat verificada.
- `document_ai.balance` **greater\_than** `50000` — marcar saldos elevats per a revisió.Les regles de coincidència s'integren en la decisió utilitzant la precedència de la plataforma **Rebutjada > En revisió > Aprovada**, de manera que una regla pot augmentar la gravetat però mai anul·lar un estat més estricte determinat pel risc. Consulta [Regles i advertències](https://docs.didit.me/ca/core-technology/document-ai/warnings-document-ai.md).## Requisits dels documents| Requisit | Detall |
| - | - |
| **Documents per pas** | Fins a 3, cadascun configurat de manera independent |
| **Formats admesos** | PDF, JPG, JPEG, PNG, TIFF, WebP |
| **Pàgines** | S'admeten PDF de diverses pàgines |
| **Qualitat** | Document original o escaneig d'alta qualitat; sense edició ni manipulació digital |> [!NOTE]
>
> Document AI fa una lectura de text no estructurat, fet que introdueix uns segons de latència per document. Els webhooks només s'activen quan es completa tot el pas del flux de treball — no facis sondejos de l'endpoint de decisió amb intervals inferiors a 5 s durant aquest interval.


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