身份核验
CNPJ 查询
按 14 位 CNPJ 查询企业官方登记信息。
GET
/openapi/v3/consultas/cnpj/{cnpj}需要 token、timestamp、sign 三个签名头，参见认证与签名。
按 14 位法人税号查询工商登记：法定名称、商号、登记状态、法律性质、CNAE、注册地址、联系方式、注册资本。
响应为裸结构，不带平台信封。字段表列出全部可能字段；数据源无该项数据时字段返回空值，示例中已省略这类字段。GET 请求：签名用的 body 为空字符串，CNPJ 属于签名 path 的一部分。
参数
路径参数
cnpjstring必填14 位纯数字，不接受格式符：带
.///-的 CNPJ 中/会被当作路径分隔符。示例:40673061000134
响应
200
查询成功。企业登记信息。
nistringCNPJ 纯数字（14 位）。
tipoEstabelecimentostring机构类型：
1总部，2分支。取值:12nomeEmpresarialstring企业法定名称。
nomeFantasiastring商号（对外经营名称）。
situacaoCadastralobject登记状态。
naturezaJuridicaobject法律性质（码 + 描述）。
dataAberturastring开业日期，
yyyy-MM-dd。cnaePrincipalobject主营业务分类（码 + 描述）。
enderecoobject注册地址。完整街道需自行拼接
tipoLogradouro + logradouro，数据源分开返回。municipioJurisdicaoobject税务管辖市（码 + 描述）。
telefonesarray联系电话列表。
correioEletronicostring电子邮箱。
capitalSocialnumber注册资本。
portestring企业规模码。
situacaoEspecialstring特殊状态（如破产重整），一般不返回。
dataSituacaoEspecialstring特殊状态生效日期。
错误
| 错误码 | HTTP | |
|---|---|---|
| 10016010 | 400 | CNPJ 格式不合法（须 14 位数字）。检查是否误传格式符。 |
| 10016011 | 400 | CNPJ 校验位不合法。本地先用 mod-11 算法校验。 |
| 10016012 | 400 | 未找到该 CNPJ 的信息：官方登记中不存在。 |
| 10016020 | 503 | 上游数据源暂不可用。退避重试（初始 1 秒，倍增至 30 秒上限，加抖动）；持续出现请联系平台。 |
本地拦截与计费
格式与校验位错误（10016010、10016011）由平台本地拦截，不会发往上游数据源，因此不消耗调用额度也不计费。鉴权层错误（401 / 403 / 429）为平台信封形状；错误模型见 身份核验。