开票主体
查询主体
返回主体资料、审核状态、开通的单据类型与证书摘要。
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 | string | CNPJ |
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 | bool | NF-e 已开通 |
nfceHabilitado | bool | NFC-e 已开通 |
nfseHabilitado | bool | NFS-e 已配置 |
dceHabilitado | bool | DC-e 已开通 |
| object | A1 证书摘要 |
dataCriacao | string | 建档时刻 |
status主体状态
| 取值 | 含义 |
|---|---|
| Rascunho | 已建档、尚未提交审核;camposPendentes 列出缺项 |
| AguardandoAprovacao | 平台审核中,暂不能开票 |
| Ativa | 审核通过;有有效证书即可开票 |
| Rejeitada | 审核被驳回,motivoStatus 为原因。在控制台修正后重新提交;若原有 camposPendentes,带 id 调注册主体补齐后转人工重新审核 |
| Inativa | 已停用;在控制台重新启用前不能开票 |
camposPendentes待补全字段
| 取值 | 含义 |
|---|---|
| inscricaoEstadual | 缺州注册号。只开 NFS-e 的主体不要求:已配置 NFS-e、且没有 NF-e 号段 |
| optanteSimplesNacional | 税制待确认,总与 mei 同时出现;两项一起传才能确定税制 |
| mei | 税制待确认,总与 optanteSimplesNacional 同时出现 |
| endereco.logradouro | 缺地址街道 |
| endereco.numero | 缺地址门牌号 |
| endereco.bairro | 缺地址街区 |
| endereco.cep | 缺地址邮编 |
ambienteEmissao开票环境
| 取值 | 含义 |
|---|---|
| Homologacao | 认证测试;新注册主体默认 |
| Producao | 生产;由平台运营切换 |
certificado.status证书状态
| 取值 | 含义 |
|---|---|
| Nenhum | 未关联证书 |
| Valido | 证书有效 |
| ProximoVencimento | 临近到期,仍可开票 |
| Vencido | 已过期;重新关联证书后才能开票 |
| 错误码 | HTTP | |
|---|---|---|
| 10003000 | 404 | empresaId 不存在,或属于别的集成商账号。 |
| 10009005 | 403 | 应用未订阅本接口。请联系平台开通订阅。 |
