Pular para o conteúdo principal

​
Cadeia societária até o beneficiário final

O módulo ubo_chain é o que sobe a cadeia quando um sócio da empresa é outra empresa: nível a nível, até as pessoas naturais que de fato a controlam, com o percentual acumulado de cada uma pelo caminho. É a pergunta da IN RFB 2.119/2022 e da Circular BCB 3.978/2020: quem detém 25% do capital, direta ou indiretamente, e quem exerce o controle. Ele exige a Participação Societária no mesmo flow, que é de onde vem o percentual de cada sócio.
Cobrança por empresa efetivamente subida, com teto que é seu. O preço unitário multiplica o número de empresas que precisaram ser consultadas, até o teto que você define no flow (o custo máximo aparece na tela antes de salvar, e nunca é ultrapassado). Empresa sem sócio pessoa jurídica não sobe nada e não custa nada, e empresa que a fonte não conseguiu responder também não entra na conta. Por sessão, a chave policy.ubo_max_paid_nodes só aperta esse teto: pedir mais que o do flow é 422 policy_ubo_cap_above_flow.
Os campos de dinheiro não são decoração: o motivo ubo_node_budget_exhausted (o seu teto mordeu, e você sabe exatamente quanto custaria subir mais) e o motivo ubo_source_unavailable (a fonte caiu, não cobra, tente de novo) leriam igual sem cap e nodes_charged ao lado. O motivo account_usage_limit diz que o limite de uso da conta segurou a subida: a empresa não consultada não é cobrada, e o limite volta às 00:00 UTC. Quando a cadeia não fecha, a resposta diz por quê: teto atingido, ciclo societário, sócia estrangeira sem CNPJ publicado ou fonte fora do ar. ubos: [] com status: "partial" lê-se não consegui subir, jamais não há beneficiário final, e candidates_over_threshold: null (nunca 0 por omissão) é a outra metade da mesma honestidade. O módulo informa e não reprova ninguém: estrutura societária opaca é um fato sobre o registro público, não uma acusação contra quem está se verificando.