CT-e
取消 CT-e
对已授权 CT-e 登记取消事件 110111，须在授权后 168 小时内。
POST
/openapi/v2/empresas/{empresaId}/cte/{cteId}/cancelar需要
token、timestamp、sign 三个签名头，参见认证与签名。取消就是让已授权的 CT-e 失去效力；单据不会消失，而是在税务局那边记为已取消。请求体可选。同步登记事件 110111 并返回事件对象。限制：单据须为 Autorizada（10017040），授权后 168 小时内（10017041），已登记过信函更正的 CT-e 不可取消（10017048），SEFAZ 拒绝返回 10017043。该 POST 可带请求体，签名时按 JSON 原文去 CR/LF 参与；无请求体时取空串。
路径参数
empresaId* | string | 主体标识 |
cteId* | string | 单据标识 |
* 必填字段
请求体
motivo | string | 取消理由 |
* 必填字段
200
事件已在 SEFAZ 登记，同步返回事件对象。
chaveAcesso | string | 访问密钥 |
tipo | string | 事件类型 |
codigo | string | 事件代码 |
sequencia | int | 事件序号 |
status | string | 登记状态码 |
motivo | string | 状态说明 |
protocolo | string | 事件回执号 |
data | string | 登记时刻 |
linkXml | string | 事件 XML 链接 |
tipo事件类型
| 取值 | 含义 |
|---|---|
| Cancelamento | 取消 CT-e，代码 110111 |
| CartaCorrecao | 信函更正，代码 110110 |
| Epec | EPEC 应急事前授权，由平台登记，代码 110113 |
| ComprovanteEntrega | 交付凭证，代码 110180 |
| CancelamentoComprovanteEntrega | 撤销交付凭证，代码 110181 |
| InsucessoEntrega | 交付失败，代码 110190 |
| CancelamentoInsucessoEntrega | 撤销交付失败，代码 110191 |
| PrestacaoDesacordo | 服务不符，代码 610110 |
| CancelamentoPrestacaoDesacordo | 撤销服务不符，代码 610111 |
codigo事件代码
| 取值 | 含义 |
|---|---|
| 110111 | 取消 CT-e，即 Cancelamento |
| 110110 | 信函更正，即 CartaCorrecao |
| 110113 | EPEC 应急事前授权，由平台登记，即 Epec |
| 110180 | 交付凭证，即 ComprovanteEntrega |
| 110181 | 撤销交付凭证，即 CancelamentoComprovanteEntrega |
| 110190 | 交付失败，即 InsucessoEntrega |
| 110191 | 撤销交付失败，即 CancelamentoInsucessoEntrega |
| 610110 | 服务不符，即 PrestacaoDesacordo |
| 610111 | 撤销服务不符，即 CancelamentoPrestacaoDesacordo |
status登记状态码
平台只在这些状态码下返回 200；税务局其他返回一律转为 10017043。
| 取值 | 含义 |
|---|---|
| 134 | 已登记，税务局视为成功 |
| 135 | 已登记并挂到单据 |
| 136 | 已登记但未挂到单据 |
| 错误码 | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId 不存在或非本主体。核对 id 与 empresaId。 |
| 10003000 | 404 | empresaId 不存在。 |
| 10017004 | 400 | 主体当前不可开具：已停用或证书不可用。登记事件同样要用证书；请重新启用主体或关联可用证书。 |
| 10017040 | 400 | 单据状态不允许该事件；CT-e 须为 Autorizada。 |
| 10017041 | 400 | 超出取消窗口：授权后 168 小时。 |
| 10017042 | 400 | 事件文本非法：净化后长度超出范围。 |
| 10017043 | 400 | SEFAZ 拒绝了该事件；mensagem 带上它的状态码与原因。 |
| 10017048 | 400 | 不可取消：该 CT-e 已登记过信函更正。 |
| 10001001 | 400 | 请求字段校验失败，每字段一条；按 mensagem 修正。 |