/compliance/due-diligence/vinculos (com ?analise=<id> abre direto uma análise salva) · "Teia de Vínculos" (bloco "Due Diligence" do menu lateral do Compliance); também por "Abrir na Teia de Vínculos" na análise de compliance de um processodue_diligence.visualizar (o servidor recusa as consultas sem ela). "Indexar cadastro de fornecedores": due_diligence.bases_gerenciar. Excluir uma análise salva: due_diligence.excluir (o botão aparece para todos, mas o servidor recusa sem a chave).Para que serve
Monta a rede societária (a "teia") de empresas e pessoas a partir do quadro de sócios da Receita Federal e procura vínculos entre elas. Usos típicos:
- abrir a rede de UM CNPJ para ver sócios, empresas dos sócios, sócios dessas empresas, e assim por diante;
- cruzar dois ou mais CNPJs/CPFs (por exemplo, as empresas que concorrem num processo e a própria instituição) para achar pontos de contato — alguém ligado a mais de uma delas — e receber um parecer de conflito de interesse redigido pela IA, com pesquisa em fontes abertas da internet.
Cada consulta fica salva com a rede como estava no dia, porque o índice societário muda todo mês.
Termos simples:
- Elo — distância na rede: a empresa consultada é o elo 0; os sócios dela, o 1º elo; as outras empresas desses sócios, o 2º; e assim por diante.
- Ponto de contato — pessoa ou empresa alcançada a partir de duas ou mais partes consultadas. É o achado principal: indica possível conflito de interesse ou combinação entre concorrentes.
- Miolo do CPF — a Receita publica o CPF dos sócios mascarado; só os 6 dígitos do meio são conhecidos. Uma pessoa é identificada por nome + miolo, e homônimos com o mesmo miolo podem se confundir.
- Índice societário nacional — a base com o quadro de sócios de todas as empresas do país (cerca de 28 milhões de vínculos), recarregada mensalmente; é o que permite passar do 1º elo.
- JUCESP — Junta Comercial de São Paulo; publica também empresas já encerradas, que a Receita não mostra.
A tela, marcação por marcação
As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.
Visão geral da tela

- Aparece quando: você tem
due_diligence.bases_gerenciar. - O que faz: busca na Receita o quadro societário dos fornecedores cadastrados que ainda não estão no índice, em lotes de 40 (até 25 lotes por clique), e os incorpora à teia. Mostra "Indexando…".
- Mensagens: "Cadastro indexado" — "N fornecedor(es) tiveram o quadro societário incorporado ao índice." · "Erro ao indexar" (ex.: "Sem permissão para indexar o cadastro de fornecedores.").
- O que faz: recarrega a análise salva exatamente como estava (rede, pontos de contato, parecer), refaz a lista de partes e a profundidade. Mensagem: "Análise recuperada" — "Rede como estava em <data e hora>." · erro: "Erro ao abrir a análise".
Análise salva aberta (partes, rede e relatório) (mais abaixo na tela)

- Aparece quando: há pontos de contato que são pessoas (no máximo as 10 primeiras).
- O que faz: procura na Junta Comercial de São Paulo as empresas dessas pessoas, inclusive as inativas. Consulta paga, cobrada por pessoa. Mostra "Consultando a JUCESP…".
- Mensagens: "Consulta à JUCESP concluída" — "N empresa(s) encontrada(s) para M pessoa(s)." · "Erro na consulta à JUCESP" (ex.: "Informe ao menos uma pessoa para pesquisar na JUCESP.").
Análise salva aberta (partes, rede e relatório)

- Tira a parte da consulta.
- Aparece quando: há ao menos uma parte. Fica apagado enquanto outra consulta roda.
- O que faz: expande a rede até a profundidade escolhida e mostra o desenho. Grava os vínculos novos no índice e salva a análise no histórico. Se nada for achado: "Nenhum vínculo encontrado" — "A Receita não retornou quadro societário para este CNPJ."
- Se der errado: "Erro ao abrir a teia" — por exemplo "Adicione ao menos um CNPJ ou CPF.", "Informe ao menos um CNPJ ou uma pessoa.", "Máximo de 12 partes por consulta.", "Sem permissão para consultar a teia.".
- Aparece quando: 2+ partes.
- O que faz: abre a rede de todas as partes, calcula os pontos de contato e pede à IA o parecer de conflito de interesse e a pesquisa em fontes abertas. A rede aparece logo ("Teia montada" — "O parecer da IA está sendo gerado e aparece aqui em 1 a 4 minutos."); o parecer chega depois ("Parecer da IA pronto" — "A análise de conflito foi concluída."). Se passar do tempo: "O parecer está demorando" — "A análise segue em segundo plano — confira o histórico em alguns minutos.". Se a IA falhar: "Teia montada, sem parecer automático" — <motivo>.
- Se der errado: "Erro na análise" — por exemplo "A análise cruza partes entre si — adicione ao menos dois documentos.".
- Aparece quando: há resultado na tela.
- O que faz: baixa o PDF com as partes, a profundidade, a rede, os pontos de contato, o parecer da IA e a pesquisa aberta (ou o erro da IA) e os números de cobertura. Mensagens: "Relatório gerado" — "O PDF foi baixado." · "Erro ao gerar o PDF".
O que faz: busca na Receita o quadro societário dos fornecedores cadastrados que ainda não estão no índice, em lotes de 40 (até 25 lotes por clique), e os incorpora à teia. Mostra "Indexando…".
Explicado em detalhes na Figura 1.
Pontos de contato com pessoa (JUCESP) (mais abaixo na tela)

