DC-e
取消 DC-e
对已授权的 DC-e 发起取消（授权后 24 小时内）；异步，结果经 Webhook 通知。
POST
/openapi/v2/empresas/{empresaId}/dc-e/{dceId}/cancelar需要
token、timestamp、sign 三个签名头，参见认证与签名。受理成功返回 HTTP 200 无内容，单据进入 CancelamentoPendente，平台异步向 SEFAZ 登记取消事件 110111。结果经 Webhook dce.canceled（Cancelada）或 dce.cancel_rejected（CancelamentoNegado）通知，也可轮询查询接口。DC-e 官方只有取消事件，没有更正信函与作废号段。
路径参数
empresaId* | string | 发行主体标识 |
dceId* | string | 单据标识 |
* 必填字段
请求体
motivo | string | 取消理由 |
* 必填字段
200
取消已受理；无响应体。单据进入
CancelamentoPendente，SEFAZ 结论经 Webhook 通知。无响应体
无 body 的 POST 以空串作 body 参与签名；有 body 的 POST（取消带理由）按 JSON 原文去 CR/LF 参与签名，与 JSON 接口一致。若发送 { "motivo": ... }，签名须包含同一文本。参见认证与签名。
单据须为 Autorizada（10019040），且在授权后 24 小时内（10019041）；同一单据只受理一次取消（10019042）。SEFAZ 结论经下面两个 Webhook 之一通知，完整载荷见 DC-e。
取消成功 dce.canceled
dceStatus 为 Cancelada；dceDataAutorizacao 是取消登记时刻，dceNumeroProtocolo 是取消事件的协议号。DACE 改为带 CANCELADA 水印。
json
{ "tipo": "DC-e", "empresaId": "1934811222334455", "dceId": "DCe-000012333", "dceStatus": "Cancelada", "dceMotivoStatus": null,"dceChaveAcesso": "4126...", "dceDataAutorizacao": "2026-09-06T15:00:00Z", "dceNumeroProtocolo": "141260000000099" }
取消被拒 dce.cancel_rejected
dceStatus 为 CancelamentoNegado，dceMotivoStatus 带 SEFAZ 代码与说明。单据仍为 Autorizada，查询接口在 motivoStatus 带原因，可修正后再次发起取消。
json
{ "tipo": "DC-e", "empresaId": "1934811222334455", "dceId": "DCe-000012333", "dceStatus": "CancelamentoNegado","dceMotivoStatus": "594 - Rejeicao: O numero de sequencia do evento informado e maior que o permitido","dceChaveAcesso": "4126...", "dceDataAutorizacao": null, "dceNumeroProtocolo": "141260000000001" }
| 错误码 | HTTP | |
|---|---|---|
| 10019002 | 404 | dceId 不存在、非本主体，或单据尚未取号（仍 Pendente 无访问密钥）。Pendente 单据待授权后再取消。 |
| 10019003 | 404 | dceId 不存在、非本主体，或单据尚未取号（仍 Pendente 无访问密钥）。Pendente 单据待授权后再取消。 |
| 10003000 | 404 | empresaId 不存在。 |
| 10019040 | 400 | 状态不允许取消：单据须为 Autorizada（已取消单据再调也返回此码）。 |
| 10019041 | 400 | 超出授权后 24 小时窗口。单据只能保留。 |
| 10019042 | 400 | 该单据的取消已受理（进行中）。同一单据只受理一次取消。 |
| 10019043 | 400 | motivo 不合法：净化后不足 15 字符。 |