CT-e
Cancel CT-e
Registers cancellation event 110111 on an authorized CT-e, within 168 hours after authorization.
/openapi/v2/empresas/{empresaId}/cte/{cteId}/cancelartoken, timestamp and sign signature headers, see Authentication.Cancelling makes an already authorized CT-e void; the document does not disappear, it starts to show as cancelled at SEFAZ. The body is optional. Event 110111 is registered synchronously and the event object is returned. Constraints: the document must be Autorizada (10017040), within 168 hours after authorization (10017041), and a CT-e with a registered correction letter cannot be cancelled (10017048); a SEFAZ rejection returns 10017043. Because this POST may carry a body, sign the raw JSON with CR/LF removed; with no body, sign with the empty string.
Path parameters
empresaId* | string | Company identifier |
cteId* | string | Document identifier |
* Required field
Request body
motivo | string | Cancellation reason |
* Required field
chaveAcesso | string | Access key |
tipo | string | Event type |
codigo | string | Event code |
sequencia | int | Sequence |
status | string | Return code |
motivo | string | Reason |
protocolo | string | Protocol |
data | string | Registration time |
linkXml | string | Event XML link |
tipoEvent type
| Values | Meaning |
|---|---|
| Cancelamento | CT-e cancellation; code 110111 |
| CartaCorrecao | Correction letter; code 110110 |
| Epec | EPEC contingency prior authorization, registered by the platform; code 110113 |
| ComprovanteEntrega | Delivery receipt; code 110180 |
| CancelamentoComprovanteEntrega | Delivery receipt cancellation; code 110181 |
| InsucessoEntrega | Delivery failure; code 110190 |
| CancelamentoInsucessoEntrega | Delivery failure cancellation; code 110191 |
| PrestacaoDesacordo | Service disagreement; code 610110 |
| CancelamentoPrestacaoDesacordo | Service disagreement cancellation; code 610111 |
codigoEvent code
| Values | Meaning |
|---|---|
| 110111 | CT-e cancellation (Cancelamento) |
| 110110 | Correction letter (CartaCorrecao) |
| 110113 | EPEC contingency prior authorization, registered by the platform (Epec) |
| 110180 | Delivery receipt (ComprovanteEntrega) |
| 110181 | Delivery receipt cancellation (CancelamentoComprovanteEntrega) |
| 110190 | Delivery failure (InsucessoEntrega) |
| 110191 | Delivery failure cancellation (CancelamentoInsucessoEntrega) |
| 610110 | Service disagreement (PrestacaoDesacordo) |
| 610111 | Service disagreement cancellation (CancelamentoPrestacaoDesacordo) |
statusRegistration return code
The platform only returns 200 with one of these codes; any other SEFAZ return becomes 10017043.
| Values | Meaning |
|---|---|
| 134 | Event registered; SEFAZ treats it as success |
| 135 | Event registered and linked to the CT-e |
| 136 | Event registered but not linked to the CT-e |
| Code | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId not found or not owned by the company. Check the id and the empresaId. |
| 10003000 | 404 | empresaId not found. |
| 10017004 | 400 | The company is not in a condition to issue: disabled or certificate unavailable. Registering events also needs the certificate; re-enable the company or link a valid certificate. |
| 10017040 | 400 | The document status does not allow the event; the CT-e must be Autorizada. |
| 10017041 | 400 | Cancellation window exceeded: 168 hours after authorization. |
| 10017042 | 400 | Invalid event text: length out of range after sanitization. |
| 10017043 | 400 | SEFAZ rejected the event; mensagem carries its return code and reason. |
| 10017048 | 400 | Cancellation blocked: the CT-e already has a registered correction letter. |
| 10001001 | 400 | Request field validation failed, one entry per field; fix per mensagem. |