开票主体
主体列表
列出本账号名下的开票主体,含审核状态与证书摘要。
GET
/openapi/v2/empresas需要
token、timestamp、sign 三个签名头,参见认证与签名。查询参数
cnpj | string | CNPJ |
status | string | 状态过滤 |
nome | string | 名称关键字 |
pagina | int | 页码 |
tamanho | int | 每页条数 |
* 必填字段
200
主体的一页。没有命中时
itens 为空数组。pagina | int | 本次返回的页码 |
tamanho | int | 生效的每页条数 |
total | int | 总条数 |
totalLimitado | bool | 总数是否封顶 |
| array | 本页主体 |
status主体状态
过滤参数与 itens[].status 取值相同。
| 取值 | 含义 |
|---|---|
| Rascunho | 已建档、尚未提交审核;camposPendentes 列出缺项 |
| AguardandoAprovacao | 平台审核中,暂不能开票 |
| Ativa | 审核通过;有有效证书即可开票 |
| Rejeitada | 审核被驳回,motivoStatus 为原因。在控制台修正后重新提交;若原有 camposPendentes,带 id 调注册主体补齐后转人工重新审核 |
| Inativa | 已停用;在控制台重新启用前不能开票 |
itens[].ambienteEmissao开票环境
| 取值 | 含义 |
|---|---|
| Homologacao | 认证测试;新注册主体默认 |
| Producao | 生产;由平台运营切换 |
itens[].certificado.status证书状态
| 取值 | 含义 |
|---|---|
| Nenhum | 未关联证书 |
| Valido | 证书有效 |
| ProximoVencimento | 临近到期,仍可开票 |
| Vencido | 已过期;重新关联证书后才能开票 |
| 错误码 | HTTP | |
|---|---|---|
| 10001001 | 400 | status 不在枚举内、cnpj 不合法,或 pagina / tamanho 越界。 |
