Model de dades KYB: esquema d'empreses

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ó.
`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ó.

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.

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`

{
  "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

{
  "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

Operacions

Crear, actualitzar, canviar l’estat i eliminar.

Historial KYB

Recuperar totes les sessions vinculades a l’empresa.

Referència de l'API

Esquema de GET /v3/businesses//.

Darrera modificació el 7 de novembre del 2026

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions

Entitats (usuaris i empreses)

Configuració i personalització

Seguretat i compliment

Didit Academy

Recursos

Model de dades KYB: esquema d'empreses

Camps d’identitat

Estat

Camps agregats de sessions

El mapa `features`

Marques de temps d’activitat

Metadades

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

Exemple de resposta

Següents passos

Operacions

Historial KYB

Referència de l'API

​Camps d’identitat

​Estat

​Camps agregats de sessions

​El mapa features

​Marques de temps d’activitat

​Metadades

​Relacions (no s’emmagatzemen a la fila de l’empresa)

​Exemple de resposta

​Següents passos

Operacions

Historial KYB

Referència de l'API

Camps d’identitat

Estat

Camps agregats de sessions

El mapa `features`

Marques de temps d’activitat

Metadades

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

Exemple de resposta

Següents passos