CT-e
Correction letter
Registers event 110110, the correction letter, on an authorized CT-e.
/openapi/v2/empresas/{empresaId}/cte/{cteId}/carta-correcaotoken, timestamp and sign signature headers, see Authentication.The correction letter fixes secondary information on an already authorized CT-e without cancelling it or issuing another document; it cannot be used to change amounts, parties or dates that affect the tax. Sent synchronously; on success the event object is returned. Allowed within 720 hours after authorization (10017049); the sequence auto-increments, with a limit of 20 letters (10017044). Once a correction letter is registered the document can no longer be cancelled (10017048 on cancellation).
Path parameters
empresaId* | string | Company identifier |
cteId* | string | Document identifier |
* Required field
Request body
* | array | Corrections |
* 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 |
Before measuring the length, the platform cleans text fields: accents are stripped and repeated whitespace collapses into a single space. This happens before the length validation; text that falls out of range after that cleanup returns 10017042.
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. |
| 10017042 | 400 | Invalid event text: length out of range after sanitization. |
| 10017043 | 400 | SEFAZ rejected the event; mensagem carries its return code and reason. |
| 10017044 | 400 | Correction letter sequence limit reached: 20 per document. |
| 10017049 | 400 | Correction letter outside the 720-hour window after authorization. |
| 10001001 | 400 | Request field validation failed, one entry per field; fix per mensagem. |