CT-e

Delivery failure

Registers event 110190 (delivery failure) on an authorized CT-e.

POST/openapi/v2/empresas/{empresaId}/cte/{cteId}/insucesso-entrega

Requires the token, timestamp and sign signature headers, see Authentication.

Sent synchronously; on success the event object is returned. Keep the protocolo of the response: it is the protocoloEvento used by Cancel delivery failure.

Parameters

Path parameters

empresaIdstringrequired
Company (carrier) identifier returned at registration.
Example: 1934811222334455
cteIdstringrequired
The id sent at CT-e issuance.
Example: CTE-ORD-1

Request body

dataTentativastringrequired
Date and time of the delivery attempt, ISO-8601 with offset.
Example: 2026-09-06T10:00:00-03:00
numeroTentativaintegeroptional
Attempt number (nTentativa), optional.
Example: 1
motivointegerrequired
Reason (tpMotivo): 1 receiver absent, 2 refused, 3 wrong address, 4 other (requires justificativa).
Values:1234
Example: 2
justificativastringrequired for `motivo=4`
Justification, 15 to 256 characters.
latitudenumberoptional
Attempt latitude (optional), registered with six decimals.
longitudenumberoptional
Attempt longitude (optional), registered with six decimals.
hashTentativastringoptional
Hash of the attempt image (hashTentativaEntrega), optional.
dataHashTentativastringoptional
Date and time the image was generated, ISO-8601 with offset, optional.
chavesNfearrayoptional
Keys of the NF-e involved (44-digit strings), optional.

Responses

200

Event registered with SEFAZ. The event object is returned synchronously.

chaveAcessostring
44-digit access key of the CT-e the event was linked to.
tipostring
Event type.
Values:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
SEFAZ event code (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Sequence number of the event within its type (the correction letter auto-increments).
statusstring
cStat returned by SEFAZ; 135 means the event was registered and linked.
motivostring
xMotivo returned by SEFAZ.
protocolostring
Event protocol number; use it as protocoloEvento to cancel the event.
datastring
Event registration date and time, ISO-8601 in UTC.
linkXmlstring
Download link of the event XML (procEvento). See File download.

Errors

Code	HTTP
CTe0001	404	`cteId` not found or not owned by the company. Check the id and the `empresaId`.
10003000	404	`empresaId` not found.
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 the cStat and the reason.
10001001	400	Request field validation failed (one entry per field); fix per `mensagem`.

Text sanitization and coordinates

Text fields are sanitized (accents stripped, whitespace collapsed) before length validation; text that falls out of range after sanitization returns 10017042. Coordinates are registered with six decimals.