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

# API de perfis de empresa: acompanhar empresas verificadas

> Didit: acompanhe empresas verificadas entre sessões com perfis automáticos, estados, etiquetas e importação CSV. Desde $2.00 por verificação.

Didi cria automaticamente um perfil de empresa para cada empresa que verifica, agregando os dados de verificação e o histórico de sessões numa única entidade. Os perfis de empresa oferecem uma visão unificada de cada empresa em todas as suas sessões de verificação.

> [!NOTE]
>
> Os perfis de empresa são a vertente específica de KYB do modelo mais geral de **entidade empresarial**. Para o modelo completo de entidades (operações, ligação de pessoas-chave a utilizadores, mecânica da lista de bloqueio, importação e exportação), consulte a [Visão geral das empresas](https://docs.didit.me/pt/entities/businesses/overview.md).

## O que é um perfil de empresa

Um perfil de empresa é criado automaticamente quando uma [sessão de empresa](https://docs.didit.me/pt/business-verification/overview.md) é submetida com um identificador `vendor_data`. Se já existir um perfil com esse identificador, a nova sessão é associada a ele.

| Campo | Descrição |
| - | - |
| **Dados do fornecedor** | O seu identificador único para esta empresa (por exemplo, `company-123`) |
| **Nome de apresentação** | Nome de apresentação mostrado na consola |
| **Denominação social** | Nome legal oficial proveniente do registo de empresas ou introduzido manualmente |
| **Número de registo** | Número de registo ou de constituição da empresa |
| **País** | País de constituição (ISO 3166-1 alpha-2) |

## Estados do perfil

| Estado | Descrição |
| - | - |
| `ACTIVE` | A empresa está em situação regular, sem problemas detetados |
| `FLAGGED` | A empresa requer atenção: reveja os resultados ou as verificações pendentes |
| `BLOCKED` | A empresa foi bloqueada e não pode realizar mais atividade |

Os estados podem ser alterados manualmente na consola, em massa ou automaticamente com base nos resultados da verificação.

## Métricas de sessão

Cada perfil acompanha as métricas de verificação de todas as sessões associadas:

| Métrica | Descrição |
| - | - |
| **Total de sessões** | Número de sessões de verificação desta empresa |
| **Aprovadas** | Sessões que passaram em todas as verificações |
| **Recusadas** | Sessões que falharam uma ou mais verificações críticas |
| **Em análise** | Sessões a aguardar revisão por um analista |
| **Última sessão** | Data e hora da verificação mais recente |
| **Primeira sessão** | Data e hora da verificação mais antiga |
| **Última atividade** | Data e hora de qualquer atividade recente (alteração de estado, atualização de sessão, etc.) |

## Etiquetas

Aplique etiquetas aos perfis de empresa para categorização e filtragem. As etiquetas são definidas pela aplicação: crie etiquetas personalizadas que se adaptem ao seu fluxo de trabalho (por exemplo, `high-risk`, `vip-client`, `re-verification-needed`).

## Operações em massa

Faça a gestão de vários perfis de empresa de uma só vez:

| Operação | Descrição |
| - | - |
| **Atualização de estado em massa** | Altere o estado dos perfis selecionados (ou de todos os perfis que correspondam aos filtros atuais) |
| **Exportação de CSV** | Exporte os dados dos perfis para CSV, com seleção configurável de colunas |
| **Importação de CSV** | Importe perfis de empresa a partir de um ficheiro CSV para os pré-criar antes da verificação |
| **Eliminação em massa** | Remova os perfis selecionados e os respetivos dados associados |

### Importação de CSV

Para importar perfis de empresa em massa:

1. Transfira o **modelo de importação** a partir da consola para ver o formato de colunas esperado
2. Preencha o modelo com os dados da sua empresa
3. Carregue o ficheiro: a Didit cria uma tarefa de importação e processa as linhas de forma assíncrona

Após a conclusão, reveja o resumo da importação com o número de linhas criadas, atualizadas e com falhas. As linhas com falhas incluem detalhes específicos do erro.

## Revisões e comentários

Adicione notas internas de revisão a qualquer perfil de empresa. Os comentários são visíveis para todos os membros da equipa com acesso e fazem parte do registo de auditoria:

* Adicione notas com texto livre
* Mencione membros da equipa pelo e-mail para os notificar
* Consulte o histórico completo de comentários, com o autor e a data e hora

## Próximos passos

> [card] [Visão geral da verificação de empresas](https://docs.didit.me/pt/business-verification/overview.md)
>
> Como funcionam as sessões de verificação de empresas, de ponta a ponta.

> [card] [Guia da consola](https://docs.didit.me/pt/business-verification/console.md)
>
> Gestão de perfis de empresa e sessões na Business Console.

> [card] [Referência da API](https://docs.didit.me/pt/management-api/businesses/list.md)
>
> Endpoints da API de gestão de empresas.


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