Tira a parte da consulta.
Explicado em detalhes na Figura 3.
O que faz: expande a rede até a profundidade escolhida e mostra o desenho. Grava os vínculos novos no índice e salva a análise no histórico. Se nada for achado: "Nenhum vínculo encontrado" — "A Receita não retornou quadro societário para este CNPJ."
Explicado em detalhes na Figura 3.
O que faz: abre a rede de todas as partes, calcula os pontos de contato e pede à IA o parecer de conflito de interesse e a pesquisa em fontes abertas. A rede aparece logo ("Teia montada" — "O parecer da IA está sendo gerado e aparece aqui em 1 a 4 minutos."); o parecer chega depois ("Parecer da IA pronto" — "A análise de conflito foi concluída."). Se passar do tempo: "O parecer está demorando" — "A análise segue em segundo plano — confira o histórico em alguns minutos.". Se a IA falhar: "Teia montada, sem parecer automático" — <motivo>.
Explicado em detalhes na Figura 3.
O que faz: baixa o PDF com as partes, a profundidade, a rede, os pontos de contato, o parecer da IA e a pesquisa aberta (ou o erro da IA) e os números de cobertura. Mensagens: "Relatório gerado" — "O PDF foi baixado." · "Erro ao gerar o PDF".
Explicado em detalhes na Figura 3.
O que faz: busca na Receita o quadro societário dos fornecedores cadastrados que ainda não estão no índice, em lotes de 40 (até 25 lotes por clique), e os incorpora à teia. Mostra "Indexando…".
Explicado em detalhes na Figura 1.
Pontos de contato com pessoa (JUCESP)

O que faz: procura na Junta Comercial de São Paulo as empresas dessas pessoas, inclusive as inativas. Consulta paga, cobrada por pessoa. Mostra "Consultando a JUCESP…".
Explicado em detalhes na Figura 2.
Análises salvas

