Mapeie a cadeia societária até quem controla de fato
Holding dentro de holding é a forma mais comum de o controlador de uma empresa não aparecer no quadro dela. Este módulo segue cada sócio pessoa jurídica para cima, empresa por empresa, e devolve as pessoas naturais que estão no topo com a participação indireta calculada pelo caminho.
Sobe a cadeia societária da empresa quando um sócio dela é outra empresa, nível a nível, até chegar nas pessoas que de fato a controlam, com o percentual acumulado de cada uma pelo caminho. É a pergunta que a Instrução Normativa 2.119 da Receita e a Circular 3.978 do Banco Central fazem: quem detém 25% do capital, direta ou indiretamente, e quem exerce o controle. Cobra por empresa efetivamente subida, e o teto de empresas por verificação é você quem define no fluxo: o custo máximo aparece na tela antes de você salvar, e nunca é ultrapassado. Empresa sem sócio pessoa jurídica não sobe nada e não custa nada. Quando a cadeia não fecha, a resposta diz por quê: o seu teto foi atingido, o quadro tem ciclo societário, a sócia é estrangeira e não publica CNPJ, ou a fonte não respondeu. Isso nunca é entregue como "não há beneficiário final": cadeia incompleta é dita como incompleta. O módulo informa e não reprova ninguém, porque uma estrutura societária opaca é um fato sobre o registro público, não uma acusação contra quem está se verificando. Exige a Participação Societária no mesmo fluxo, que é de onde vem o percentual de cada sócio.
- CNPJ - Participação Societária
- OCR do CNPJ
- Cadeia Societária
"status": "approved"Para quem é
Serve a quem precisa identificar beneficiário final de cliente pessoa jurídica: bancos, instituições de pagamento, corretoras, plataformas de ativos virtuais, securitizadoras. É a pergunta que o regulador faz sobre quem detém, direta ou indiretamente, fatia relevante do capital, e a resposta deixa de ser pesquisa manual em vários cartões CNPJ.
Serve também a quem analisa grupo econômico antes de conceder crédito ou fechar contrato grande. Ver que duas empresas aparentemente independentes terminam nas mesmas pessoas muda a exposição total que você aceita, e o caminho de cada uma fica registrado na verificação.
O que você recebe
O bloco ubo_tree traz status, complete ou partial, chain_complete, a lista ubos com nome, documento mascarado, effective_percent e path, o caminho de empresas até a pessoa, e a contagem de pessoas que passam da participação relevante. Participação circular, quando existe, aparece em cycles.
Junto vêm os campos de dinheiro: nodes_charged, unit_cents, charged_cents e cap. Eles são a diferença entre ler ubo_node_budget_exhausted, o seu teto parou a subida e você sabe quanto custaria ir além, e ubo_source_unavailable, a fonte caiu, a empresa não foi cobrada e vale tentar de novo.
O módulo ubo_profundo sobe a cadeia societária nível a nível até as pessoas naturais que controlam a empresa, com o percentual acumulado.
O módulo se chama ubo_profundo no flow e no webhook.
Como entra no seu flow
No mesmo flow, ele liga junto: CNPJ - Participação Societária, OCR do CNPJ.
O teto de empresas por verificação é configurado no flow, e o painel mostra o custo máximo antes de salvar. Por sessão, policy.ubo_max_paid_nodes só pode apertar esse teto: pedir mais do que o flow permite volta 422 policy_ubo_cap_above_flow. Empresa sem sócio pessoa jurídica encerra a subida no primeiro nível e não gera cobrança.
O módulo informa e não reprova ninguém. Leia status: partial com ubos vazio como cadeia que não foi possível subir inteira, nunca como ausência de beneficiário final, e mande esses casos para a sua diligência manual com o motivo que veio em reason.
O grupo do módulo
Documento societário enviado em PDF, sem câmera. O CNPJ consultado é o do próprio documento.
Preço
R$ 18,56por empresa da cadeia
Cobrado por empresa da cadeia efetivamente subida: uma verificação custa este valor multiplicado pelo número de empresas que precisaram ser consultadas, até o teto que você define no fluxo (o custo máximo aparece na tela antes de salvar). Empresa sem sócio pessoa jurídica não sobe nada e não é cobrada, e empresa que a fonte não conseguiu responder também não entra na conta.
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoPor que a cadeia às vezes para antes das pessoas naturais?
A resposta sempre diz qual foi o motivo: o seu teto de empresas foi atingido, o quadro tem participação circular, uma sócia é estrangeira e não publica CNPJ, ou a fonte não respondeu. Cada um pede uma ação diferente do seu analista, e nenhum deles vira acusação contra quem se verificou.
Quanto uma verificação pode custar neste módulo?
No máximo o valor unitário vezes o teto que você definiu, e o painel mostra esse número antes de salvar o flow. Empresa cujo quadro só tem pessoas físicas não sobe nada e não custa nada.
Como apresento a árvore ao meu analista?
O campo path já vem na ordem da subida, da empresa verificada até a pessoa, então basta desenhar cada caminho como uma trilha de nomes com o percentual acumulado ao lado. Documento de pessoa chega mascarado, o suficiente para conferir com o que o cliente declarou.

Crie a conta, monte um flow com este módulo e rode a verificação inteira no ambiente de teste, sem consumir saldo.

