身份核验
CNPJ 查询
按 14 位 CNPJ 查询企业官方登记信息。
/openapi/v3/consultas/cnpj/{cnpj}token、timestamp、sign 三个签名头,参见认证与签名。按 14 位法人税号查询工商登记:法定名称、商号、登记状态、法律性质、CNAE、注册地址、联系方式、注册资本,以及是否加入 Simples Nacional、是否 MEI。
响应为无包装结构,不带平台统一响应体。字段表列出全部可能字段;数据源无该项数据时字段返回空值,示例中已省略这类字段。GET 请求:签名用的 body 为空字符串,CNPJ 属于签名 path 的一部分。
路径参数
cnpj* | string | CNPJ |
* 必填字段
ni | string | CNPJ |
tipoEstabelecimento | string | 机构类型 |
nomeEmpresarial | string | 法定名称 |
nomeFantasia | string | 商号 |
| object | 登记状态 |
| object | 法律性质 |
dataAbertura | string | 开业日期 |
| object | 主营活动 CNAE |
| object | 注册地址 |
| object | 税务管辖市镇 |
| array | 联系电话 |
correioEletronico | string | 电子邮箱 |
capitalSocial | number | 注册资本 |
porte | string | 企业规模码 |
situacaoEspecial | string | 特殊状态 |
dataSituacaoEspecial | string | 特殊状态生效日期 |
opcaoSimples | bool | 是否加入 Simples |
opcaoMei | bool | 是否 MEI |
| array | 次要经营活动 |
dataReferencia | string | 数据快照日期 |
opcaoSimples 与 opcaoMei 可用来预填注册主体的 optanteSimplesNacional 与 mei,提交前请用户确认:
opcaoMei | opcaoSimples | 预填 | CRT |
|---|---|---|---|
true | true 或 false | mei=true、optanteSimplesNacional=true | 4 MEI |
false | true | mei=false、optanteSimplesNacional=true | 1 Simples Nacional;超出分项限额的到控制台改为 2 |
false | false | mei=false、optanteSimplesNacional=false | 3 Regime Normal |
| 任一为空 | 不预填,请用户选择 | — |
这两项取自 dataReferencia 那天的登记快照,不是实时数据:此后加入或退出 Simples 还看不到。是否超出分项限额公开数据里没有。见开票主体的「税收制度」。
本接口不返回的内容。 不返回州注册号(IE),也不区分 Lucro Presumido 与 Lucro Real。IE 记在主体档案里:注册时由 inscricaoEstadual 传入,或在自动注册时由平台向 SEFAZ 查得。Lucro Presumido 或 Real 属于 PIS/COFINS 计税制度,在控制台配置。
格式与校验位错误(10016010、10016011)由平台本地拦截,不消耗调用额度也不计费。鉴权层错误(401 / 403 / 429)为平台统一响应体格式;错误模型见 身份核验。
tipoEstabelecimento机构类型
| 取值 | 含义 |
|---|---|
| 1 | 总部 |
| 2 | 分支机构 |
situacaoCadastral.codigo登记状态码
| 取值 | 含义 |
|---|---|
| 1 | 无效 |
| 2 | 正常营业 |
| 3 | 已暂停 |
| 4 | 不适格 |
| 8 | 已注销 |
naturezaJuridica.codigo法律性质代码
4 位数字,例如 2062 有限责任公司。第一位表示大类;完整码表见 CONCLA / IBGE 法律性质表。
| 取值 | 含义 |
|---|---|
| 1xxx | 公共机构 |
| 2xxx | 企业 |
| 3xxx | 非营利组织 |
| 4xxx | 自然人 |
| 5xxx | 国际组织与其他境外机构 |
endereco.municipio.codigo / municipioJurisdicao.codigo市镇代码
这是联邦税务局的市镇代码,不是开票用的 7 位 IBGE 码;开票时请用 descricao 里的市名配合 uf。
| 取值 | 含义 |
|---|---|
| NNNN | 4 位数字,例如 7107 圣保罗 |
endereco.uf地址所在州
| 取值 | 含义 |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
| EX | 境外;持有 CNPJ 的外国企业 |
endereco.pais.codigo国家代码
巴西央行国家码表,与 NF-e 用的是同一张。
| 取值 | 含义 |
|---|---|
| 1058 | 巴西 |
| NNNN | 其他国家,最多 4 位数字 |
porte企业规模码
联邦税务局的规模码,按登记数据原样返回。
| 取值 | 含义 |
|---|---|
| 00 | 未申报 |
| 01 | 微型企业 |
| 03 | 小型企业 |
| 05 | 其他规模 |
| 错误码 | HTTP | |
|---|---|---|
| 10016010 | 400 | CNPJ 格式不合法(须 14 位数字)。检查是否误传格式符。 |
| 10016011 | 400 | CNPJ 校验位不合法。本地先用 mod-11 算法校验。 |
| 10016012 | 400 | 未找到该 CNPJ 的信息:官方登记中不存在。 |
| 10016020 | 503 | 上游数据源暂不可用。退避重试(初始 1 秒,倍增至 30 秒上限,加抖动);持续出现请联系平台。 |
