MÉTODO DE DERIVAÇÃO — OPERAÇÕES DE FINANCIAMENTO DO BNDES NO CNPJ.AI
Versão do método: 1 (schema BNDES 5)
Licença da base e desta derivação: ODbL 1.0
Texto da licença: https://opendatacommons.org/licenses/odbl/1-0/
Página pública: https://cnpj.ai/metodologia/bndes

1. FONTES

- Operações indiretas automáticas:
  https://dadosabertos.bndes.gov.br/dataset/operacoes-financiamento/resource/612faa0b-b6be-4b2c-9317-da5dc2c0b901
- Operações não automáticas:
  https://dadosabertos.bndes.gov.br/dataset/operacoes-financiamento/resource/6f56b78c-510f-44b6-8274-78a5b7e931f4
- Cadastro Nacional da Pessoa Jurídica da Receita Federal, fotografia mensal
  vigente no cnpj.ai.

Os CSVs BNDES são lidos como CP1252, separados por ponto e vírgula. A carga
valida a presença de todas as colunas usadas antes de substituir a fotografia.
ETag e Last-Modified identificam a versão remota.

2. OPERAÇÕES NÃO AUTOMÁTICAS

O CNPJ completo publicado pelo BNDES é limpo apenas de pontuação conhecida e
validado pelos dígitos verificadores. Linhas sem CNPJ de pessoa jurídica válido
não são vinculadas. O documento original permanece em documento_fonte e o
método recebe o valor cnpj_publicado.

3. OPERAÇÕES AUTOMÁTICAS — VÍNCULO INFERIDO

O BNDES publica documento mascarado. Para cada par CLIENTE + CPF_CNPJ:

a) CLIENTE conserva os espaços internos publicados; somente espaços externos
   são removidos. Não há busca aproximada, remoção de acentos ou normalização
   unilateral do nome.
b) A razão social é comparada por igualdade com empresa.razao_social da Receita.
c) Para todos os estabelecimentos dessa empresa, pontuação da máscara é
   removida; cada caractere visível deve coincidir e somente "*" é curinga.
d) Todos os CNPJs candidatos são contados antes de qualquer exclusão. O par só
   avança quando existe exatamente um CNPJ completo distinto.
e) data_inicio_atividade deve ser uma data real no formato AAAAMMDD e não pode
   ser posterior a data_da_contratacao.
f) Mesmo sendo único, o candidato é omitido quando natureza_juridica é 2135
   (Empresário Individual), 4014 (Empresa Individual Imobiliária), 4090
   (Candidato a Cargo Político Eletivo) ou 4120 (Produtor Rural Pessoa Física).

O resultado aceito recebe metodo_vinculo=nome_mascara_unicos_receita. O CNPJ
inferido é publicado separadamente como cnpj_vinculado; nunca é rotulado como
CNPJ fornecido pelo BNDES. Casos sem candidato, ambíguos, temporais ou ligados
a pessoa natural ficam fora dos resultados por CNPJ.

4. NORMALIZAÇÃO DOS CAMPOS

- Espaços externos e repetições de whitespace são limpos nos campos exibidos.
- Valores formados apenas por hífens viram campo ausente.
- Decimais brasileiros são convertidos para número; vazio permanece nulo.
- Juros e prazos vazios permanecem nulos; zero publicado permanece zero.
- Datas não vazias fora de AAAA-MM-DD, DD/MM/AAAA ou AAAAMMDD abortam a carga.
- CNPJ da instituição financeira só é mantido com dígitos verificadores válidos.
- Linhas idênticas são preservadas: como a fonte não publica identificador único
  para todas as operações, o ID combina hash de todos os campos e ocorrência.

São preservados, quando informados: tipo, cliente, projeto, localização, contrato,
data, valores contratado e desembolsado, fonte do recurso, custo financeiro,
juros, carência, amortização, modalidade e forma de apoio, produto, instrumento,
inovação, área operacional, setores CNAE/BNDES, porte, natureza, instituição
financeira, garantia, excepcionalidade e situação.

5. AGREGAÇÃO E ESCOPO

Na ficha pública, operações são filtradas pelo CNPJ completo. Registros é a
contagem de linhas vinculadas. Contratos conta somente números de contrato
distintos e não vazios, existentes na fonte não automática. Valores são somas
separadas de contratado e desembolsado; contagens de valores ausentes também
são publicadas. No grafo, o resumo é explicitamente do grupo de CNPJ básico.

6. ATUALIZAÇÃO E AUDITORIA

As duas fontes formam uma fotografia única. Uma fonte truncada, com coluna
obrigatória ausente ou volume muito abaixo do esperado aborta a troca. As novas
tabelas são construídas em staging e substituídas numa transação. Em falha, a
última fotografia íntegra é preservada e marcada como desatualizada.

Esta especificação contém as alterações aplicadas à base para fins da seção
4.6(b) da ODbL 1.0. Pode ser copiada, usada e adaptada sob a ODbL 1.0.