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

# Model de dades KYB: esquema d'empreses

> Model d'entitat de Didit Business: registre, titulars reals, administradors, estat AML, documents, sessions KYB i transaccions enllaçades.

Aquesta pàgina documenta tots els camps d'una entitat d'empresa i com emplena Didit cadascun d'aquests camps.

## Camps d'identitat

| Camp | Tipus | Descripció |
| - | - | - |
| `uuid` | UUID | Clau primària assignada per Didit. Estable i única. |
| `didit_internal_id` | string | Identificador intern llegible per a humans. |
| `vendor_data` | string | El teu identificador de l'empresa. Únic per aplicació. [Més informació](https://docs.didit.me/ca/entities/vendor-data-linking.md). |
| `display_name` | string | Nom alternatiu que es mostra a la consola. Per defecte, `legal_name` o `vendor_data`. |
| `legal_name` | string | Nom legal de l'empresa tal com figura al registre. Es propaga des de la consulta al registre de la darrera sessió de Verificació d'empreses (KYB) aprovada. |
| `registration_number` | string | Número oficial de registre de l'empresa. Es propaga des del registre. |
| `country_code` | string (ISO 3166-1 alpha-3) | País de constitució. |

> [!NOTE]
>
> `legal_name`, `registration_number` i `country_code` són de només lectura quan es deriven d'una consulta verificada al registre. Es poden substituir manualment a la consola o mitjançant `PATCH /v3/businesses/{vendor_data}/`, però les substitucions queden marcades al registre d'auditoria.

## Estat

| Camp | Tipus | Valors | Descripció |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Controla l'aplicació de les mesures corresponents a les sessions i transaccions futures. Consulta el [cicle de vida](https://docs.didit.me/ca/entities/lifecycle.md). |

## Camps agregats de sessions

| Camp | Tipus | Descripció |
| - | - | - |
| `session_count` | int | Total de sessions de Verificació d'empreses (KYB) que s'han creat mai per a aquesta empresa |
| `approved_count` | int | Sessions finalitzades amb `Approved` |
| `declined_count` | int | Sessions finalitzades amb `Declined` |
| `in_review_count` | int | Sessions que estan actualment `In Review` |
| `features` | object | Estat de la darrera verificació d'empresa, sota la clau `KYB` |

### El mapa `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

El mapa conté una sola clau, `KYB`, amb l'estat de la darrera verificació de l'empresa: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` o `"Resub Requested"`.
Per consultar l'estat de cada funcionalitat KYB individual, consulta la decisió de la sessió.

Utilitza el mapa `features` com a via ràpida per comprovar si una empresa està completament verificada en aquest moment, sense recórrer totes les sessions.

## Marques de temps d'activitat

| Camp | Tipus | S'actualitza quan |
| - | - | - |
| `first_session_at` | marca de temps ISO | Es crea la primera sessió de Verificació d'empreses (KYB) |
| `last_session_at` | marca de temps ISO | Es crea o s'actualitza la sessió més recent |
| `last_activity_at` | marca de temps ISO | Qualsevol canvi: sessió, transacció, estat, perfil o notes |
| `created_at` | marca de temps ISO | Es crea la fila de l'entitat |
| `updated_at` | marca de temps ISO | Es va actualitzar per última vegada la fila de l'entitat |

## Metadades

| Camp | Tipus | Descripció |
| - | - | - |
| `metadata` | object (JSON) | JSON de format lliure que controles tu |
| `tags[]` | array | Etiquetes gestionades des de la consola o l'API |

## Relacions (no s'emmagatzemen a la fila de l'empresa)

| Relació | Com hi accedeixes |
| - | - |
| Sessions de Verificació d'empreses (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Usuaris vinculats (directius, UBO i administradors) | Es mostren a la pàgina de detall de l'empresa a la consola; es deriven de la darrera sessió de Verificació d'empreses (KYB) aprovada |
| Transaccions (com a sol·licitant o contrapart) | Filtra les transaccions pel `vendor_data` de l'empresa |
| Documents | Mitjançant les decisions de les sessions de Verificació d'empreses (KYB) |
| Coincidències AML | Mitjançant les decisions de les sessions de Verificació d'empreses (KYB) |

## Exemple de resposta

```json theme={null}
{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}
```

## Següents passos

> [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)
>
> Recuperar totes les sessions vinculades a l'empresa.

> [card] [Referència de l'API](https://docs.didit.me/ca/management-api/businesses/get.md)
>
> Esquema de GET /v3/businesses/{vendor_data}/.


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