TF Fiscal
开发文档

开票主体

查询主体

返回主体资料、审核状态、开通的单据类型与证书摘要。

GET/openapi/v2/empresas/{empresaId}
需要 token、timestamp、sign 三个签名头,参见认证与签名。

基础资料字段与注册主体请求同名同义,nfceHabilitado / nfseHabilitado / dceHabilitado 与注册响应同名。主体要 status 为 Ativa 且 certificado.possuiCertificadoValido 为 true 才能开票。别的账号的主体与不存在的主体回应相同,均为 10003000。不计费。

自动注册建出的主体用本接口跟踪:Rascunho 或 Rejeitada 时响应带 camposPendentes,列出还缺什么;用注册主体带 id 补齐,资料齐全后主体自动进入审核。税制待确认时 optanteSimplesNacional 与 mei 为 null,并列在 camposPendentes 里。

两个布尔值分不出 CRT 1 与 CRT 2(超出分项限额),两者都回 true / false。见开票主体的「税收制度」。

路径参数

empresaId*
string主体标识

* 必填字段

200
主体详情。
empresaId
string主体标识
cnpj
stringCNPJ
razaoSocial
string法定名称
nomeFantasia
string商号
inscricaoEstadual
string州注册号
inscricaoMunicipal
string市政注册号
optanteSimplesNacional
bool是否 Simples
mei
bool是否 MEI
email
string联系邮箱
telefoneComercial
string联系电话
object地址
status
string主体状态
motivoStatus
string驳回原因
camposPendentes
array待补全字段
dataEnvioAprovacao
string提交审核时刻
dataAprovacao
string审核完成时刻
ambienteEmissao
string开票环境
nfeHabilitado
boolNF-e 已开通
nfceHabilitado
boolNFC-e 已开通
nfseHabilitado
boolNFS-e 已配置
dceHabilitado
boolDC-e 已开通
objectA1 证书摘要
dataCriacao
string建档时刻