> ## 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 (Vendor Businesses): registro KYB persistente

> As Vendor Businesses do Didit unificam histórico KYB, registro, UBOs, diretores, AML, documentos e transações em um perfil único de pessoa jurídica.

Uma **entidade empresarial** representa uma pessoa jurídica (empresa, LLC, fundo, fundação, empresa individual, trust) em todas as verificações KYB, transações e interações de conformidade que ela tem com a sua plataforma na Didit.

Assim como as entidades de usuário, as entidades de empresa são identificadas por `vendor_data` e reúnem todas as sessões e transações vinculadas em um único perfil.

## O que uma empresa contém

| Categoria | Campos / objetos |
| - | - |
| **Identidade** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Status** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sessão** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Atividade** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Pessoas-chave** | Administradores, diretores, UBOs e beneficiários finais vinculados (cada um pode ser vinculado a uma entidade de usuário para KYC) |
| **Documentos** | Certidões de constituição, contratos ou estatutos sociais, livros de registro de acionistas, POA, demonstrações financeiras, documentos personalizados |
| **PLD** | Resultados da triagem de sanções, PEP e mídia adversa da empresa |
| **Metadados** | JSON arbitrário para os seus próprios dados |

Consulte o [modelo de dados de empresa](https://docs.didit.me/pt-br/entities/businesses/data-model.md) completo para ver os tipos de campo e os casos extremos.

## Quando uma empresa é criada

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

Quando você cria uma sessão de Verificação de empresas (KYB) com um `vendor_data` que a Didit nunca viu, uma entidade de empresa é criada com status `ACTIVE` e vinculada a essa sessão.

**2. Explicitamente: via POST /v3/businesses/create/**

Crie a empresa antecipadamente, antes de executar qualquer sessão de Verificação de empresas (KYB). Útil para inicializar metadados ou fazer o onboarding de empresas em massa.

**3. Pelo console**

A sua equipe cria a empresa na página de empresas, por exemplo, ao fazer manualmente o onboarding de uma empresa verificada por um processo offline.

## O que você pode fazer

| Operação | Como |
| - | - |
| [Listar empresas](https://docs.didit.me/pt-br/entities/businesses/operations.md#listar-empresas) | `GET /v3/businesses/` com filtros |
| [Obter empresa](https://docs.didit.me/pt-br/entities/businesses/operations.md#obter-uma-empresa) | `GET /v3/businesses/{vendor_data}/` |
| [Criar empresa](https://docs.didit.me/pt-br/entities/businesses/operations.md#criar-uma-empresa) | `POST /v3/businesses/create/` |
| [Atualizar perfil](https://docs.didit.me/pt-br/entities/businesses/operations.md#atualizar-uma-empresa) | `PATCH /v3/businesses/{vendor_data}/` |
| [Alterar status](https://docs.didit.me/pt-br/entities/businesses/operations.md#alterar-o-status) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Excluir empresas](https://docs.didit.me/pt-br/entities/businesses/operations.md#excluir-empresas-em-lote) | `POST /v3/businesses/delete/` (em lote) |
| [Consultar histórico de KYB](https://docs.didit.me/pt-br/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Consultar transações](https://docs.didit.me/pt-br/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Inspecionar pessoas-chave](https://docs.didit.me/pt-br/entities/businesses/key-people.md) | Pelas decisões das sessões de Verificação de Empresa (KYB) |
| [Adicionar à lista de bloqueio](https://docs.didit.me/pt-br/entities/businesses/blocklist.md) | Console + API de listas |
| [Importar / exportar](https://docs.didit.me/pt-br/entities/businesses/import-export.md) | Apenas no console (CSV) |
| [Gerenciar no console](https://docs.didit.me/pt-br/entities/businesses/console.md) | Guia completo da interface |

## Relações entre empresas e usuários

Uma entidade de empresa raramente existe isoladamente. Durante o [KYB](https://docs.didit.me/pt-br/business-verification/overview.md), a Didit identifica todos os administradores, diretores, UBOs e beneficiários finais. Cada uma dessas pessoas pode ser vinculada a uma entidade de usuário 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 usuários vinculados tem um KYC reprovado ou um alerta de AML, isso se propaga para o perfil de risco da empresa. Consulte [Pessoas-chave](https://docs.didit.me/pt-br/entities/businesses/key-people.md) para ver o padrão de vinculação.

## Empresa vs. sessão de empresa

Uma **sessão de empresa** é um evento de verificação KYB. Uma **entidade empresarial** é o perfil persistente que reúne todas as sessões.

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

## Próximos passos

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

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

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

> [card] [Pessoas-chave](https://docs.didit.me/pt-br/entities/businesses/key-people.md)
>
> Vinculação de administradores, UBOs e diretores.

> [card] [Lista de bloqueio](https://docs.didit.me/pt-br/entities/businesses/blocklist.md)
>
> Bloqueio de empresas para impedir transações.

> [card] [Console](https://docs.didit.me/pt-br/entities/businesses/console.md)
>
> Guia completo da interface de empresas.


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