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

# Verificació d'empreses (KYB): API de documents

> Didit recull, fa OCR i creua documents corporatius en KYB: certificats, estatuts, comptes anuals. Preus separats de la consulta al registre.

La verificació d'empreses inclou una recollida estructurada de documents per validar la informació de l'empresa més enllà del que hi ha disponible als registres.

## Preus

La recollida de documents KYB costa **\$0.20 per pas del flux de treball**, independentment del nombre de documents que es pugin en aquest pas. Tornar a pujar un document en el mateix pas no suma una altra tarifa; un pas de recollida de documents separat té el seu propi cost.

## Grups de documents

Els documents s'organitzen en quatre grups estructurats, cadascun dels quals representa una categoria d'evidència necessària per a la verificació d'empreses, més un grup general per a qualsevol cosa que Didit no pugui classificar:

| Grup (`document_group`) | Descripció | Subtipus de document reconeguts |
| - | - | - |
| **Presència legal** (`LEGAL_PRESENCE`) | Documents que demostren que l'empresa existeix legalment | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **Detalls de l'empresa** (`COMPANY_DETAILS`) | Documents que descriuen les dades actuals de l'empresa | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **Estructura de propietat** (`OWNERSHIP_STRUCTURE`) | Documents que demostren la cadena de titularitat | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **Autorització de representants** (`REPRESENTATIVES_AUTHORIZATION`) | Documents que demostren l'autoritat per actuar en nom de l'empresa | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **Altres** (`OTHER`) | Qualsevol cosa que Didit no pugui classificar amb confiança | `UNKNOWN` |

Cada grup fa el seguiment del seu progrés amb comptadors per grup: `total`, `approved`, `pending`, `declined`, `in_review`, `other` i `missing`. L'estat general dels documents de la sessió d'empresa agrega tots els grups.

## Tipus de document

| Categoria | Exemples |
| - | - |
| **Documents de constitució** | Certificat d'constitució, estatuts socials, escriptura fundacional |
| **Documents de titularitat** | Registre d'accionistes, certificats d'accions, declaracions de UBO |
| **Documents d'adreça** | Factures de serveis, extractes bancaris o contractes d'arrendament de l'adreça registrada |
| **Documents financers** | Comptes anuals, informes d'auditoria, estats financers |
| **Documents fiscals** | Certificats d'inscripció fiscal, certificats de compliment fiscal |
| **Documents regulatoris** | Llicències, permisos, aprovacions regulatòries |
| **Documents personalitzats** | Qualsevol document addicional que requereixi el vostre procés de compliment |

## Flux de treball de documents

**1. Sol·licituds automàtiques**

Segons la configuració del vostre flux de treball, Didit identifica automàticament quins documents es necessiten per a la verificació d'empreses. Els tipus de document obligatoris es presenten a l'empresa perquè els pugi.

**2. Pujada**

Els documents es pugen mitjançant el flux de verificació allotjat, a través de la Business Console o des de la vostra pròpia interfície amb l'endpoint de [pujar documents](https://docs.didit.me/ca/sessions-api/kyb-upload-documents.md). Els formats acceptats són PDF, JPG, JPEG, PNG, TIFF i WebP, o un arxiu ZIP que els contingui. Els PDF poden tenir fins a 50 MB i les fotos fins a 6 MB abans de la compressió. Per a un PDF protegit amb contrasenya, envieu la contrasenya a `document_passwords` quan pugeu el document per l'API.

**3. Extracció OCR**

Didit extreu dades estructurades dels documents pujats mitjançant OCR:

* Nom de l'empresa i número de registre dels certificats
* Dades d'adreça dels rebuts de serveis
* Xifres financeres dels estats financers
* Noms i càrrecs dels registres d'accionistes

**4. Contrast de dades**

Les dades extretes es creuen amb:

* Les dades del registre de la consulta de l'empresa
* La informació proporcionada en crear la sessió
* Les dades d'altres documents pujats

Les incoherències es marquen per a la revisió de l'analista.

**5. Revisió**

Els analistes revisen els documents pujats a la consola, verifiquen la seva autenticitat i aproven o rebutgen cada document individualment.

## Sol·licituds de documents dels analistes

Durant el procés de revisió, els analistes poden sol·licitar documents addicionals:

1. Aneu a la sessió d'empresa a la consola
2. Feu clic a **Request document** i especifiqueu el tipus de document i la descripció
3. Es notifica a l'empresa, que pot pujar el document sol·licitat
4. El document apareix a la sessió amb l'estat **Sol·licitat** fins que es pugi

Això permet als analistes recopilar evidència addicional sense rebutjar tota la sessió d'empresa.

## Estats de documents

Cada document i la comprovació agregada `document_verifications[]` utilitzen el conjunt d'estats estàndard de la funcionalitat KYB:

| Estat | Descripció |
| - | - |
| `"Not Finished"` | El document encara s'està processant (pujada en curs, OCR en execució o creuament pendent). |
| `"Approved"` | El document s'ha revisat i acceptat. |
| `"Declined"` | El document s'ha revisat i rebutjat. |
| `"In Review"` | El document requereix l'atenció manual de l'analista. |
| `"Resub Requested"` | L'analista ha sol·licitat una nova presentació: l'empresa ha de tornar a enviar aquest document perquè la sessió pugui avançar. |

## Resultats de la comprovació creuada

Quan es processa un document, Didit contrasta les dades extretes per OCR amb les **dades proporcionades per l'usuari** presentades en el flux de persones clau (i amb qualsevol dada confirmada durant la revisió del registre), així com amb altres documents carregats. La comprovació creuada genera resultats estructurats:

| Categoria | Descripció |
| - | - |
| **Camps crítics** | Camps en què les dades del document i les dades proporcionades per l'usuari no coincideixen; requereixen la revisió d'un analista. Cada camp mostra el valor del document, el valor proporcionat per l'usuari i una puntuació de confiança. |
| **Camps no crítics** | Camps amb discrepàncies menors o diferències de format que poden no requerir cap acció (per exemple, diferències d'abreviació en el nom de l'empresa). |
| **Coincidència de persones** | Anàlisi de les persones mencionades al document en comparació amb les persones presentades per l'usuari; destaca les persones que falten o les persones addicionals. |

Els resultats de la comprovació creuada es mostren a la [Business Console](https://docs.didit.me/ca/business-verification/console.md) al costat de la previsualització del document, cosa que ofereix als analistes una visió clara del que coincideix i del que requereix atenció.

## Obtenció de documents mitjançant l'API

Els documents s'adjunten a la sessió de verificació d'empreses (KYB). Obtén-los mitjançant la decisió de la sessió:

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

La resposta inclou una matriu `document_verifications[]`: cada element té un `status`, un `node_id`, `items[]` (cadascun amb un `file_url` signat, un `document_group`, un `document_subtype` i un extracte OCR), `groups` i `required_groups`. Consulta l'[esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md#document_verifications) per veure'n l'estructura completa.

## Passos següents

> [card] [Esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md)
>
> On apareixen els documents al payload.

> [card] [Business console](https://docs.didit.me/ca/business-verification/console.md)
>
> Revisió de documents com a analista.


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