CT-e
Delivery receipt
Registers event 110180, the delivery receipt, on an authorized CT-e.
/openapi/v2/empresas/{empresaId}/cte/{cteId}/comprovante-entregatoken, timestamp and sign signature headers, see Authentication.The delivery receipt is the event by which the carrier declares to SEFAZ that the load was delivered, saying who signed, when, and with which image of the signed slip. Sent synchronously; on success the event object is returned. Keep the protocolo of the response: it is the protocoloEvento used by Cancel delivery receipt.
Path parameters
empresaId* | string | Company identifier |
cteId* | string | Document identifier |
* Required field
Request body
dataEntrega* | string | Delivery time |
documentoRecebedor* | string | Receiver document number |
nomeRecebedor* | string | Receiver name |
latitude | number | Delivery latitude |
longitude | number | Delivery longitude |
hashEntrega* | string | Signed slip fingerprint |
dataHashEntrega* | string | Image time |
chavesNfe | array | Keys of the delivered NF-e |
* 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. |
| 10001001 | 400 | Request field validation failed, one entry per field; fix per mensagem. |