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

# Empresas fornecedoras: registo KYB persistente

> Didit mantém uma ficha persistente por entidade: histórico KYB, registos, beneficiários efetivos, administradores, AML, documentos e transações.

A **entidade Business** representa uma pessoa coletiva (empresa, LLC, fundo, fundação, empresário em nome individual, trust) em todas as interações de verificação KYB, transações e conformidade que tem com a sua plataforma na Didit.

Tal como as entidades User, as entidades Business são identificadas por `vendor_data` e agregam todas as sessões e transações ligadas num único perfil.

## O que existe numa Business

| Categoria | Campos / objetos |
| - | - |
| **Identidade** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Estado** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sessões** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Atividade** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Pessoas-chave** | Responsáveis, administradores, UBO e beneficiários efetivos ligados (cada um pode estar ligado a uma entidade User para KYC) |
| **Documentos** | Certidões de constituição, estatutos, registos de acionistas, procurações (POA), demonstrações financeiras, documentos personalizados |
| **AML** | Resultados de triagem ao nível da empresa para sanções / PEP / notícias adversas |
| **Metadados** | JSON arbitrário para os seus próprios dados |

Consulte o [modelo de dados completo da Business](https://docs.didit.me/pt/entities/businesses/data-model.md) para ver os tipos de campos e os casos limite.

## Quando é criada uma Business

**1. Automaticamente — a partir de uma sessão de Verificação de empresas (KYB)**

Quando cria uma sessão de Verificação de empresas (KYB) com um `vendor_data` que a Didit nunca viu, é criada uma entidade Business com estado `ACTIVE` e ligada a essa sessão.

**2. Explicitamente — através de POST /v3/businesses/create/**

Pré-crie a Business antes de iniciar qualquer sessão de Verificação de empresas (KYB). Útil para pré-carregar metadados ou fazer onboarding em massa de empresas.

**3. A partir da consola**

A sua equipa cria a Business na página Businesses — por exemplo, ao fazer o onboarding manual de uma empresa verificada através de um processo offline.

## O que pode fazer

| Operação | Como |
| - | - |
| [Listar empresas](https://docs.didit.me/pt/entities/businesses/operations.md#listar-empresas) | `GET /v3/businesses/` com filtros |
| [Obter empresa](https://docs.didit.me/pt/entities/businesses/operations.md#obter-uma-empresa) | `GET /v3/businesses/{vendor_data}/` |
| [Criar empresa](https://docs.didit.me/pt/entities/businesses/operations.md#criar-uma-empresa) | `POST /v3/businesses/create/` |
| [Atualizar perfil](https://docs.didit.me/pt/entities/businesses/operations.md#atualizar-uma-empresa) | `PATCH /v3/businesses/{vendor_data}/` |
| [Alterar estado](https://docs.didit.me/pt/entities/businesses/operations.md#alterar-o-estado) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Eliminar empresas](https://docs.didit.me/pt/entities/businesses/operations.md#eliminar-empresas-em-lote) | `POST /v3/businesses/delete/` (em lote) |
| [Rever histórico KYB](https://docs.didit.me/pt/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Rever transações](https://docs.didit.me/pt/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Analisar pessoas-chave](https://docs.didit.me/pt/entities/businesses/key-people.md) | Através das decisões de sessões de Verificação de empresas (KYB) |
| [Adicionar à lista de bloqueio](https://docs.didit.me/pt/entities/businesses/blocklist.md) | Consola + API de Listas |
| [Importar / exportar](https://docs.didit.me/pt/entities/businesses/import-export.md) | Apenas na consola (CSV) |
| [Gerir na consola](https://docs.didit.me/pt/entities/businesses/console.md) | Guia completo da interface |

## Relações Business ↔ User

Uma entidade Business raramente existe isolada. Durante o [KYB](https://docs.didit.me/pt/business-verification/overview.md), a Didit identifica todos os responsáveis, administradores, UBO e beneficiários efetivos. Cada um destes pode ser ligado a uma entidade User para 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
```

Quando um dos Users ligados tem uma falha no KYC ou um resultado positivo na AML, isso propaga-se ao perfil de risco da empresa. Consulte [Pessoas-chave](https://docs.didit.me/pt/entities/businesses/key-people.md) para ver o padrão de ligação.

## Business vs sessão de empresa

Uma **sessão de empresa** é um evento de verificação KYB. Uma **entidade Business** é o perfil persistente que agrega todas as sessões.

Uma única Business pode ter várias sessões de Verificação de empresas (KYB) — verificação inicial, reenvios e re-KYB periódico. O mapa `features` da Business reflete o estado mais recente em todas as sessões.

## Próximos passos

> [card] [Modelo de dados](https://docs.didit.me/pt/entities/businesses/data-model.md)
>
> Todos os campos, tipos e índices.

> [card] [Operações](https://docs.didit.me/pt/entities/businesses/operations.md)
>
> Criar, atualizar, alterar estado, eliminar.

> [card] [Histórico KYB](https://docs.didit.me/pt/entities/businesses/kyb-history.md)
>
> Todas as sessões de Verificação de empresas (KYB) associadas à empresa.

> [card] [Pessoas-chave](https://docs.didit.me/pt/entities/businesses/key-people.md)
>
> Ligação de responsáveis, UBO e administradores.

> [card] [Lista de bloqueio](https://docs.didit.me/pt/entities/businesses/blocklist.md)
>
> Impedir que as empresas efetuem transações.

> [card] [Consola](https://docs.didit.me/pt/entities/businesses/console.md)
>
> Visita guiada completa à página Businesses.


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