NFS-e
销项 NFS-e 列表
按开票时刻分页列出本主体已取号的 NFS-e,用于对账。
GET
/openapi/v2/empresas/{empresaId}/nfse/emitidas需要
token、timestamp、sign 三个签名头,参见认证与签名。对账用:列出本主体已取号的销项单据。取号前就失败的任务(查询状态 Falha)没有单据行,列不出来,请按 id 用查询 NFS-e单查。条目是紧凑形态,事件列表、入参回显、驳回原因等全貌在查询 NFS-e里;按 50 位密钥查单张见按密钥查询销项 NFS-e。圣保罗老票没有 50 位密钥,chaveAcesso 为空,请用 id 或 identificacaoDps 对账。
路径参数
empresaId* | string | 主体标识 |
* 必填字段
查询参数
dataInicio | string | 窗口起点 |
dataFim | string | 窗口终点 |
status | string | 状态过滤 |
serie | string | 序列号 |
tomadorCpfCnpj | string | 接收方证件号 |
chaveAcesso | string | 访问密钥 |
id | string | 单据 id |
pagina | int | 页码 |
tamanho | int | 每页条数 |
* 必填字段
200
已取号单据的一页,按开票时刻排序。没有命中时
itens 为空数组。pagina | int | 本次返回的页码 |
tamanho | int | 生效的每页条数 |
total | int | 总条数 |
totalLimitado | bool | 总数是否封顶 |
| array | 本页单据 |
status单据状态
精确过滤;不在表内的取值受理即拒。列表里没有 Falha,请按 id 查任务。
| 取值 | 含义 |
|---|---|
| Pendente | 已受理,尚无结论;含待发行、已发送与对账中 |
| Autorizada | 发行成功,票已生效;可取消或被替代 |
| Negada | 发行方驳回;终态 |
| EmProcessoDeCancelamento | 取消分析申请已受理,等市镇裁决 |
| Cancelada | 已取消;终态 |
| Substituida | 已被替代票取代,chaveSubstituta 为新票密钥;终态 |
itens[].status单据状态
Falha(取号前失败)不会出现在本列表:这种情形没有产生单据,请按 id 用查询 NFS-e查任务。
| 取值 | 含义 |
|---|---|
| Pendente | 已受理,尚无结论;含待发行、已发送与对账中 |
| Autorizada | 发行成功,票已生效;可取消或被替代 |
| Negada | 发行方驳回;终态 |
| EmProcessoDeCancelamento | 取消分析申请已受理,等市镇裁决 |
| Cancelada | 已取消;终态 |
| Substituida | 已被替代票取代,chaveSubstituta 为新票密钥;终态 |
itens[].padraoMunicipal市政标准
| 取值 | 含义 |
|---|---|
| Nacional | 国家标准:国家发行器与全国分发 |
| Paulistana | 圣保罗市自有系统 |
| 错误码 | HTTP | |
|---|---|---|
| 10001012 | 400 | dataInicio / dataFim 窗口超过 31 天。请收窄窗口,分段翻页。 |
| 10001001 | 400 | status 不在枚举内,或 pagina / tamanho 越界。 |
| 10003000 | 404 | empresaId 不存在或非本应用名下。 |
