Brazil B2B CNPJ Company, Partners (QSA), CNAE & Simples Lead Enricher

Batch Brazilian CNPJ Validator (Modulo 11) and B2B Corporate Lead Enricher. Extracts official Receita Federal company registration data, Quadro de Sócios e Administradores (QSA / Partners & Directors), Primary and Secondary CNAEs, Share Capital (Capital Social), Simples Nacional / MEI tax status, and public contact information via BrasilAPI with automatic high-availability fallback to OpenCNPJA.

---

Key Features (EN)

• Zero-Cost Mathematical Modulo 11 Pre-Validation: Calculates both CNPJ check digits using official Receita Federal weights ([5,4,3,2,9,8,7,6,5,4,3,2] and [6,5,4,3,2,9,8,7,6,5,4,3,2]) and rejects repeated-digit sequences (11.111.111/1111-11) before spending network bandwidth.
• Dual-Provider Redundancy: Queries https://brasilapi.com.br/api/cnpj/v1/{cnpj} as primary source and seamlessly fails over to https://open.cnpja.com/office/{cnpj} if rate-limited or unavailable.
• Full Corporate Hierarchy (QSA): Extracts partner names, qualification roles, entry dates, age brackets, and masked tax IDs (sociosCount + qsa array).
• Tax & Sector Classification: Captures Primary CNAE (cnaePrincipalCodigo, cnaePrincipalDescricao), Secondary CNAEs (cnaesSecundarios), opcaoPeloSimples, opcaoPeloMei, and capitalSocialBRL.
• LLM & MCP Ready (markdownCompanyDossier): Generates a clean Markdown corporate intelligence report for each CNPJ, ready for AI agents, RAG pipelines, and CRM enrichment.

---

Recursos Principais (PT-BR)

• Validação Matemática Módulo 11 Nativa: Calcula de forma determinística os 2 dígitos verificadores do CNPJ e bloqueia sequências repetidas (00.000.000/0000-00 a 99.999.999/9999-99) antes de efetuar requisições de rede.
• Alta Disponibilidade (BrasilAPI + OpenCNPJA): Consulta primária na BrasilAPI com fallback imediato para OpenCNPJA, garantindo enriquecimento B2B contínuo sem necessidade de chaves pagas.
• Quadro Societário Completo (QSA): Mapeia todos os sócios e administradores, cargos/qualificações, faixas etárias e datas de entrada na sociedade.
• Enquadramento Tributário e CNAE: Identifica opção pelo Simples Nacional, MEI, Porte da Empresa, Natureza Jurídica, Capital Social em Reais (BRL) e atividades econômicas (CNAE Fiscal principal e secundários).
• Dossiê Corporativo em Markdown (markdownCompanyDossier): Entrega um relatório estruturado pronto para consumo por agentes de IA (MCP Server), automações de vendas B2B, KYC/Compliance e CRMs (HubSpot, Pipedrive, Salesforce).

---

Input Parameters

Field	Type	Default	Description
cnpjs	array (stringList)	["00.000.000/0001-91", "33.000.167/0001-01"]	List of Brazilian CNPJ numbers (formatted or raw digits) to validate and enrich.
includeSecondaryCnaes	boolean	true	Include all secondary economic activities (cnaesSecundarios) in the dataset and dossier.
timeoutSeconds	integer	15	HTTP timeout in seconds per API request (3 to 60s).
maxResults	integer	100	Maximum number of CNPJs to process in a single run.

---

Output Example

{
  "cnpj": "00000000000191",
  "cnpjFormatted": "00.000.000/0001-91",
  "isValidMod11": true,
  "status": "ENRICHED",
  "dataSource": "BrasilAPI",
  "razaoSocial": "BANCO DO BRASIL SA",
  "nomeFantasia": "DIRECAO GERAL",
  "situacaoCadastral": "ATIVA",
  "cnaePrincipalCodigo": "6421200",
  "cnaePrincipalDescricao": "Bancos comerciais",
  "capitalSocialBRL": 120000000000.0,
  "opcaoPeloSimples": false,
  "opcaoPeloMei": false,
  "uf": "DF",
  "municipio": "BRASILIA",
  "sociosCount": 10,
  "qsa": [
    {
      "nomeSocio": "TARCIANA PAULA GOMES MEDEIROS",
      "qualificacaoSocio": "Presidente",
      "faixaEtaria": "41 a 50 anos",
      "dataEntradaSociedade": "2023-01-16",
      "identificadorDeSocio": "2",
      "cnpjCpfDoSocio": "***456789**"
    }
  ],
  "markdownCompanyDossier": "# Dossiê Corporativo B2B — BANCO DO BRASIL SA (00.000.000/0001-91)..."
}