CT-e

Insuceso en la entrega

Registra el evento 110190, insuceso en la entrega, en un CT-e autorizado.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

El insuceso en la entrega es el evento con el que el transportista registra en la SEFAZ que intentó entregar y no lo consiguió, indicando cuándo lo intentó y por qué falló. Enviado de forma síncrona; en caso de éxito se devuelve el objeto del evento. Guarde el protocolo de la respuesta: es el protocoloEvento usado en Cancelar insuceso en la entrega.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa
`cteId*`	string	Identificador del documento

* Campo obligatorio

Cuerpo de la petición

`dataTentativa*`	string	Momento del intento
`numeroTentativa`	int	Número del intento
`motivo*`	int	Motivo del insuceso
`justificativa*` obligatorio para `motivo=4`	string	Justificación
`latitude`	number	Latitud del intento
`longitude`	number	Longitud del intento
`hashTentativa`	string	Huella de la imagen
`dataHashTentativa`	string	Momento de la imagen
`chavesNfe`	array	Claves de las NF-e del intento

* Campo obligatorio

200

Evento registrado en la SEFAZ. El objeto del evento se devuelve de forma síncrona.

`chaveAcesso`	string	Clave de acceso
`tipo`	string	Tipo del evento
`codigo`	string	Código del evento
`sequencia`	int	Secuencia
`status`	string	Código de retorno
`motivo`	string	Motivo
`protocolo`	string	Protocolo
`data`	string	Fecha del registro
`linkXml`	string	Enlace del XML del evento

Antes de medir la longitud, la plataforma limpia los campos de texto: se eliminan los acentos y los espacios en blanco repetidos se reducen a uno. Esto ocurre antes de la validación de longitud; un texto que queda fuera del rango tras esa limpieza devuelve 10017042.

`motivo`Motivo del insuceso

Valores	Significado
1	Receptor no encontrado
2	Rechazo del receptor
3	Dirección inexistente
4	Otros; exige `justificativa`

`tipo`Tipo del evento

Valores	Significado
Cancelamento	Cancelación del CT-e; código 110111
CartaCorrecao	Carta de corrección; código 110110
Epec	Autorización previa en contingencia EPEC, registrada por la plataforma; código 110113
ComprovanteEntrega	Comprobante de entrega; código 110180
CancelamentoComprovanteEntrega	Cancelación del comprobante de entrega; código 110181
InsucessoEntrega	Insuceso en la entrega; código 110190
CancelamentoInsucessoEntrega	Cancelación del insuceso en la entrega; código 110191
PrestacaoDesacordo	Prestación en desacuerdo; código 610110
CancelamentoPrestacaoDesacordo	Cancelación de la prestación en desacuerdo; código 610111

`codigo`Código del evento

Valores	Significado
110111	Cancelación del CT-e (`Cancelamento`)
110110	Carta de corrección (`CartaCorrecao`)
110113	Autorización previa en contingencia EPEC, registrada por la plataforma (`Epec`)
110180	Comprobante de entrega (`ComprovanteEntrega`)
110181	Cancelación del comprobante de entrega (`CancelamentoComprovanteEntrega`)
110190	Insuceso en la entrega (`InsucessoEntrega`)
110191	Cancelación del insuceso en la entrega (`CancelamentoInsucessoEntrega`)
610110	Prestación en desacuerdo (`PrestacaoDesacordo`)
610111	Cancelación de la prestación en desacuerdo (`CancelamentoPrestacaoDesacordo`)

`status`Código de retorno del registro

La plataforma solo devuelve 200 con uno de estos códigos; cualquier otro retorno de la SEFAZ se convierte en 10017043.

Valores	Significado
134	Evento registrado; la SEFAZ lo trata como éxito
135	Evento registrado y vinculado al CT-e
136	Evento registrado, pero no vinculado al CT-e

Código	HTTP
10017003	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017004	400	La empresa no está en condición de emitir: deshabilitada o certificado no disponible. Registrar eventos también exige el certificado; reactive la empresa o vincule un certificado válido.
10017040	400	El estado del documento no permite el evento; el CT-e debe estar `Autorizada`.
10017042	400	Texto del evento inválido: longitud fuera del rango tras la sanitización.
10017043	400	La SEFAZ rechazó el evento; `mensagem` trae su código de retorno y el motivo.
10001001	400	Falló la validación de campos, una entrada por campo; corrija según `mensagem`.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/cte/{cteId}/insucesso-entrega'

TIMESTAMP=$(date +%s)

BODY='{

"dataTentativa": "2026-09-06T10:00:00-03:00",

"numeroTentativa": 1,

"motivo": 2

SIGN=$(printf '%s%s%s%s' "$APP_SECRET" "$API_PATH" "$(printf '%s' "$BODY" | tr -d '\r\n')" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X POST "https://api.v2.tffiscal.com${API_PATH}" \

-H "Content-Type: application/json" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN" \

--data-binary "$BODY"

{

"chaveAcesso": "35260940673061000134570010000000011000000016",

"tipo": "InsucessoEntrega",

"codigo": "110190",

"sequencia": 1,

"status": "135",

"motivo": "Evento registrado e vinculado ao CT-e",

"protocolo": "135260000000101",

"data": "2026-09-06T13:30:00Z",

"linkXml": "https://.../openapi/files/xml/14?token=..."

}

Insuceso en la entrega

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Sanitización de texto

Enumeraciones4 tablas

motivoMotivo del insuceso

tipoTipo del evento

codigoCódigo del evento

statusCódigo de retorno del registro

Errores7 ítems

`motivo`Motivo del insuceso

`tipo`Tipo del evento

`codigo`Código del evento

`status`Código de retorno del registro