O que faz: busca na Receita o quadro societário dos fornecedores cadastrados que ainda não estão no índice, em lotes de 40 (até 25 lotes por clique), e os incorpora à teia. Mostra "Indexando…".
Explicado em detalhes na Figura 1.
O que faz: recarrega a análise salva exatamente como estava (rede, pontos de contato, parecer), refaz a lista de partes e a profundidade. Mensagem: "Análise recuperada" — "Rede como estava em <data e hora>." · erro: "Erro ao abrir a análise".
Explicado em detalhes na Figura 1.
Como a tela está organizada (de cima para baixo)
- Título "Teia de Vínculos" (ícone de rede) — "Abra a rede societária de um CNPJ ou cruze vários para apurar conflito de interesse."; à direita, "Indexar cadastro de fornecedores" (só para
due_diligence.bases_gerenciar). - Aviso de cobertura (caixa com "i"):
- com o índice nacional carregado: "A expansão usa o quadro societário nacional da Receita — <N> vínculo(s) — então alcança qualquer empresa do país, não só as já triadas. Duas ressalvas para a leitura: a Receita publica o CPF mascarado, então uma pessoa é identificada pelo nome somado aos 6 dígitos centrais, e homônimos com o mesmo miolo podem se confundir; e sócios que já saíram da sociedade ainda podem constar.";
- sem ele: "O índice societário nacional ainda não foi carregado, então a expansão fica presa aos N vínculo(s) dos fornecedores já triados e não passa do 1º elo. Carregue a base Quadro societário nacional na tela de Bases de Dados."
- Cartão "Consulta":
- campo "CNPJ ou CPF — adicione dois ou mais para cruzar vínculos entre eles" ("00.000.000/0000-00 ou 000.000.000-00"; formata sozinho: até 11 dígitos vira CPF, depois CNPJ; Enter adiciona) e o botão "Adicionar";
- mensagem de erro do campo, em vermelho, logo abaixo;
- as partes adicionadas, em "pílulas" (ícone de prédio ou de pessoa, documento, nome da pessoa) com o "X" "Remover";
- quando o CPF corresponde a mais de uma pessoa, a caixa "De quem se trata?" com um botão por pessoa (nome e "N empresa(s)") e "Cancelar"; às vezes com um aviso acima;
- "Profundidade" — "até o 2º elo" … "até o 6º elo" (padrão: 5º);
- botões "Abrir teia", "Cruzar vínculos" e, depois de um resultado, "Relatório PDF".
- Resultado (depois de abrir, cruzar ou recuperar uma análise):
- "Rede societária" — "N nó(s) · alcançou o Xº elo de Y pedido(s) · Z consulta(s) à Receita · W vínculo(s) novo(s) no índice · truncada no limite de nós"; à direita, a busca "Localizar pessoa ou empresa na teia...". Quando a rede parou antes do pedido, um aviso explica: com índice nacional, "Isso é um resultado, não uma limitação: a busca percorreu o quadro societário nacional e essas empresas não têm mais nenhuma ligação societária a seguir."; sem ele, "…este resultado não permite concluir nada sobre ausência de vínculo.". Abaixo, o desenho da rede (ver "O desenho da rede") e, se houver busca, os nós encontrados ("Nº elo · nome"; até 24, "+N outro(s)"; ou "Nada encontrado na teia aberta.").
- "Pontos de contato entre as empresas (N)" (só com 2+ CNPJs) — "Onde os caminhos das empresas consultadas se encontram pela primeira vez." (e quantos outros nós ficaram de fora por serem só derivados); o botão "Aprofundar na JUCESP (N pessoa(s))" com a explicação; a tabela "Nó" · "Tipo" ("Empresa"/"Pessoa") · "Documento" · "Elo" · "Alcançado por" (quais partes chegam a ele). Sem pontos: "Nenhum ponto de contato dentro de N elos e do índice atual. Isso não comprova ausência de vínculo — veja o aviso de cobertura acima."
- Resultado da JUCESP (depois de aprofundar) — aviso da consulta e, por pessoa, as empresas paulistas encontradas (nome, documento, município) com o selo "já na teia" ou "fora da teia — verificar"; "Nenhuma empresa localizada na JUCESP com esse nome."; ou o motivo da indisponibilidade.
- "Parecer de conflito de interesse" (só em "Cruzar vínculos", quando a IA termina) — selos "Risco BAIXO/MEDIO/ALTO/CRITICO" e "Sem impedimento identificado" (verde) ou "Impedimento a concorrer juntas" (vermelho); o resumo; "Vínculos identificados" (gravidade "BAIXA/MEDIA/ALTA", natureza "Sócio em comum", "Cadeia societária", "Administrador em comum", "Possível homônimo", "Outro", descrição e empresas envolvidas); o parecer; "Encaminhamentos sugeridos"; e a nota "Parecer produzido por IA a partir dos vínculos encontrados. Não afirma irregularidade e não substitui decisão da comissão de licitação ou do jurídico."
- "Pesquisa em fontes abertas" — busca na internet por vínculos fora do registro societário (parentesco, sociedade encerrada, endereço em comum, atuação conjunta): resumo e indícios com "Confiança baixa/média/alta", natureza ("Societário fora do registro atual", "Familiar", "Negocial", "Político", "Pessoal", "Outro"), descrição e links das fontes; ou "Nenhum indício consistente foi encontrado fora do registro societário…". Nota: "Indício colhido em fonte aberta não é prova…".
- Enquanto a IA trabalha: "O parecer da IA está sendo gerado — a pesquisa aberta na internet e o cruzamento das teias levam de 1 a 4 minutos. O resultado aparece aqui e fica no histórico."; se a IA falhar, uma faixa vermelha com o motivo.
- "Análises salvas (N)" — explicação de que cada análise guarda a rede do dia; tabela "Análise" (título ou CNPJs, e as razões sociais) · "Nós" · "Elo" (alcançado/pedido) · "Contatos" (número em destaque quando há) · "Risco" · "Quando" (data, hora e quem fez) · ícones pasta "Abrir esta análise" e lixeira "Excluir definitivamente" (só com
due_diligence.excluir). Análise que é o cruzamento automático de um processo não se exclui: a confirmação avisa em amarelo e o servidor recusa ("Esta análise é o cruzamento automático do processo X. Refaça o cruzamento do processo antes de excluí-la."). Mostra as 100 mais recentes, inclusive as feitas automaticamente para os processos do Compras.
O desenho da rede
- Retângulos com "elo - nome" e o documento embaixo. Cores: cheio na cor principal = parte consultada; contorno vermelho = ponto de contato; ícones de prédio (empresa) e pessoa na legenda do canto inferior esquerdo ("consultada", "ponto de contato", "empresa", "pessoa").
- No canto superior esquerdo: "N nós · M elos" e "N ponto(s) de contato".
- Arrastar com o mouse move o desenho. Clicar num nó isola o ramo dele (o resto fica apagado) — aparece "ramo isolado — clique de novo para soltar".
- Botões no canto inferior direito: "Aproximar", "Afastar", "Reenquadrar" (volta a mostrar tudo).
- A busca "Localizar pessoa ou empresa na teia..." destaca os nós que casam.
Situações
| Situação | O que muda |
|---|---|
| Uma parte só | "Cruzar vínculos" fica apagado ("Adicione ao menos dois documentos") |
| Sem índice nacional | Aviso de cobertura limitada; a rede não passa do 1º elo |
| Análise aberta pelo link da análise de processo | A análise salva carrega sozinha ("Análise recuperada") |
Sem due_diligence.bases_gerenciar |
Sem o botão "Indexar cadastro de fornecedores" |
Botões
Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). A seguir, os demais botões desta tela — os que só aparecem em outras situações —, com o que fazem e onde ficam.
"Adicionar"
- Onde fica: à direita do campo de documento. Fica apagado com menos de 11 dígitos.
- O que faz: CNPJ válido entra direto como parte. CPF não abre a teia sozinho: o sistema procura no índice quem tem aquele miolo; se só uma pessoa, ela entra com o nome; se várias, aparece "De quem se trata?" para escolher.
- Mensagens (embaixo do campo): "CNPJ inválido — confira os dígitos." · "Este CNPJ já foi adicionado." · "CPF inválido — confira os dígitos." · "Informe um CPF com 11 dígitos ou um CNPJ com 14." · aviso "Erro ao consultar o CPF".
Lixeira — "Excluir definitivamente"
- O que faz: abre a confirmação "Excluir esta análise de vínculos?".
Janelas
"Excluir esta análise de vínculos?"
- Texto: o título da análise; "A exclusão é definitiva e apaga o registro por completo — a rede societária guardada, os pontos de contato e a análise de risco. Não fica referência nem cópia."; "Se esta análise fundamentou alguma decisão sobre participação de licitante, considere manter o registro: refazer a consulta hoje pode devolver um resultado diferente, porque o índice societário é recarregado mensalmente."
- Botões: "Cancelar" · "Excluir definitivamente" ("Excluindo…").
- Mensagens: "Análise excluída" — "O registro foi removido definitivamente." · "Erro ao excluir" — "Sem permissão para excluir análises de vínculos" (falta
due_diligence.excluir) ou "Análise não encontrada". - Cuidado: se a análise for o cruzamento automático de um processo do Compras, o parecer consolidado daquele processo deixa de poder ser gerado até alguém usar "Refazer o cruzamento" na análise do processo.
Perguntas que as pessoas fazem
- Digitei um CPF e apareceram várias pessoas. → a Receita só publica o miolo do CPF; escolha pelo nome a pessoa certa.
- A rede parou no 1º elo. → o índice nacional não está carregado (veja o aviso no alto e Due Diligence › Bases de Dados).
- Nenhum ponto de contato quer dizer que não há vínculo? → não. Quer dizer que não há vínculo societário dentro do índice e da profundidade escolhida; parentesco e sociedades encerradas aparecem só na pesquisa aberta e na JUCESP.
- O parecer não chegou. → ele segue em segundo plano; reabra pelo histórico "Análises salvas" em alguns minutos.
- Refiz a consulta e deu diferente da semana passada. → o índice é recarregado todo mês; por isso cada análise fica salva com a rede do dia.
- A JUCESP cobra? → sim, por pessoa consultada.
Ligações com outros módulos e telas
- Análise de Compliance do processo (página) — o quadro "Cruzamento de vínculos" de cada processo é uma análise desta tela, feita sozinha quando o Compras envia o processo; o parecer consolidado usa a rede salva.
- Due Diligence › Triagem de Terceiros (lista) — cada triagem grava o quadro societário do CNPJ, que alimenta o índice.
- Due Diligence › Bases de Dados — "Quadro societário nacional (Receita Federal)" e o grafo de vínculos.
- Compras — Cotação de Preços › Respostas Recebidas, planilha consolidada e envio ao Compliance: o envio dispara o cruzamento automático.