> ## 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 UBO: extração de beneficiários finais > A Didit extrai UBOs de registros de empresas com cadeias de propriedade, percentuais e triagem AML. Desde $2.00 por consulta, por país e nível. Identificar quem, em última instância, detém e controla uma empresa é o núcleo do KYB. O Didit obtém a estrutura de propriedade do registro de empresas, quando disponível, permite que o administrador da empresa a confirme e complemente no fluxo hospedado e, em seguida, executa uma verificação adequada à função de cada pessoa-chave. ## Beneficiários finais (UBOs) Um **beneficiário final (UBO, Ultimate Beneficial Owner)** é uma pessoa física que, em última instância, detém ou controla uma pessoa jurídica. Os UBOs aparecem na decisão da sessão em `key_people_checks[].registry.beneficial_owners[]` (obtidos do registro) e em `key_people_checks[].submitted.parties[]` (enviados pelo usuário), junto com qualquer outra função, como acionista ou diretor, na mesma lista. ## Dados coletados para cada pessoa-chave O fluxo hospedado coleta um conjunto padrão de campos, além de quaisquer campos personalizados configurados no fluxo de verificação (workflow). Os campos padrão são: | Campo | Pessoa | Empresa | | - | :-: | :-: | | `name` ou `first_name` + `last_name` | ✅ obrigatório | ✅ obrigatório (`company_name`) | | `email` | ✅ obrigatório | ✅ obrigatório | | `nationality` / país | ✅ obrigatório | ✅ obrigatório | | `role` (uma ou mais por parte) | ✅ obrigatório | ✅ obrigatório | | `ownership_percent` / `voting_percent` (por função) | opcional | opcional | | `date_of_birth` | opcional | — | | `phone_number` | opcional | — | | `position` (cargo em texto livre) | opcional | — | | `registration_number` | — | opcional | | `entity_type` | `person` | `company` | O `entity_type` é definido automaticamente conforme a parte seja uma pessoa física ou uma pessoa jurídica. ### Campos personalizados Os fluxos podem exigir campos adicionais por pessoa ou por empresa, em qualquer quantidade. Eles são configurados no Business Console, no fluxo de KYB, e aparecem no objeto `custom_fields` de cada parte na resposta da decisão. Use campos personalizados para itens como declarações de origem do patrimônio, residência fiscal, IDs internos de clientes ou divulgações específicas do setor. ## Acionistas pessoa jurídica e propriedade em camadas Quando um acionista é, ele próprio, uma empresa (e não uma pessoa física), o Didit registra: * Nome da empresa e número de registro. * Percentual de propriedade detido por esse acionista pessoa jurídica. * País de constituição. Isso permite rastrear a cadeia por várias camadas até as pessoas físicas finais. ### KYB em camadas para UBOs pessoa jurídica Quando o fluxo habilita o KYB em camadas para UBOs pessoa jurídica, cada pessoa jurídica aciona uma subsessão de KYB vinculada: a empresa é verificada pelo mesmo processo que você executa no nível superior, e o resultado é incorporado à sessão principal. Esse recurso vem desativado por padrão; ative-o em cada fluxo. ## Limiares de propriedade A maioria das jurisdições classifica como UBO quem detém **25% ou mais**. O limiar é configurável por fluxo: | Jurisdição | Limiar típico de UBO | | - | - | | UE (AMLD) | 25% de propriedade ou controle | | Reino Unido | 25% das ações ou dos direitos de voto | | EUA (CTA) | 25% de propriedade ou controle substancial | | Singapura | 25% das ações ou do poder de voto | Defina-o em *Workflows → \[fluxo de KYB] → Risk → UBO threshold*. Seu fluxo também pode sinalizar ou encaminhar para revisão quando nenhum UBO atinge o limiar (algo comum em empresas de capital aberto com base acionária pulverizada). ## Direitos de voto e direitos econômicos As declarações de propriedade distinguem dois tipos de controle: | Direito | O que significa | | - | - | | **% econômico (propriedade)** | Participação no valor econômico da empresa / direitos a dividendos | | **% de voto** | Participação no poder de voto nas deliberações dos acionistas | Esses percentuais costumam ser iguais, mas podem divergir quando a empresa emite ações de classes distintas ou ações preferenciais. O Didit registra ambos. Regras e limiares podem verificar qualquer um deles; a maioria das jurisdições exige a divulgação do UBO quando *qualquer um* ultrapassa 25%. ## Propriedade efetiva ao longo de uma cadeia Quando a propriedade passa por um acionista pessoa jurídica, a propriedade efetiva de uma pessoa física mais abaixo na cadeia é calculada multiplicando os percentuais ao longo da cadeia. ### Exemplo: cadeia de 3 camadas ``` Acme Corp (target) └─ 60% → Acme Holdings Ltd └─ 75% → Jane Doe (natural person) └─ 40% → John Smith (natural person) ``` UBOs calculados: * **Jane Doe**: propriedade efetiva da Acme Corp = 60% × 75% = **45%** (UBO). * **John Smith**: propriedade efetiva da Acme Corp = **40%** (UBO). Com um limiar de UBO de 25%, tanto Jane quanto John são divulgados. Com um limiar de 50%, nenhum UBO atinge o limiar, e o Didit sinaliza isso como um problema de transparência. ## Como as configurações de função orientam a verificação Cada função é configurada individualmente em cada fluxo de KYB: habilitada ou desabilitada, se exige KYC, qual fluxo de KYC usar para essa função e se o usuário final pode optar por pulá-la. Quando uma pessoa-chave é enviada: 1. O Didit compara as funções da parte enviada com as configurações de função do fluxo. 2. Para as funções marcadas como exigindo verificação, é iniciada uma sessão de verificação filha: * **Pessoas físicas** → sessão filha de Verificação de usuários (KYC), usando o fluxo de KYC específico da função ou o padrão. * **UBOs pessoa jurídica** (quando o KYB aninhado está habilitado) → subsessão filha de Verificação de empresas (KYB). 3. Para as funções marcadas como opcionais, o usuário final vê a opção "pular verificação" e pode optar por não realizá-la; as partes cuja verificação foi pulada são registradas, mas não bloqueiam a sessão principal. 4. Partes abaixo do limiar de propriedade do fluxo não acionam verificação individual, mesmo que a função normalmente a exija. Configure tudo em *Workflows → \[fluxo de KYB] → Key People* no Business Console. ## Monitoramento de acionistas e UBOs > [!NOTE] > > O monitoramento de registro **chegará em breve**. Nenhum país do catálogo de varejo do ambiente de staging, verificado em 7 de setembro de 2026, tem o monitoramento ativado. A tarifa configurada é de USD 2.00 por empresa por ano; a existência de um preço não significa que o recurso esteja disponível. O comportamento descrito abaixo descreve o serviço planejado após o lançamento. Uma empresa verificada no nível **Acionistas** ou **UBO** pode ser mantida sob **monitoramento contínuo de registro**. O registro envia alterações de situação da empresa, administradores, propriedade e endereço registrado; a cada alteração, a Didit: * move a sessão da empresa de *Aprovado* de volta para *Em revisão*, com a alteração registrada na sessão; * envia um [webhook](https://docs.didit.me/pt-br/business-verification/webhooks.md) `data.updated` com `trigger: "kyb_registry_change"`; * mantém atualizado o cadastro da empresa no registro. O monitoramento **só está disponível nos países que o permitem**: o provedor do registro precisa oferecer acompanhamento para aquela jurisdição. A lista completa está na [tabela de países com monitoramento contínuo](https://docs.didit.me/pt-br/business-verification/supported-countries.md#monitoramento-contínuo-de-registro-de-empresas); uma empresa verificada no nível Lite, ou em um país fora dessa lista, não é incluída no monitoramento, e a página da empresa mostra o motivo. Ative-o por fluxo em *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Ele custa **\$2.00 por empresa por ano**, cobrados na inscrição e em cada renovação anual; quando a carteira não consegue cobrir uma renovação, o monitoramento é interrompido para aquela empresa em vez de continuar sem pagamento. Cancele-o a qualquer momento na página da empresa (*KYB Registry Check → Registry monitoring*). ## Conciliação entre registro e dados enviados pelo usuário A resposta apresenta as duas fontes lado a lado em `key_people_checks[]`: * `registry.officers[]` e `registry.beneficial_owners[]` — o que o provedor divulgou. * `submitted.parties[]` — o que o administrador da empresa enviou explicitamente pelo fluxo, com `source: "USER"`. Os analistas comparam visualmente os dois grupos no console para identificar UBOs ausentes, partes adicionais não divulgadas ou percentuais de propriedade que não batem. Não existe um endpoint de comparação automatizada — você pode fazer a conciliação do seu lado, cruzando nome, função e propriedade quando aplicável. ## Análise AML Cada pessoa-chave identificada é verificada automaticamente em listas de monitoramento AML globais, tanto do lado do registro quanto do lado das informações enviadas. Veja [Análise AML de empresas](https://docs.didit.me/pt-br/business-verification/aml.md) para entender como as verificações AML no nível da empresa e no nível das pessoas se combinam. ## Próximos passos > [card] [Pessoas-chave](https://docs.didit.me/pt-br/business-verification/key-people.md) > > O fluxo de pessoas-chave de ponta a ponta. > [card] [Administradores e representantes](https://docs.didit.me/pt-br/business-verification/officers.md) > > Funções de governança dentro do modelo de pessoas-chave. > [card] [Avaliação de risco](https://docs.didit.me/pt-br/business-verification/risk-assessment.md) > > O que determina o resultado de um KYB. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.