NFS-e
进项 NFS-e 列表
按开票时刻分页列出本主体作为接收方或中介方收到的服务发票。
GET
/openapi/v2/empresas/{empresaId}/nfse/recebidas需要
token、timestamp、sign 三个签名头，参见认证与签名。本主体作为接收方或中介方收到的服务发票经全国分发到达，国家发行器出的票与圣保罗等市政系统共享的票都在，最多延迟 15 分钟。圣保罗主体另可收到直连市政系统取回的票，回看 7 天。条目结构与查询进项 NFS-e一致，但不含只有详情才返回的 eventos 数组；表态登记见进项 NFS-e 表态。
路径参数
empresaId* | string | 主体标识 |
* 必填字段
查询参数
dataInicio | string | 窗口起点 |
dataFim | string | 窗口终点 |
prestadorCpfCnpj | string | 开票方证件号 |
chaveAcesso | string | 访问密钥 |
status | string | 状态过滤 |
manifestacao | string | 表态过滤 |
pagina | int | 页码 |
tamanho | int | 每页条数 |
* 必填字段
200
进项票的一页，按开票时刻排序。每个条目结构同查询进项 NFS-e但不带事件：列表项的
eventos 恒为 null。pagina | int | 本次返回的页码 |
tamanho | int | 生效的每页条数 |
total | int | 总条数 |
totalLimitado | bool | 总数是否封顶 |
| array | 本页进项票 |
- 与全国分发的同步默认每 15 分钟一轮，对方刚开出的票会在下一轮出现。
- 到达与状态变化也可订阅 Webhook：
nfse.inbound.received、nfse.inbound.canceled、nfse.inbound.substituted；本主体表态的结果另有nfse.inbound.manifested与nfse.inbound.manifest_failed。这些事件均需在注册 Webhook显式订阅。 total是封顶计数：totalLimitado=true时请收窄时间窗，不要翻页到底。PrefeituraSP条目在转录票到达后会自动变为ADN，不要当成两张票。对账请用prestador.cpfCnpj+numero这个跨同步稳定的标识。
status状态过滤
不在表内的取值被忽略，不过滤。
| 取值 | 含义 |
|---|---|
| Autorizada | 在发行方有效 |
| Cancelada | 已取消 |
| Substituida | 已被替代 |
manifestacao表态过滤
不在表内的取值被忽略，不过滤。
| 取值 | 含义 |
|---|---|
| Pendente | 本主体尚未表态 |
| Confirmada | 本方已确认 |
| Rejeitada | 本方已拒绝 |
| ConfirmacaoTacita | 市镇默示确认 |
| RejeicaoAnulada | 市镇作废拒绝 |
itens[].status单据状态
| 取值 | 含义 |
|---|---|
| Autorizada | 在发行方有效 |
| Cancelada | 被开票方取消或市镇依职权取消 |
| Substituida | 已被替代票取代，chaveSubstituta 为新票密钥 |
itens[].papel本主体角色
| 取值 | 含义 |
|---|---|
| Tomador | 服务接收方；表态用 203202 确认或 203206 拒绝 |
| Intermediario | 服务中介方；表态用 204203 确认或 204207 拒绝 |
itens[].origem行来源
| 取值 | 含义 |
|---|---|
| ADN | 全国分发到达 |
| PrefeituraSP | 圣保罗市政系统直连取回；只有圣保罗主体；转录票到达后变为 ADN |
itens[].manifestacao.status表态状态
字段为 null 表示未表态；列表过滤时这一情形用 Pendente。
| 取值 | 含义 |
|---|---|
| Confirmada | 本方已确认（203202 / 204203）；终态 |
| Rejeitada | 本方已拒绝（203206 / 204207）；市镇仍可作废 |
| ConfirmacaoTacita | 期限内未表态，市镇默示确认（205204）；终态 |
| RejeicaoAnulada | 市镇作废了本方的拒绝（205208）；终态 |
itens[].manifestacao.codigoEvento表态事件码
| 取值 | 含义 |
|---|---|
| 203202 | 接收方确认 |
| 204203 | 中介方确认 |
| 203206 | 接收方拒绝 |
| 204207 | 中介方拒绝 |
| 205204 | 市镇默示确认 |
| 205208 | 市镇作废拒绝 |
itens[].manifestacao.codigoMotivo拒绝原因码
| 取值 | 含义 |
|---|---|
| 1 | 票重复 |
| 2 | 接收方已自行开票 |
| 3 | 应税事实未发生，服务没有提供 |
| 4 | 责任方错误 |
| 5 | 金额或数据错误 |
| 9 | 其他，在 motivo 里说明 |
| 错误码 | HTTP | |
|---|---|---|
| 10001012 | 400 | dataInicio / dataFim 窗口超过 31 天。请收窄窗口，分段翻页。 |
| 10001001 | 400 | pagina / tamanho 越界，或某个过滤条件超过最大长度。 |
| 10003000 | 404 | empresaId 不存在或非本应用名下。 |