NFS-e
按密钥查询销项 NFS-e
按 50 位访问密钥查一张销项票，响应与按 `id` 查询的结构完全相同。
GET
/openapi/v2/empresas/{empresaId}/nfse/emitidas/{chaveAcesso}需要
token、timestamp、sign 三个签名头，参见认证与签名。路径参数
empresaId* | string | 主体标识 |
chaveAcesso* | string | 访问密钥 |
* 必填字段
200
单据存在。事实字段随状态推进逐步填充；按状态的情形见查询 NFS-e。
id | string | 单据 id |
status | string | 单据状态 |
motivoStatus | string | 结论说明 |
numero | int | 票号 |
serie | string | 序列号 |
numeroDps | int | DPS 序号 |
chaveAcesso | string | 访问密钥 |
identificacaoDps | string | DPS 标识 |
codigoVerificacao | string | 核验码 |
dataEmissao | string | 开票时间 |
dataAutorizacao | string | 授权时间 |
padraoMunicipal | string | 市政标准 |
atualizadoEm | string | 最后变更时刻 |
chaveSubstituida | string | 被替代的旧票密钥 |
chaveSubstituta | string | 替代本票的新票密钥 |
linkXml | string | XML 原件下载链接 |
linkDanfse | string | DANFSe 下载链接 |
| array | 授权后事件 |
nfse | object | 受理参数回显 |
status单据状态
| 取值 | 含义 |
|---|---|
| Pendente | 已受理，尚无结论；含待发行、已发送与对账中 |
| Autorizada | 发行成功，票已生效；可取消或被替代 |
| Negada | 发行方驳回，motivoStatus 带结论码与描述；终态 |
| EmProcessoDeCancelamento | 取消分析申请已受理，等市镇裁决；准予转 Cancelada，驳回回到 Autorizada |
| Cancelada | 已取消；终态 |
| Substituida | 已被替代票取代，chaveSubstituta 为新票密钥；终态 |
padraoMunicipal市政标准
| 取值 | 含义 |
|---|---|
| Nacional | 国家标准：国家发行器与全国分发 |
| Paulistana | 圣保罗市自有系统 |
eventos[].tipo事件类型
该表跟随官方事件演进，可能增加取值。
| 取值 | 含义 |
|---|---|
| Cancelamento | 开票方登记的取消（101101） |
| CancelamentoPorSubstituicao | 因被替代票取代而取消（105102） |
| PedidoAnalise | 取消的税务分析申请（101103） |
| AnaliseDeferida | 市镇准予取消（105104） |
| AnaliseIndeferida | 市镇驳回取消（105105） |
| CancelamentoDeOficio | 市镇依职权取消（305101） |
| Bloqueio | 市镇依职权封锁（305102） |
| Desbloqueio | 市镇依职权解封（305103） |
| Confirmacao | 票上某一方确认或市镇默示确认（202201 / 203202 / 204203 / 205204） |
| Rejeicao | 票上某一方拒绝（202205 / 203206 / 204207） |
| RejeicaoAnulada | 市镇作废拒绝（205208） |
| Outro | 尚未建模的官方事件，真实码在 status |
eventos[].codigo官方事件码
| 取值 | 含义 |
|---|---|
| 101101 | 开票方取消 |
| 105102 | 替代取消 |
| 101103 | 取消的分析申请 |
| 105104 | 分析准予取消 |
| 105105 | 分析驳回取消 |
| 305101 | 依职权取消 |
| 305102 | 依职权封锁 |
| 305103 | 依职权解封 |
| 202201 | 开票方确认 |
| 203202 | 接收方确认 |
| 204203 | 中介方确认 |
| 205204 | 市镇默示确认 |
| 202205 | 开票方拒绝 |
| 203206 | 接收方拒绝 |
| 204207 | 中介方拒绝 |
| 205208 | 市镇作废拒绝 |
| 000000 | 尚未建模的官方事件，真实码在 status |
| 错误码 | HTTP | |
|---|---|---|
| 10018003 | 404 | 单据不存在：该密钥不属于本主体。核对 chaveAcesso 与 empresaId。圣保罗老票没有 50 位密钥，按密钥查不到。 |
| 10003000 | 404 | empresaId 不存在或非本应用名下。 |