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

# Empreses proveïdores a Didit: registre KYB persistent

> Les empreses proveïdores de Didit unifiquen KYB, registre mercantil, titulars reals, administradors i AML en un perfil persistent.

Una **entitat d'empresa** representa una persona jurídica (societat, LLC, fons, fundació, empresari individual, fideïcomís) en totes les verificacions KYB, transaccions i interaccions de compliment que té amb la teva plataforma a Didit.

Igual que les entitats d'usuari, les entitats d'empresa s'identifiquen per `vendor_data` i agreguen totes les sessions i transaccions vinculades en un únic perfil.

## Què conté una empresa

| Categoria | Camps / objectes |
| - | - |
| **Identitat** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Estat** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregats de sessions** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Activitat** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Persones clau** | Directius, administradors, UBO i titulars reals vinculats (cadascun pot vincular-se a una entitat d'usuari per al KYC) |
| **Documents** | Certificats de constitució, estatuts, registres d'accionistes, poders notarials (POA), estats financers, documents personalitzats |
| **AML** | Resultats del cribratge a nivell d'empresa de sancions / PEP / mitjans adversos |
| **Metadades** | JSON arbitrari per a les teves pròpies dades |

Consulta el [model de dades d'empresa](https://docs.didit.me/ca/entities/businesses/data-model.md) complet per als tipus de camp i els casos límit.

## Quan es crea una empresa

**1. Automàticament: a partir d'una sessió de Verificació d'empreses (KYB)**

Quan crees una sessió de Verificació d'empreses (KYB) amb un `vendor_data` que Didit no ha vist mai, es crea una entitat d'empresa amb estat `ACTIVE` i es vincula a aquella sessió.

**2. Explícitament: mitjançant POST /v3/businesses/create/**

Crea l'empresa prèviament, abans d'executar cap sessió de Verificació d'empreses (KYB). Útil per carregar metadades o donar d'alta empreses en lot.

**3. Des de la consola**

El teu equip crea l'empresa des de la pàgina Empreses, per exemple quan es dona d'alta manualment una empresa verificada mitjançant un procés fora de línia.

## Què pots fer

| Operació | Com |
| - | - |
| [Llistar empreses](https://docs.didit.me/ca/entities/businesses/operations.md#llistar-empreses) | `GET /v3/businesses/` amb filtres |
| [Obtenir empresa](https://docs.didit.me/ca/entities/businesses/operations.md#obtenir-una-empresa) | `GET /v3/businesses/{vendor_data}/` |
| [Crear empresa](https://docs.didit.me/ca/entities/businesses/operations.md#crear-una-empresa) | `POST /v3/businesses/create/` |
| [Actualitzar perfil](https://docs.didit.me/ca/entities/businesses/operations.md#actualitzar-una-empresa) | `PATCH /v3/businesses/{vendor_data}/` |
| [Canviar estat](https://docs.didit.me/ca/entities/businesses/operations.md#canviar-l’estat) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Eliminar empreses](https://docs.didit.me/ca/entities/businesses/operations.md#eliminar-empreses-per-lots) | `POST /v3/businesses/delete/` (en lot) |
| [Revisar l'historial KYB](https://docs.didit.me/ca/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Revisar transaccions](https://docs.didit.me/ca/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Inspeccionar les persones clau](https://docs.didit.me/ca/entities/businesses/key-people.md) | Mitjançant les decisions de la sessió de Verificació d'empreses (KYB) |
| [Afegir a la llista de bloqueig](https://docs.didit.me/ca/entities/businesses/blocklist.md) | Consola + API de llistes |
| [Importar / exportar](https://docs.didit.me/ca/entities/businesses/import-export.md) | Només consola (CSV) |
| [Gestionar a la consola](https://docs.didit.me/ca/entities/businesses/console.md) | Recorregut complet per la interfície |

## Relacions Empresa ↔ Usuari

Una entitat d'empresa rarament existeix de manera aïllada. Durant la [KYB](https://docs.didit.me/ca/business-verification/overview.md), Didit identifica cada directiu, administrador, UBO i titular real. Cadascuna d'aquestes persones es pot vincular a una entitat d'usuari per al KYC individual:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

Quan un dels usuaris vinculats té una verificació KYC fallida o una coincidència AML, això es propaga al perfil de risc de l'empresa. Consulta [Persones clau](https://docs.didit.me/ca/entities/businesses/key-people.md) per al patró de vinculació.

## Empresa vs sessió d'empresa

Una **sessió d'empresa** és un esdeveniment de verificació KYB. Una **entitat d'empresa** és el perfil persistent que agrega totes les sessions.

Una mateixa empresa pot tenir moltes sessions de Verificació d'empreses (KYB): la verificació inicial, les noves presentacions i la re-KYB periòdica. El mapa `features` de l'empresa reflecteix l'estat més recent de totes les sessions.

## Passos següents

> [card] [Model de dades](https://docs.didit.me/ca/entities/businesses/data-model.md)
>
> Cada camp, tipus i índex.

> [card] [Operacions](https://docs.didit.me/ca/entities/businesses/operations.md)
>
> Crear, actualitzar, canviar l'estat i eliminar.

> [card] [Historial KYB](https://docs.didit.me/ca/entities/businesses/kyb-history.md)
>
> Totes les sessions de Verificació d'empreses (KYB) vinculades a l'empresa.

> [card] [Persones clau](https://docs.didit.me/ca/entities/businesses/key-people.md)
>
> Vinculació de directius, UBO i administradors.

> [card] [Llista de bloqueig](https://docs.didit.me/ca/entities/businesses/blocklist.md)
>
> Bloqueig d'empreses en transaccions.

> [card] [Consola](https://docs.didit.me/ca/entities/businesses/console.md)
>
> Recorregut complet per la interfície d'empreses.


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