什么是 CNPJ

CNPJ（Cadastro Nacional da Pessoa Jurídica）是巴西的法人税务登记号，相当于中国的统一社会信用代码。每家在巴西注册的公司都有一个 14 位的 CNPJ 号，格式如 40.673.067/0001-34。CNPJ 不仅是公司身份证号，还是开具 NF-e、对接 SEFAZ、签订合同的基础。

但 CNPJ 仅仅是个号码，背后的公司真实信息（是否活跃、行业、股东、地址、税务制度）需要向 Receita Federal 查询。这就是 Consulta CNPJ API 的用途：传入一个 CNPJ，返回这家公司的完整官方信息。

为什么需要 Consulta CNPJ API

开票前 KYC 验证：避免给"幽灵公司"或已注销的公司开发票（这会导致 NF-e 被税局拒绝）
自动填表：用户输入 CNPJ，自动带出法人全称、地址、税务注册号等字段，减少手工录入与录入错误
风控反欺诈：识别可疑客户（如刚成立 3 天、注册资本极低、注册地与经营地不符）
合作方合规审查：签合同前查对方资质
定期客户复检：对已签约客户定期复查注册状态，避免对方暴雷

TF NFE 的 Consulta CNPJ API 核心能力

1. 数据直连 Receita Federal

数据源是巴西联邦税务局 Receita Federal 官方数据中心（通过 SERPRO 通道），权威性 100%。不是网上爬虫拼凑的，也不是过时缓存。

2. 返回字段一览（40+ 项）

基本信息：Razão Social（法人全称）、Nome Fantasia（商号）、CNPJ、Data de Abertura（成立日期）
地址：完整 Endereço、Logradouro（街道）、Número（门牌号）、Bairro（街区）、CEP（邮编）、Município（市）、UF（州）
行业：CNAE Principal（主营 6 位行业代码）+ Atividades Secundárias（次要业务列表）+ Descrição（行业描述）
注册状态：Situação Cadastral（Ativa / Suspensa / Baixada / Inapta / Nula）+ Data Situação（状态生效日期）+ Motivo（变更原因）
资本与规模：Capital Social（注册资本）、Porte（公司规模：ME / EPP / Grande）
股东结构：Quadro Societário（QSA，股东与法人代表名单，含 CPF / 国籍 / 资格）
税务制度：Opção pelo Simples Nacional / Lucro Real / Lucro Presumido
联系方式：Telefone（电话）、Email
州级登记：Inscrições Estaduais（各州 IE 号码列表）
分支机构：Filiais（如果有子机构）

3. 实时 + 缓存策略

支持三种模式：

实时模式：每次调用都直连 Receita Federal（适合 KYC 强校验场景）
缓存模式：24-72 小时缓存（适合自动填表、列表展示场景，节省成本）
批量异步：一次提交 1000+ CNPJ，结果通过 Webhook 回传（适合定期客户复检）

4. 调用日志与审计

所有调用记录时间、调用方、参数、返回字段，永久保留。便于内部风控审计和合规取证。

计费方式

TF NFE 提供灵活的计费方案：

按调用计费：R$ 0.50 / 次（按 CNPJ 唯一性去重，重复查询同一 CNPJ 24h 内只计一次）
预付包：1,000 次 R$ 450（单价 R$ 0.45）；10,000 次 R$ 3,800（单价 R$ 0.38）
大型企业定制化方案：针对调用量大、业务复杂、有专属 SLA 要求的客户，提供一对一定制：可按年度 / 按业务线 / 按行业打包定价，含专属客户经理、独立资源池、优先技术支持与合规审计配套。联系销售获取报价 →

说明：实际定价取决于您选择"精简版"（Reduzida）或"完整版"（Completa）数据。完整版含股东、税务制度等敏感字段，单价较高。

API 示例

GET /v1/consulta/cnpj/40673067000134

Response:
{
  "cnpj": "40.673.067/0001-34",
  "razao_social": "TF SOFTWARE LTDA",
  "nome_fantasia": "TF Software",
  "situacao": "ATIVA",
  "data_abertura": "2020-...",
  "endereco": { "uf": "SP", "municipio": "São Paulo", ... },
  "cnae_principal": "6202-3/00",
  "capital_social": "...",
  "socios": [ ... ]
}

典型应用场景

跨境 ERP 注册新客户：输入 CNPJ 自动带出公司信息
电商平台卖家审核：Shopee / Mercado Livre 卖家入驻前校验
金融风控：信贷审批、保理业务对企业合规审查
对账户客户复检：发现 Suspensa / Baixada 状态及时告警
反欺诈：与 NF-e 开票数据交叉验证，识别可疑交易

常见问题

Q：和我直接查 Receita Federal 官网有什么区别？

官网每天有限流（约 100 次/IP），且无 API 只有 HTML，无法自动化。TF NFE 通过官方授权通道提供 API，可大规模调用且数据结构化。

Q：数据更新频率多快？

实时模式数据来自 Receita Federal 当前数据库，T+0。缓存模式默认 24 小时刷新。

Q：能查询已注销（Baixada）的公司吗？

能。Baixada 状态的公司信息仍可查询，可以看到注销日期与原因。

Q：如何处理隐私合规？

CNPJ 数据属于公开信息（巴西公司法），不受 LGPD 严格约束。但若同时查询股东 CPF，则需遵守 LGPD — 见 LGPD 合规网关。

Consulta CNPJ 巴西企业信息查询