NFC-e
替代取消
取消与同一笔交易的离线应急票重复的那张正常票。
POST
/openapi/v2/empresas/{empresaId}/nfce/{nfceId}/cancelar-substituicao需要
token、timestamp、sign 三个签名头，参见认证与签名。典型场景：正常票已发出但 SEFAZ 无响应，收银台又开了一张离线应急票，结果两张都有效。本接口取消 nfceId 定位的正常票，并指向替代它的离线票。SEFAZ 恢复时平台会自动处理大部分这类情况，本接口供特殊情况自行处理。时限：授权后 168 小时内。
路径参数
empresaId* | string | 开票主体标识 |
nfceId* | string | NFC-e 标识 |
* 必填字段
请求体
chaveAcessoSubstituta* | string | 替代票访问密钥 |
justificativa* | string | 取消原因 |
* 必填字段
200
已受理，无响应体。结果经 Webhook 推送，也可在查询接口看到。
无响应体
| 错误码 | HTTP | |
|---|---|---|
| 10022006 | 404 | 该主体下 nfceId 不存在。 |
| 10003000 | 404 | empresaId 不存在。 |
| 10022008 | 400 | 当前状态不允许：票不是 Autorizada，或已有取消在处理中。 |
| 10022004 | 400 | nfceId 对应的不是正常票，或替代密钥不是同一主体的离线应急票。 |
| 10022007 | 400 | 已超出 168 小时期限。 |
| 10001001 | 400 | 字段校验失败，mensagem 点名字段。 |