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

# Llista de bloqueig d'empreses: bloquejar KYB i països

> Bloqueja entitats d'empreses de Didit per vendor_data o país: com es comprova un bloqueig i les rutes de la consola i l'API per afegir-ne o eliminar-ne.

Les llistes de bloqueig impedeixen que una empresa que no hagi superat les teves comprovacions de compliment (o que estigui situada en una jurisdicció perillosa) iniciï noves sessions de Verificació d'empreses (KYB) o realitzi transaccions a la teva plataforma.

## Tipus d'identificadors admesos per a empreses

| Tipus | Clau | Coincideix quan… |
| - | - | - |
| Empresa | `BUSINESS` | Una sessió o transacció nova utilitza el `vendor_data` bloquejat |
| País | (configurat per separat) | El país de l'empresa coincideix amb una llista de països perillosos |
| IP | `IP_ADDRESS` | L'adreça IP de qui envia (o el rang CIDR) coincideix |
| Empremta del dispositiu | `DEVICE_FINGERPRINT` | El dispositiu de qui envia coincideix |
| Adreça de cartera | `WALLET_ADDRESS` | La cartera de criptomonedes vinculada a l'empresa coincideix |
| Compte bancari | `BANK_ACCOUNT` | L'IBAN o el compte bancari coincideix |

> [!NOTE]
>
> Les llistes de bloqueig de rostres i de documents operen a nivell d'**individu** (usuari), no a nivell d'empresa. Per bloquejar administradors o titulars reals (UBO), bloqueja'ls com a usuaris: la seva implicació en qualsevol empresa es traslladarà després a la revisió de les persones clau de l'empresa.

## Com es produeix el bloqueig

> [!NOTE]
>
> Una sessió de Verificació d'empreses (KYB) rebutjada no bloqueja l'empresa. La sessió finalitza com a `Declined`, l'empresa continua `ACTIVE` i no s'escriu cap entrada a la llista. El bloqueig és un pas manual: afegeix l'entrada des de la [pàgina de la llista de bloqueig](https://docs.didit.me/ca/console/blocklist-users.md) o amb l'[API de Lists](https://docs.didit.me/ca/management-api/lists/overview.md), i una entrada `BUSINESS` (el `vendor_data`) també posa l'estat de l'empresa a `BLOCKED`.

**1. Automàtic: per país perillós**

Si el país de constitució de l'empresa figura a la teva llista configurada de països perillosos, la sessió de Verificació d'empreses (KYB) es rebutja.

**2. Automàtic: per entitat sancionada**

Una coincidència AML de l'empresa per sobre del llindar de rebuig rebutja la sessió. No escriu cap entrada a la llista; bloqueja tu l'empresa si vols que el seu `vendor_data` quedi refusat a partir d'aquell moment.

**3. Manual: des de la consola**

Un analista bloqueja una empresa des de *Businesses → \[empresa] → Actions → Add to blocklist*.

**4. Programàtic: mitjançant l'API de Lists**

Utilitza l'[API de Lists](https://docs.didit.me/ca/management-api/lists/overview.md) per afegir entrades directament a la llista de bloqueig d'empreses.

## Països perillosos

Cada aplicació inclou una llista predeterminada de **països perillosos** (configurable des de *Settings → Blocklist → Countries*). Exemples de codis ISO inclosos per defecte: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (aquesta llista pot canviar, ja que la llista predeterminada segueix la guia de FATF i OFAC).

Quan es crea una empresa amb un `country_code` que coincideix amb un país de la llista:

* La sessió de Verificació d'empreses (KYB) es rebutja.
* No s'emet cap enllaç de sessió.
* L'entitat de l'empresa es crea en estat `BLOCKED`.

## Afegir una empresa a la llista de bloqueig mitjançant l'API

Utilitza l'[API de Lists](https://docs.didit.me/ca/management-api/lists/overview.md) per afegir una entrada a la llista de bloqueig de manera programàtica:

1. [Llista totes les llistes](https://docs.didit.me/ca/management-api/lists/list.md) filtrant per `entry_type=business` i `is_system=true` per trobar la llista de bloqueig del sistema per a empreses.
2. [Crea una entrada](https://docs.didit.me/ca/management-api/lists/create-entry.md) en aquesta llista amb `value` igual al `vendor_data` de l'empresa, i opcionalment `display_label` i `comment` per a finalitats d'auditoria.

## Aplicació en el moment de la transacció

Les empreses bloquejades es propaguen automàticament al monitoratge de transaccions:

* Les transaccions amb una **empresa sol·licitant bloquejada** es rebutgen automàticament.
* Les transaccions amb una **empresa contrapart bloquejada** es marquen o es rebutgen segons la configuració de les teves regles.

Les regles predefinides com «Sanctioned counterparty» s'activen amb aquestes coincidències.

## Eliminar una empresa de la llista de bloqueig

* **Consola**: *Blocklist → Businesses → row actions → Remove*.
* **API**: utilitza l'endpoint [Esborrar entrada](https://docs.didit.me/ca/management-api/lists/delete-entry.md) amb l'UUID de la llista i l'UUID de l'entrada.

L'eliminació no canvia automàticament l'`status` de l'empresa. Utilitza `PATCH /v3/businesses/{vendor_data}/update-status/` per tornar l'empresa a `ACTIVE`.

## Traça d'auditoria

Cada afegiment o eliminació es registra al [registre d'auditoria](https://docs.didit.me/ca/console/audit-logs.md) amb:

* Actor (correu electrònic de l'usuari o `'system'`, `'api'`).
* Marca de temps.
* Comentari opcional.
* Sessió de referència si s'ha generat automàticament.

## Següents passos

> [card] [API de Lists](https://docs.didit.me/ca/management-api/lists/overview.md)
>
> Referència completa de l'API de llistes de bloqueig.

> [card] [Llista de bloqueig de la consola](https://docs.didit.me/ca/console/blocklist-users.md)
>
> Gestiona les llistes de bloqueig des de la interfície.

> [card] [Operacions](https://docs.didit.me/ca/entities/businesses/operations.md)
>
> Canvia l'estat de l'empresa.


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