CT-e
Cancel service disagreement
Registers event 610111, cancelling a service disagreement registered by this company.
POST
/openapi/v2/empresas/{empresaId}/cte/{chaveAcesso}/desacordo/{protocoloEvento}/cancelarRequires the
token, timestamp and sign signature headers, see Authentication.Withdraws a disagreement this company had registered, for example when the matter was settled with the carrier. No body; sign with the empty string. Only 610110 events registered by this company can be cancelled; protocoloEvento is the protocol of that event (10017045).
Path parameters
empresaId* | string | Company identifier |
chaveAcesso* | string | Access key |
protocoloEvento* | string | Event protocol |
* Required field
200
Event registered with SEFAZ. The event object is returned synchronously.
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 | |
|---|---|---|
| 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. |
| 10017014 | 400 | chaveAcesso is not 44 digits long or its check digit does not match. Check the key of the CT-e of the other company. |
| 10017043 | 400 | SEFAZ rejected the event; mensagem carries its return code and reason. |
| 10017045 | 400 | The event referenced by protocoloEvento was not found on this document. |