> ## 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 Verificação de Empresas (KYB): Registo e UBO > Didit: verifique empresas com registos, UBO, triagem de administradores e AML. A partir de $2.00 por verificação, sem contratos. A Verificação de empresas (KYB) da Didit permite verificar empresas e entidades jurídicas antes de as integrar na sua plataforma. O sistema automatiza as consultas aos registos de empresas, identifica os beneficiários efetivos e os administradores, faz a triagem de todas as partes em listas de vigilância AML e recolhe os documentos de suporte, tudo num único fluxo de verificação. Cada empresa verificada é acompanhada como um [perfil empresarial](https://docs.didit.me/pt/business-verification/business-profiles.md), que agrega os resultados de todas as sessões. Esta lição da Didit Academy acompanha uma verificação de empresa do início ao fim: o painel KYB, a consulta ao registo, os acionistas e UBOs, a triagem AML e aquilo que o representante da empresa vê do seu lado. [Verificar uma empresa (KYB), do início ao fim: Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1) Novo no KYB da Didit? Comece pelo [início rápido](https://docs.didit.me/pt/business-verification/quickstart.md) para uma visita guiada de 10 minutos do início ao fim e leia depois o [guia de integração](https://docs.didit.me/pt/business-verification/integration-guide.md) para padrões de produção. Para o modelo de entidade Business subjacente (com ligações a Utilizadores, listas de bloqueio, importação e exportação), veja [Empresas](https://docs.didit.me/pt/entities/businesses/overview.md). ## Como funciona **1. Criar uma sessão empresarial** Inicie uma verificação de empresas criando uma sessão com um **fluxo KYB**. Quando o tipo de fluxo é KYB, a Didit cria automaticamente uma sessão empresarial: ```bash theme={null} curl -X POST https://verification.didit.me/v3/session/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "workflow_id": "your-kyb-workflow-id", "vendor_data": "company-123" }' ``` O tipo de sessão é determinado pelo fluxo, sem necessidade de campos adicionais. Os fluxos KYB criam automaticamente sessões empresariais com as funcionalidades específicas para empresas ativadas. **2. Consulta ao registo de empresas** A Didit consulta os registos oficiais de empresas nos níveis **Lite**, **Shareholders** ou **UBOs**, cada um com preço por país; veja [preços dos registos](https://docs.didit.me/pt/getting-started/kyb-registry-pricing.md). O nível Lite obtém: | Dados | Descrição | | - | - | | **Nome da empresa** | Nome legal tal como registado | | **Número de registo** | Número oficial de registo da empresa | | **País** | País de constituição | | **Estado** | Ativa, dissolvida, cancelada do registo, etc. | | **Tipo de empresa** | Ltd, LLC, PLC, SA, GmbH, etc. | | **Data de constituição** | Data em que a empresa foi registada | | **Morada registada** | Morada oficial da sede | | **Número de identificação fiscal** | Número de identificação fiscal (quando disponível) | Os dados do registo são cruzados com as informações fornecidas para detetar inconsistências. **3. Pessoas-chave: UBO, acionistas, administradores e representantes** O sistema identifica todas as pessoas e entidades coletivas ligadas à empresa, no modelo unificado de **Pessoas-chave**: * **UBO**: pessoas singulares que, em última instância, detêm ou controlam a empresa, com as respetivas percentagens de propriedade e de voto * **Acionistas** (pessoas singulares e coletivas): cada um com a respetiva percentagem de participação * **Administradores, representantes, secretários, signatários autorizados e outras funções de administrador ou dirigente**: com a respetiva etiqueta de função * **Camadas de propriedade societária**: empresas-mãe na cadeia de propriedade, com KYB aninhado opcional Uma mesma pessoa pode ter várias etiquetas de função (por exemplo, administrador **e** acionista). Cada função é configurada individualmente no fluxo: quais as funções que exigem KYC, qual o fluxo KYC a utilizar e se o utilizador final pode dispensar a verificação. Saiba mais em [Pessoas-chave](https://docs.didit.me/pt/business-verification/key-people.md) e [Propriedade](https://docs.didit.me/pt/business-verification/ownership.md). **4. Triagem AML** Todas as partes identificadas são automaticamente sujeitas a triagem contra listas de vigilância AML globais: * **AML da Empresa**: faz a triagem da entidade da empresa contra listas de sanções, notícias adversas e listas de medidas de execução regulamentar * **AML da Pessoa**: faz a triagem de cada pessoa-chave (UBO, acionista, administrador, representante, etc.) individualmente * Utiliza o mesmo [sistema de duas pontuações](https://docs.didit.me/pt/core-technology/aml-screening/overview.md) (pontuação de correspondência + pontuação de risco) que a verificação de utilizadores **5. Recolha de documentos** Recolha e verifique os documentos de suporte: | Tipo de documento | Exemplos | | - | - | | **Certidão de constituição** | Certificado de constituição da sociedade | | **Pacto social** | Estatutos, memorando de constituição | | **Comprovativo de morada** | Faturas de serviços e extratos bancários da morada registada | | **Registo de acionistas** | Registo oficial de acionistas | | **Demonstrações financeiras** | Contas anuais, relatórios de auditoria | | **Certidões fiscais** | Certidões de inscrição ou de conformidade fiscal | | **Documentos personalizados** | Quaisquer documentos adicionais exigidos pelo seu processo de conformidade | Os analistas podem solicitar documentos adicionais à empresa durante o processo de análise. **6. Análise e decisão** A sessão empresarial recebe um estado geral com base em todas as verificações: | Estado | Significado | | - | - | | **Aprovado** | Todas as verificações foram concluídas com sucesso: a empresa está verificada | | **Em análise** | Uma ou mais verificações requerem revisão manual | | **Recusada** | Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada) | Os analistas podem rever todos os dados recolhidos na Business Console, adicionar comentários, solicitar documentos adicionais e tomar a decisão final. ## Ciclo de vida da sessão de empresa Cada verificação de empresa decorre numa **sessão de empresa** que acompanha o progresso pelos seguintes estados: | Estado | Descrição | | - | - | | `"Not Started"` | Sessão criada, mas a verificação ainda não começou | | `"In Progress"` | A verificação está em curso: consultas ao registo, triagem AML ou recolha de documentos a decorrer | | `"Approved"` | Todas as verificações foram aprovadas: a empresa está verificada | | `"Declined"` | Uma verificação crítica falhou (por exemplo, empresa dissolvida ou entidade sancionada) | | `"In Review"` | Uma ou mais verificações exigem revisão manual por um analista | | `"Resubmitted"` | Sessão recusada anteriormente e reenviada com dados atualizados | Cada sessão tem um `session_id` único, um `session_number` sequencial e um `session_token` para a ligação de verificação alojada. Quando uma sessão é criada com um identificador `vendor_data`, a Didit associa-a automaticamente ao [perfil de empresa](https://docs.didit.me/pt/business-verification/business-profiles.md) correspondente. ## Estados das funcionalidades A verificação de empresas acompanha o estado de cada componente de forma independente: | Funcionalidade | Descrição | | - | - | | **Verificação de registo** | Consulta ao registo de empresas e extração de dados | | **AML da Empresa** | Triagem AML ao nível da empresa, contra listas de sanções e de vigilância | | **Documentos** | Recolha de documentos, OCR e cruzamento de informação | | **Pessoas-chave** | Identificação de beneficiários efetivos e responsáveis, AML e KYC | Cada funcionalidade pode estar em: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` ou `"Resub Requested"`. O estado geral da sessão resulta da agregação dos estados individuais das funcionalidades: a sessão só fica `"Approved"` quando todas as funcionalidades obrigatórias forem aprovadas. ## Eventos de webhook As sessões de empresa geram os seguintes eventos de webhook: | Evento | Acionador | | - | - | | `status.updated` | O estado da sessão mudou. O payload inclui `session_kind: "business"` nas sessões KYB. | | `data.updated` | Um revisor editou os dados do registo ou as Pessoas-chave na consola, ou o registo comunicou uma alteração. O payload inclui `session_kind: "business"`. Acompanhe o progresso através de `status.updated`. | | `business.status.updated` | O estado da [entidade empresarial](https://docs.didit.me/pt/entities/businesses/overview.md) associada mudou (`ACTIVE` / `FLAGGED` / `BLOCKED`). | | `business.data.updated` | Os campos do perfil ou os contadores agregados da entidade de empresa associada foram alterados. | Os payloads dos webhooks incluem `session_kind: "business"` e o `business_session_id` para os distinguir dos eventos de verificação de utilizadores. Consulte [Webhooks](https://docs.didit.me/pt/integration/webhooks.md) para a verificação da assinatura e os detalhes de entrega. ## Principais capacidades | Capacidade | Descrição | | - | - | | **Consultas automáticas ao registo** | Consulta aos registos oficiais de empresas nos países suportados, nos níveis Lite, Shareholders ou UBOs, [com preço por país](https://docs.didit.me/pt/getting-started/kyb-registry-pricing.md) | | **Identificação de UBO** | Extração automática das estruturas de propriedade efetiva, com percentagens | | **Triagem de responsáveis** | Identificação e verificação de administradores, secretários e outros responsáveis | | **AML da Empresa** | Triagem da entidade empresarial contra listas de sanções e de vigilância | | **AML de pessoas** | Triagem AML de todos os UBOs e responsáveis identificados, individualmente | | **Ligação KYC** | Ligação de cada pessoa identificada a uma sessão de Verificação de utilizadores (KYC) para verificação de identidade | | **Recolha de documentos** | Pedidos de documentos estruturados, com acompanhamento dos carregamentos | | **Cruzamento OCR** | Extração de dados dos documentos carregados e cruzamento com os dados do registo | | **Perfis de empresa** | Criação automática de perfis e agregação de sessões para cada empresa verificada | | **Estados por funcionalidade** | Acompanhamento independente do estado do registo, da AML, dos documentos e das pessoas-chave | | **Avaliação de risco** | Etiquetas de aviso em cada verificação e ações do fluxo que convertem o estado da empresa, os resultados AML e as conclusões sobre a propriedade num resultado | | **Webhooks** | Receção de eventos do ciclo de vida da sessão e de atualização de dados em tempo real, através de [webhooks](https://docs.didit.me/pt/integration/webhooks.md) | ## Sessões de empresa vs. sessões de utilizador | Funcionalidade | Sessão de utilizador | Sessão de empresa | | - | - | - | | **Alvo** | Pessoa individual | Empresa ou entidade jurídica | | **Tipo de sessão** | `user` (predefinido) | `business` | | **Verificações principais** | Verificação de identidade, prova de vida, correspondência facial, AML | Consulta ao registo, UBO, responsáveis, AML da Empresa | | **Verificações adicionais** | Verificação de telefone, verificação de e-mail, comprovativo de morada, verificação NFC | Recolha de documentos, AML de pessoas, ligação KYC | | **Payloads de webhook** | Eventos de sessão padrão | Incluem `session_kind: "business"` e `business_session_id` | ## Próximos passos > [card] [Perfis de empresa](https://docs.didit.me/pt/business-verification/business-profiles.md) > > Acompanhe empresas em várias sessões com perfis, etiquetas e operações em massa. > [card] [Dados da empresa](https://docs.didit.me/pt/business-verification/company-data.md) > > Consultas ao registo, estado da empresa e cruzamento de dados. > [card] [Estrutura de propriedade](https://docs.didit.me/pt/business-verification/ownership.md) > > Identificação de UBO, acionistas societários e cadeias de propriedade. > [card] [Responsáveis e administradores](https://docs.didit.me/pt/business-verification/officers.md) > > Identificação de administradores, funções e ligação KYC. > [card] [Triagem AML](https://docs.didit.me/pt/business-verification/aml.md) > > Verificações AML ao nível da empresa e de pessoas. > [card] [Documentos](https://docs.didit.me/pt/business-verification/documents.md) > > Recolha de documentos, pedidos e verificação OCR. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.