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

# Entitats: usuaris i empreses a Didit

> Usuaris i empreses són les dues entitats principals de Didit. Cadascuna agrupa sessions KYC, transaccions, documents, biometria i risc en un únic perfil.

Didit organitza tot el que passa a la teva aplicació al voltant de dos tipus d'entitat de primera classe:

| Entitat | Representa | Vinculada a |
| - | - | - |
| **Usuari** | Una persona física | Sessions de Verificació d'usuaris (KYC), biometria facial, transaccions (com a sol·licitant o contrapart), llistes de bloqueig |
| **Empresa** | Una entitat jurídica (companyia, LLC, empresa individual, fons) | Sessions de Verificació d'empreses (KYB), càrrecs directius, UBO, transaccions (com a sol·licitant o contrapart), llistes de bloqueig |

Cada sessió de verificació, cada transacció i cada entrada d'una llista de bloqueig es pot vincular a una entitat. Un cop vinculada, l'entitat es converteix en un perfil persistent que agrega l'historial, els senyals de risc i l'estat de compliment al llarg del temps.

## Diferència entre entitat i sessió

Una **entitat** i una **sessió** són coses diferents.

| Concepte | Abast | Durada | Exemple |
| - | - | - | - |
| **Sessió** | Un esdeveniment de verificació | Un únic flux (de minuts a dies mentre està en revisió) | Un únic intent de KYC |
| **Entitat** | Un perfil persistent | Viu mentre l'usuari o l'empresa existeixi a la teva plataforma | El client "Jane Doe" amb 3 sessions de Verificació d'usuaris (KYC) al llarg de 2 anys |

Una mateixa entitat pot tenir moltes sessions: reverificacions, reenviaments, comprovacions addicionals i monitoratge continu periòdic. L'entitat n'agrega els resultats.

## Creació automàtica o creació prèvia manual

Les entitats es creen de tres maneres:

**1. Creada automàticament des d'una sessió**

Quan crees una sessió amb un identificador `vendor_data` i no existeix cap entitat corresponent, Didit crea l'entitat automàticament. És la via més habitual.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

Una entitat d'usuari per a `user-42` es crea en el moment en què comença la sessió.

**2. Creada prèviament amb l'API de gestió**

Crea primer l'entitat i després inicia sessions amb ella. És útil quan vols carregar senyals de risc (estat, etiquetes, metadades personalitzades) abans de la primera verificació.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

**3. Creada a la consola**

El teu equip de compliment pot crear usuaris o empreses directament des de la Business Console, cosa que és útil per a l'alta manual, les importacions o els fluxos de treball de correcció.

## Com les entitats ho enllacen tot

El camp `vendor_data` és la clau d'enllaç. Quan passes `vendor_data` a qualsevol sessió o transacció, Didit l'encamina a l'entitat corresponent.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

Més informació a la [guia de vinculació amb `vendor_data`](https://docs.didit.me/ca/entities/vendor-data-linking).

## Què pots fer amb una entitat

Per a cada entitat d'usuari o d'empresa, pots:

| Operació | Finalitat |
| - | - |
| **Crear / actualitzar** | Definir o canviar les dades del perfil de l'entitat (nom, país, metadades personalitzades) |
| **Canviar estat** | Marcar-la com a `ACTIVE`, `FLAGGED` o `BLOCKED`. L'aplicació de la mesura es propaga a les sessions i transaccions futures |
| **Adjuntar biometria** | Pujar una referència facial per a una cerca 1:N, detecció de duplicats o inclusió a una llista de bloqueig |
| **Revisar l'historial de KYC/KYB** | Recuperar totes les sessions vinculades a l'entitat, amb resultats per funcionalitat |
| **Revisar l'historial de transaccions** | Recuperar totes les transaccions en què l'entitat és el sol·licitant o la contrapart |
| **Afegir a una llista de bloqueig** | Bloquejar les sessions o transaccions futures que impliquin aquesta entitat |
| **Importar / exportar** | Carregar entitats en massa des de CSV o exportar-les per a eines externes de compliment |
| **Eliminar** | Eliminar l'entitat (l'historial es conserva per a auditoria) |

Les guies detallades es troben a [Usuaris](https://docs.didit.me/ca/entities/users/overview.md) i [Empreses](https://docs.didit.me/ca/entities/businesses/overview.md).

## Relacions entre usuaris i empreses

Un mateix usuari pot estar vinculat a una o diverses empreses. Això passa de manera natural durant el KYB:

* Un usuari pot ser **administrador** d'una empresa i **UBO** d'una altra.
* La sessió de KYC d'un usuari es pot vincular a la sessió de KYB d'una empresa mitjançant el flux de [Persones clau](https://docs.didit.me/ca/business-verification/key-people.md).

Didit conserva aquestes relacions: en inspeccionar una entitat d'empresa, pots veure cada usuari vinculat, i en inspeccionar una entitat d'usuari, pots veure cada empresa a la qual està associat.

## Cicle de vida i estats

Cada entitat té un estat que determina si Didit aplica bloquejos a l'activitat nova:

| Estat | Efecte |
| - | - |
| `ACTIVE` | Normal: les sessions i transaccions avancen segons la configuració dels fluxos de treball i les regles |
| `FLAGGED` | Les sessions i transaccions es permeten, però s'encaminen automàticament a revisió manual |
| `BLOCKED` | Les sessions i transaccions es rebutgen automàticament, i no es pot crear cap sessió nova |

Consulta el [cicle de vida complet de l'entitat](https://docs.didit.me/ca/entities/lifecycle.md) per a les transicions i els esdeveniments de webhook.

## Següents passos

> [card] [Cicle de vida](https://docs.didit.me/ca/entities/lifecycle.md)
>
> Estats, transicions i esdeveniments del cicle de vida de cada entitat.

> [card] [Vinculació de vendor\_data](https://docs.didit.me/ca/entities/vendor-data-linking.md)
>
> Com `vendor_data` vincula sessions, transaccions i entitats.

> [card] [Usuaris](https://docs.didit.me/ca/entities/users/overview.md)
>
> Anàlisi detallada de les entitats d'usuari, les seves operacions i els fluxos de treball a la consola.

> [card] [Empreses](https://docs.didit.me/ca/entities/businesses/overview.md)
>
> Anàlisi detallada de les entitats d'empresa, les seves operacions i els fluxos de treball a la consola.

> [card] [Webhooks d'entitats](https://docs.didit.me/ca/entities/webhooks.md)
>
> Esdeveniments en temps real per a cada canvi d'entitat.

> [card] [Llista de bloqueig](https://docs.didit.me/ca/console/blocklist-users.md)
>
> Com les entrades de la llista de bloqueig interactuen amb les entitats d'usuari i d'empresa.


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