TF Fiscal
开发文档

身份核验

CNPJ 查询

按 14 位 CNPJ 查询企业官方登记信息。

GET/openapi/v3/consultas/cnpj/{cnpj}
需要 token、timestamp、sign 三个签名头,参见认证与签名。

按 14 位法人税号查询工商登记:法定名称、商号、登记状态、法律性质、CNAE、注册地址、联系方式、注册资本,以及是否加入 Simples Nacional、是否 MEI。

响应为无包装结构,不带平台统一响应体。字段表列出全部可能字段;数据源无该项数据时字段返回空值,示例中已省略这类字段。GET 请求:签名用的 body 为空字符串,CNPJ 属于签名 path 的一部分。

路径参数

cnpj*
stringCNPJ

* 必填字段

200
查询成功。企业登记信息。
ni
stringCNPJ
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,提交前请用户确认:

opcaoMeiopcaoSimples预填CRT
truetrue 或 falsemei=true、optanteSimplesNacional=true4 MEI
falsetruemei=false、optanteSimplesNacional=true1 Simples Nacional;超出分项限额的到控制台改为 2
falsefalsemei=false、optanteSimplesNacional=false3 Regime Normal
任一为空不预填,请用户选择—

这两项取自 dataReferencia 那天的登记快照,不是实时数据:此后加入或退出 Simples 还看不到。是否超出分项限额公开数据里没有。见开票主体的「税收制度」。

本接口不返回的内容。 不返回州注册号(IE),也不区分 Lucro Presumido 与 Lucro Real。IE 记在主体档案里:注册时由 inscricaoEstadual 传入,或在自动注册时由平台向 SEFAZ 查得。Lucro Presumido 或 Real 属于 PIS/COFINS 计税制度,在控制台配置。