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

# Lista de bloqueio de empresas: bloquear KYB e países

> Bloqueie entidades Didit Business por vendor_data ou país: verificação do bloqueio e rotas da consola e da API para o adicionar ou remover.

As listas de bloqueio impedem que uma empresa que não tenha passado nas suas verificações de conformidade, ou que esteja localizada numa jurisdição perigosa, inicie novas sessões de Verificação de empresas (KYB) ou realize transações na sua plataforma.

## Tipos de identificadores suportados para empresas

| Tipo | Chave | Corresponde quando… |
| - | - | - |
| Empresa | `BUSINESS` | Uma nova sessão ou transação usa o `vendor_data` bloqueado |
| País | (configurado à parte) | O país da empresa corresponde a uma lista de países perigosos |
| IP | `IP_ADDRESS` | O IP do remetente (ou intervalo CIDR) corresponde |
| Impressão digital do dispositivo | `DEVICE_FINGERPRINT` | O dispositivo do remetente corresponde |
| Endereço | `WALLET_ADDRESS` | A carteira de criptomoedas associada à empresa corresponde |
| Conta bancária | `BANK_ACCOUNT` | O IBAN ou a conta bancária corresponde |

> [!NOTE]
>
> As listas de bloqueio de rostos e de documentos funcionam ao nível do indivíduo (Utilizador), e não ao nível da empresa. Para bloquear administradores ou UBO, bloqueie-os como Utilizadores: o seu envolvimento com qualquer empresa passa depois para a análise das pessoas-chave da empresa.

## Como funciona o bloqueio

> [!NOTE]
>
> Uma sessão de Verificação de empresas (KYB) recusada não bloqueia a empresa. A sessão termina como `Declined`, a empresa mantém-se como `ACTIVE` e não é criada nenhuma entrada na lista. O bloqueio é um passo manual: adicione a entrada a partir da [Página de lista de bloqueio](https://docs.didit.me/pt/console/blocklist-users.md) ou com a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md). Uma entrada `BUSINESS` (o `vendor_data`) também define o estado da empresa como `BLOCKED`.

**1. Automático — por país perigoso**

Se o país de constituição da empresa constar da lista de países perigosos configurada, a sessão de Verificação de empresas (KYB) é recusada.

**2. Automático — por entidade sancionada**

Uma correspondência AML da empresa acima do limiar de recusa faz com que a sessão seja recusada. Não escreve nenhuma entrada na lista; bloqueie você mesmo a empresa se quiser que o seu `vendor_data` seja recusado a partir daí.

**3. Manual — a partir da consola**

Um analista bloqueia uma empresa a partir de *Businesses → \[business] → Actions → Add to blocklist*.

**4. Programático — através da Lists API**

Use a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md) para adicionar entradas diretamente à lista de bloqueio de empresas.

## Países perigosos

Cada aplicação vem com uma lista predefinida de **países perigosos** (configurável em *Settings → Blocklist → Countries*). Exemplos de códigos ISO incluídos por predefinição: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (sujeito a alterações; a lista predefinida segue as orientações do GAFI e da OFAC).

Quando é criada uma empresa com um `country_code` correspondente:

* A sessão de Verificação de empresas (KYB) é recusada.
* Não é emitida nenhuma ligação de sessão.
* A entidade da empresa é criada com o estado `BLOCKED`.

## Adicionar uma empresa à lista de bloqueio através da API

Use a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md) para adicionar uma entrada à lista de bloqueio programaticamente:

1. [Listar todas as listas](https://docs.didit.me/pt/management-api/lists/list.md) filtradas por `entry_type=business` e `is_system=true` para encontrar a lista de bloqueio de empresas do sistema.
2. [Criar uma entrada](https://docs.didit.me/pt/management-api/lists/create-entry.md) nessa lista, com `value` definido como o `vendor_data` da empresa, e, opcionalmente, `display_label` e `comment` para fins de auditoria.

## Aplicação no momento da transação

As empresas bloqueadas são automaticamente propagadas para a Monitorização de transações:

* As transações com uma **empresa requerente bloqueada** são recusadas automaticamente.
* As transações com uma **empresa contraparte bloqueada** são sinalizadas ou recusadas, consoante a configuração das suas regras.

As regras predefinidas, como "Sanctioned counterparty", são acionadas por estas correspondências.

## Remover uma empresa da lista de bloqueio

* **Consola**: *Blocklist → Businesses → row actions → Remove*.
* **API**: use o endpoint [Eliminar entrada](https://docs.didit.me/pt/management-api/lists/delete-entry.md) com o UUID da lista e o UUID da entrada.

A remoção não altera automaticamente o `status` da empresa. Use `PATCH /v3/businesses/{vendor_data}/update-status/` para repor a empresa em `ACTIVE`.

## Registo de auditoria

Cada adição e remoção fica registada no [registo de auditoria](https://docs.didit.me/pt/console/audit-logs.md), com:

* Ator (e-mail do utilizador ou `'system'`, `'api'`).
* Data e hora.
* Comentário opcional.
* Sessão de referência, se gerada automaticamente.

## Próximos passos

> [card] [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md)
>
> Referência completa da API de listas de bloqueio.

> [card] [Lista de bloqueio na consola](https://docs.didit.me/pt/console/blocklist-users.md)
>
> Gerir listas de bloqueio a partir da interface.

> [card] [Operações](https://docs.didit.me/pt/entities/businesses/operations.md)
>
> Alterar o estado da empresa.


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