Mathematical Modulo 11 validator and batch B2B company lead enricher for Brazilian CNPJs via Brazilian federal corporate registries. Extracts Razao Social, Nome Fantasia, Situacao Cadastral, CNAEs, Capital Social, Simples Nacional/MEI status, partners (QSA), and contact details. ### Enterprise B2B Value Proposition (Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher) - **Target B2B Buyers:** FinTech KYB Onboarding Flows, B2B Credit Bureaus, and Enterprise CRM Enrichment Pipelines. - **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization. - **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`Brazilian CNPJ & Partners (QSA) Lead Enriched`). - **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer <TOKEN_REDACTED>` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items`. - **Marketplace Categories:** RapidAPI `Business` | Zyla API Hub `Company Data`. - **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra). - **SEO Keywords:** cnpj-lookup, receita-federal, qsa-ubo-partners, brazil-kyb, company-enrichment, cnae-lookup, b2b-credit-risk.
Mathematical Modulo 11 validator and batch B2B company lead enricher for Brazilian CNPJs via Brazilian federal corporate registries. Extracts Razao Social, Nome Fantasia, Situacao Cadastral, CNAEs, Capital Social, Simples Nacional/MEI status, partners (QSA), and contact details. ### Enterprise B2B Value Proposition (Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher) - **Target B2B Buyers:** FinTech KYB Onboarding Flows, B2B Credit Bureaus, and Enterprise CRM Enrichment Pipelines. - **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization. - **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`Brazilian CNPJ & Partners (QSA) Lead Enriched`). - **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer <TOKEN_REDACTED>` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items`. - **Marketplace Categories:** RapidAPI `Business` | Zyla API Hub `Company Data`. - **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra). - **SEO Keywords:** cnpj-lookup, receita-federal, qsa-ubo-partners, brazil-kyb, company-enrichment, cnae-lookup, b2b-credit-risk.
Every transaction executed by brazil-b2b-cnpj-qsa-lead-enricher produces verifiable event envelopes designed for high-stakes regulatory auditing, ERP master data synchronization, and automated continuous compliance workflows.
Detailed specification of data contracts, domain types, and primary source semantics enforced by brazil-b2b-cnpj-qsa-lead-enricher:
cnpjs (array[string]) • RequiredList of Brazilian CNPJ numbers to validate and enrich.
includeSecondaryCnaes (boolean) • OptionalInclude all secondary economic activities (CNAEs Secundários) in the output record and markdown dossier.
timeoutSeconds (integer) • OptionalHTTP timeout in seconds for each API request to Brazilian federal corporate registries.
maxResults (integer) • OptionalMaximum number of CNPJ records to process in a single execution.
cnpj (string)14-digit unformatted CNPJ identifier.
cnpjFormatted (string)Formatted CNPJ (XX.XXX.XXX/XXXX-XX).
isValidMod11 (boolean)Whether the CNPJ passed Modulo 11 check-digit validation.
status (string)Enrichment status (ENRICHED, INVALID_MOD11, NOT_FOUND, API_ERROR).
dataSource (string)Primary source of enrichment (Brazilian federal corporate registry, Brazilian corporate registry, FallbackCache, LOCAL_MOD11_VALIDATOR).
razaoSocial (string)Official corporate legal name (Razão Social).
nomeFantasia (string)Trade name (Nome Fantasia).
situacaoCadastral (string)Registration status at Receita Federal (e.g. ATIVA, BAIXADA, INAPTA).
cnaePrincipalCodigo (string)Primary economic activity code (CNAE Fiscal).
cnaePrincipalDescricao (string)Primary economic activity description.
capitalSocialBRL (number)Registered share capital in BRL (Capital Social).
opcaoPeloSimples (boolean)Whether the company is opted into Simples Nacional tax regime.
opcaoPeloMei (boolean)Whether the company is registered as MEI (Microempreendedor Individual).
uf (string)Brazilian state code (UF).
municipio (string)Municipality / City name.
sociosCount (integer)Total number of partners and directors in QSA.
qsa (array[object])List of partners and administrators (Quadro de Sócios e Administradores).
cnaesSecundarios (array[object])List of secondary CNAE codes and descriptions.
markdownCompanyDossier (string)Structured Markdown company dossier ready for LLM/AI agents and CRM ingestion.
dataInicioAtividade (string)dataInicioAtividade returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
porte (string)porte returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
naturezaJuridica (string)naturezaJuridica returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
dataOpcaoPeloSimples (string)dataOpcaoPeloSimples returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
logradouro (string)logradouro returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
numero (string)numero returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
complemento (string)complemento returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
bairro (string)bairro returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
cep (string)cep returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
telefonePublico (string)telefonePublico returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
emailPublico (string)emailPublico returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
enrichedAt (string)enrichedAt returned by Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher.
Stateless payload attributes validated by JSON Schema and OpenAPI 3.0.3 standards for brazil-b2b-cnpj-qsa-lead-enricher.
| Field | Type | Requirement | Description & Audit Rules |
|---|---|---|---|
cnpjs | array[string] | Required | List of Brazilian CNPJ numbers to validate and enrich. |
includeSecondaryCnaes | boolean | Optional | Include all secondary economic activities (CNAEs Secundários) in the output record and markdown dossier. |
timeoutSeconds | integer | Optional | HTTP timeout in seconds for each API request to Brazilian federal corporate registries. |
maxResults | integer | Optional | Maximum number of CNPJ records to process in a single execution. |
Primary attributes returned in the audit response envelope with cryptographic audit metadata for brazil-b2b-cnpj-qsa-lead-enricher.
| Attribute | Type | Definition & Source Verifiability |
|---|---|---|
cnpj | string | 14-digit unformatted CNPJ identifier. |
cnpjFormatted | string | Formatted CNPJ (XX.XXX.XXX/XXXX-XX). |
isValidMod11 | boolean | Whether the CNPJ passed Modulo 11 check-digit validation. |
status | string | Enrichment status (ENRICHED, INVALID_MOD11, NOT_FOUND, API_ERROR). |
dataSource | string | Primary source of enrichment (Brazilian federal corporate registry, Brazilian corporate registry, FallbackCache, LOCAL_MOD11_VALIDATOR). |
razaoSocial | string | Official corporate legal name (Razão Social). |
nomeFantasia | string | Trade name (Nome Fantasia). |
situacaoCadastral | string | Registration status at Receita Federal (e.g. ATIVA, BAIXADA, INAPTA). |
cnaePrincipalCodigo | string | Primary economic activity code (CNAE Fiscal). |
cnaePrincipalDescricao | string | Primary economic activity description. |
capitalSocialBRL | number | Registered share capital in BRL (Capital Social). |
opcaoPeloSimples | boolean | Whether the company is opted into Simples Nacional tax regime. |
opcaoPeloMei | boolean | Whether the company is registered as MEI (Microempreendedor Individual). |
uf | string | Brazilian state code (UF). |
municipio | string | Municipality / City name. |
sociosCount | integer | Total number of partners and directors in QSA. |
Edit parameters in the request payload below and click Execute Sandbox Request to inspect the verified live schema response and dynamic cURL command.
curl -X POST "https://jesleytassili-glitch.github.io/v1/execute" \
-H "Content-Type: application/json" \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-d '{
"cnpjs": [
"00.000.000/0001-91",
"33.000.167/0001-01"
],
"includeSecondaryCnaes": true,
"timeoutSeconds": 15,
"maxResults": 10
}'
{
"cnpj": "00000000000191",
"cnpjFormatted": "00.000.000/0001-91",
"isValidMod11": true,
"status": "ENRICHED",
"dataSource": "Brazilian federal CNPJ public registry",
"razaoSocial": "BANCO DO BRASIL SA",
"nomeFantasia": "DIRECAO GERAL",
"situacaoCadastral": "ATIVA",
"dataInicioAtividade": "1966-08-01",
"porte": "DEMAIS",
"naturezaJuridica": "Sociedade de Economia Mista",
"capitalSocialBRL": 120000000000.0,
"cnaePrincipalCodigo": "6422100",
"cnaePrincipalDescricao": "Bancos múltiplos, com carteira comercial",
"cnaesSecundarios": [
{
"codigo": "6499999",
"descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
}
],
"opcaoPeloSimples": false,
"dataOpcaoPeloSimples": "2007-07-01",
"opcaoPeloMei": false,
"uf": "DF",
"municipio": "BRASILIA",
"logradouro": "SAUN QUADRA 5 BLOCO B TORRE I, II, III",
"numero": "SN",
"complemento": "ANDAR T I SL S101 A S1602 T II SL C101 A C1602 TIII SL N101 A N1602",
"bairro": "ASA NORTE",
"cep": "70040912",
"telefonePublico": "6134939002",
"emailPublico": null,
"sociosCount": 41,
"qsa": [
{
"nomeSocio": "ALAN CARLOS GUEDES DE OLIVEIRA",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 41 a 50 anos",
"dataEntradaSociedade": "2023-05-17",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***550179**"
},
{
"nomeSocio": "ALBERTO MARTINHAGO VIEIRA",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 41 a 50 anos",
"dataEntradaSociedade": "2023-07-20",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***842999**"
},
{
"nomeSocio": "ALEXANDRE BOCCHETTI NUNES",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 51 a 60 anos",
"dataEntradaSociedade": "2025-08-28",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***753277**"
}
],
"enrichedAt": "2026-11-03T21:16:52.999962+00:00",
"markdownCompanyDossier": "# Dossiê Corporativo B2B — BANCO DO BRASIL SA (00.000.000/0001-91)\n\n## 1. Identificação Cadastral e Tributária\n- **CNPJ:** `00.000.000/0001-91` (Módulo 11: `VÁLIDO`)\n- **Razão Social:** BANCO DO BRASIL SA\n- **Nome Fantasia:** DIRECAO GERAL\n- **Situação Cadastral:** `ATIVA`\n- **Data de Abertura:** 1966-08-01\n- **Porte / Natureza Jurídica:** DEMAIS | Sociedade de Economia Mista\n- **Capital Social:** R$ 120,000,000,000.00\n- **Optante pelo Simples Nacional:** Não\n- **Enquadrado como MEI:** Não\n- **Fonte Primária dos Dados:** `Brazilian federal CNPJ public registry`\n\n## 2. Atividade Econômica (CNAE)\n- **CNAE Principal:** `6422100` — Bancos múltiplos, com carteira comercial\n- **CNAEs Secundários (1):**\n - `6499999`: Outras atividades de serviços financeiros não especificadas anteriormente\n\n## 3. Localização e Contatos Públicos\n- **Município / UF:** BRASILIA / DF\n- **Endereço Registrado:** SAU... [truncated for preview]"
}
Direct extraction captured from primary government or corporate registry endpoints for brazil-b2b-cnpj-qsa-lead-enricher.
{
"cnpj": "00000000000191",
"cnpjFormatted": "00.000.000/0001-91",
"isValidMod11": true,
"status": "ENRICHED",
"dataSource": "Brazilian federal CNPJ public registry",
"razaoSocial": "BANCO DO BRASIL SA",
"nomeFantasia": "DIRECAO GERAL",
"situacaoCadastral": "ATIVA",
"dataInicioAtividade": "1966-08-01",
"porte": "DEMAIS",
"naturezaJuridica": "Sociedade de Economia Mista",
"capitalSocialBRL": 120000000000.0,
"cnaePrincipalCodigo": "6422100",
"cnaePrincipalDescricao": "Bancos múltiplos, com carteira comercial",
"cnaesSecundarios": [
{
"codigo": "6499999",
"descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
}
],
"opcaoPeloSimples": false,
"dataOpcaoPeloSimples": "2007-07-01",
"opcaoPeloMei": false,
"uf": "DF",
"municipio": "BRASILIA",
"logradouro": "SAUN QUADRA 5 BLOCO B TORRE I, II, III",
"numero": "SN",
"complemento": "ANDAR T I SL S101 A S1602 T II SL C101 A C1602 TIII SL N101 A N1602",
"bairro": "ASA NORTE",
"cep": "70040912",
"telefonePublico": "6134939002",
"emailPublico": null,
"sociosCount": 41,
"qsa": [
{
"nomeSocio": "ALAN CARLOS GUEDES DE OLIVEIRA",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 41 a 50 anos",
"dataEntradaSociedade": "2023-05-17",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***550179**"
},
{
"nomeSocio": "ALBERTO MARTINHAGO VIEIRA",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 41 a 50 anos",
"dataEntradaSociedade": "2023-07-20",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***842999**"
},
{
"nomeSocio": "ALEXANDRE BOCCHETTI NUNES",
"qualificacaoSocio": "Diretor",
"faixaEtaria": "Entre 51 a 60 anos",
"dataEntradaSociedade": "2025-08-28",
"identificadorDeSocio": "2",
"cnpjCpfDoSocio": "***753277**"
}
],
"enrichedAt": "2026-11-03T21:16:52.999962+00:00",
"markdownCompanyDossier": "# Dossiê Corporativo B2B — BANCO DO BRASIL SA (00.000.000/0001-91)\n\n## 1. Identificação Cadastral e Tributária\n- **CNPJ:** `00.000.000/0001-91` (Módulo 11: `VÁLIDO`)\n- **Razão Social:** BANCO DO BRASIL SA\n- **Nome Fantasia:** DIRECAO GERAL\n- **Situação Cadastral:** `ATIVA`\n- **Data de Abertura:** 1966-08-01\n- **Porte / Natureza Jurídica:** DEMAIS | Sociedade de Economia Mista\n- **Capital Social:** R$ 120,000,000,000.00\n- **Optante pelo Simples Nacional:** Não\n- **Enquadrado como MEI:** Não\n- **Fonte Primária dos Dados:** `Brazilian federal CNPJ public registry`\n\n## 2. Atividade Econômica (CNAE)\n- **CNAE Principal:** `6422100` — Bancos múltiplos, com carteira comercial\n- **CNAEs Secundários (1):**\n - `6499999`: Outras atividades de serviços financeiros não especificadas anteriormente\n\n## 3. Localização e Contatos Públicos\n- **Município / UF:** BRASILIA / DF\n- **Endereço Registrado:** SAU... [truncated for preview]"
}
import requests
url = "https://jesleytassili-glitch.github.io/specs_openapi_31/brazil-b2b-cnpj-qsa-lead-enricher.json" # Direct spec
endpoint = "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN" # RapidAPI or Apify Token
}
payload = {
"cnpjs": [
"00.000.000/0001-91",
"33.000.167/0001-01"
],
"includeSecondaryCnaes": true,
"timeoutSeconds": 15,
"maxResults": 10
}
response = requests.post(endpoint, json=payload, headers=headers, timeout=60)
print(f"Status Code: {response.status_code}")
data = response.json()
print("Audit Records Count:", len(data) if isinstance(data, list) else 1)
// Node.js 18+ Native Fetch or MCP CLI
import fetch from "node-fetch";
const payload = {
"cnpjs": [
"00.000.000/0001-91",
"33.000.167/0001-01"
],
"includeSecondaryCnaes": true,
"timeoutSeconds": 15,
"maxResults": 10
};
const response = await fetch("https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer " + process.env.B2B_API_TOKEN
},
body: JSON.stringify(payload)
});
const result = await response.json();
console.log("Verified Records:", result);
// Or run directly via MCP CLI:
// npx -y b2b-compliance-mcp-cli execute --server brazil-b2b-cnpj-qsa-lead-enricher --payload '{"cnpjs": ["00.000.000/0001-91", "33.000.167/0001-01"], "includeSecondaryCnaes": true, "timeoutSeconds": 15, "maxResults": 10}'
curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{"cnpjs": ["00.000.000/0001-91", "33.000.167/0001-01"], "includeSecondaryCnaes": true, "timeoutSeconds": 15, "maxResults": 10}'
name: Daily Compliance Audit - brazil-b2b-cnpj-qsa-lead-enricher
on:
schedule:
- cron: '0 8 * * 1-5' # Monday to Friday at 08:00 UTC
workflow_dispatch:
jobs:
audit:
runs-on: ubuntu-latest
steps:
- name: Trigger Audit Run
run: |
curl -f -s -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-b2b-cnpj-qsa-lead-enricher/run-sync-get-dataset-items" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${{ secrets.B2B_API_TOKEN }}" \
-d '{"cnpjs": ["00.000.000/0001-91", "33.000.167/0001-01"], "includeSecondaryCnaes": true, "timeoutSeconds": 15, "maxResults": 10}' > audit_output.json
- name: Archive Compliance Evidence
uses: actions/upload-artifact@v4
with:
name: brazil-b2b-cnpj-qsa-lead-enricher-evidence
path: audit_output.json
| HTTP Status | Classification | Resolution Behavior for brazil-b2b-cnpj-qsa-lead-enricher |
|---|---|---|
200 OK |
Success | Query executed successfully; validated Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher records returned. |
400 Bad Request |
Schema Validation | Payload missing required fields or format mismatch for brazil-b2b-cnpj-qsa-lead-enricher; inspect JSON schema. |
401 / 403 Forbidden |
Authentication Failure | Invalid proxy API key or direct unauthorized bypass attempt for Brazil B2B CNPJ, Partners (QSA) & CNAE Lead Enricher. |
429 Too Many Requests |
Rate Limit Exceeded | Tier limits triggered for brazil-b2b-cnpj-qsa-lead-enricher; inspect Retry-After response header. |
502 Upstream Resilient |
Graceful Degradation | Upstream regulatory portal offline; returns safe empty set with $0 billed fee. |
brazil-tax-reform-ncm-classtrib-auditor) • [Markdown Guide]eu-vies-vat-tax-compliance-auditor) • [Markdown Guide]brazil-antt-freight-cte-auditor) • [Markdown Guide]brazil-cep-geocoordinates-logistics-auditor) • [Markdown Guide]brazil-ibge-cnae-municipal-b2b-expansion-enricher) • [Markdown Guide]us-nhtsa-vehicle-vin-recall-auditor) • [Markdown Guide]us-census-fcc-real-estate-geo-enricher) • [Markdown Guide]