DC-e

取消 DC-e

对已授权的 DC-e 发起取消（授权后 24 小时内）；异步，结果经 Webhook 通知。

DELETE/openapi/v2/empresas/{empresaId}/dc-e/{dceId}

需要 token、timestamp、sign 三个签名头，参见认证与签名。

受理成功返回 HTTP 200 无内容，单据进入 CancelamentoPendente，平台异步向 SEFAZ 登记事件 110111（nSeqEvento=1）。结果经 Webhook dce.canceled（Cancelada）或 dce.cancel_rejected（CancelamentoNegado）通知，也可轮询查询接口。请求体可选：{ "motivo": "..." }，净化后 15-255 字符；缺省使用固定文案 Cancelamento solicitado pelo emitente por erro de preenchimento.。DC-e 官方只有取消事件，没有更正信函与作废号段。

参数

路径参数

empresaIdstring必填
注册开票主体返回的标识。
示例: 1934811222334455
dceIdstring必填
发行时传入的 id。
示例: DCe-000012333

请求体

motivostring可选
取消理由，净化后 15-255 字符（不足 15 返回 10019043）。缺省为 Cancelamento solicitado pelo emitente por erro de preenchimento.。
示例: Cancelamento solicitado pelo emitente por erro de preenchimento.

响应

200

取消已受理；无响应体。单据进入 CancelamentoPendente，SEFAZ 结论经 Webhook 通知。

无响应体

错误

错误码	HTTP
DCe0001	404	`dceId` 不存在、非本主体，或单据尚未物化（仍 `Pendente` 无 chave）。`Pendente` 单据待授权后再取消。
10003000	404	`empresaId` 不存在。
10019040	400	状态不允许取消：单据须为 `Autorizada`（已取消单据再调也返回此码）。
10019041	400	超出授权后 24 小时窗口（Manual DC-e）。单据只能保留。
10019042	400	该单据的取消已受理（进行中）。同一单据只受理一次取消。
10019043	400	`motivo` 不合法：净化后不足 15 字符。

带请求体的 DELETE 签名

无 body 的 DELETE 以空串作 body 参与签名；有 body 的 DELETE（取消带理由）按 JSON 原文去 CR/LF 参与签名，与 JSON 接口一致。若发送 { "motivo": ... }，签名须包含同一文本。参见认证与签名。

限制与结果

单据须为 Autorizada（10019040），且在授权后 24 小时内（10019041），自授权时刻起算。
同一单据只受理一次取消：取消中 / 已取消再调返回 10019042 / 10019040。
motivo 净化后不足 15 字符返回 10019043；单据尚未物化（仍 Pendente 无 chave）返回 404 DCe0001。
结果：dce.canceled，dceStatus=Cancelada（dceDataAutorizacao 为取消登记时刻、dceNumeroProtocolo 为取消事件协议号；DACE 重渲染带 CANCELADA 水印），或 dce.cancel_rejected，dceStatus=CancelamentoNegado（单据仍为 Autorizada，查询接口在 motivoStatus 带原因，可修正后再次 DELETE）。事件载荷见 DC-e。