> ## 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 empresas: acompanhe empresas verificadas

> A Didit acompanha empresas verificadas entre sessões com perfis automáticos, status, tags, ações em massa e CSV. A partir de $2.00 por verificação.

A Didit cria automaticamente um perfil de empresa para cada empresa que você verifica, reunindo os dados de verificação e o histórico de sessões em uma ú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 parte específica de KYB do modelo mais geral de **entidade de empresa**. Para o modelo de entidade completo, com operações, vinculação de pessoas-chave a Usuários, funcionamento da lista de bloqueio e importação/exportação, consulte [Visão geral de empresas](https://docs.didit.me/pt-br/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-br/business-verification/overview.md) é enviada com um identificador `vendor_data`. Se já existir um perfil com esse identificador, a nova sessão é vinculada a ele.

| Campo | Descrição |
| - | - |
| **Dados do fornecedor** | Seu identificador exclusivo para esta empresa (por exemplo, `company-123`) |
| **Nome de exibição** | Nome exibido no console |
| **Razão social** | Razão social oficial, obtida do registro ou inserida manualmente |
| **Número de registro** | Número de registro ou de constituição da empresa |
| **País** | País de constituição (ISO 3166-1 alpha-2) |

## Status do perfil

| Status | Descrição |
| - | - |
| `ACTIVE` | A empresa está em situação regular, sem problemas detectados |
| `FLAGGED` | A empresa requer atenção: há resultados a revisar ou verificações pendentes |
| `BLOCKED` | A empresa foi bloqueada para qualquer atividade futura |

Os status podem ser alterados manualmente no console, em massa ou automaticamente com base nos resultados da verificação.

## Métricas de sessão

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

| Métrica | Descrição |
| - | - |
| **Total de sessões** | Número de sessões de verificação desta empresa |
| **Aprovado** | Sessões que passaram em todas as verificações |
| **Recusado** | Sessões que falharam em uma ou mais verificações críticas |
| **Em revisão** | Sessões aguardando a revisão de 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 status, atualização de sessão etc.) |

## Tags

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

## Operações em massa

Gerencie vários perfis de empresa de uma só vez:

| Operação | Descrição |
| - | - |
| **Atualização de status em massa** | Altere o status dos perfis selecionados (ou de todos os perfis que correspondem 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 de um arquivo CSV para criá-los antes da verificação |
| **Exclusão em massa** | Exclua os perfis selecionados e os dados associados a eles |

### Importação de CSV

Para importar perfis de empresa em massa:

1. Baixe o **import template** no console para ver o formato de colunas esperado
2. Preencha o modelo com os dados das suas empresas
3. Envie o arquivo: a Didit cria uma tarefa de importação e processa as linhas de forma assíncrona

Após a conclusão, revise o resumo da importação com a contagem de linhas criadas, atualizadas e com falha. As linhas com falha incluem detalhes específicos do erro.

## Revisões e comentários

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

* Adicione notas com texto livre
* Mencione membros da equipe pelo e-mail para notificá-los
* Veja o histórico completo de comentários, com autor e data e hora

## Próximos passos

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

> [card] [Guia do console](https://docs.didit.me/pt-br/business-verification/console.md)
>
> Gerenciamento de perfis de empresa e sessões no Business Console.

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


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