CT-e

Cancelar insuceso en la entrega

Registra el evento 110191, cancelando un insuceso en la entrega registrado.

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

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

Sin cuerpo; firme con la cadena vacía. protocoloEvento debe ser el protocolo de un evento 110190 registrado en este documento (10017045). Enviado de forma síncrona; en caso de éxito se devuelve el objeto del evento.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa (transportista) devuelto en el registro.
Ejemplo: 1934811222334455
cteIdstringobligatorio
El id enviado en la emisión del CT-e.
Ejemplo: CTE-ORD-1
protocoloEventostringobligatorio
Número de protocolo (protocolo) del evento a cancelar, devuelto en el registro del evento o en la lista de eventos.
Ejemplo: 135260000000099

Respuestas

200

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

chaveAcessostring
Clave de acceso de 44 dígitos del CT-e al que se vinculó el evento.
tipostring
Tipo del evento.
Valores:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
Código del evento en la SEFAZ (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Número secuencial del evento dentro de su tipo (la carta de corrección se incrementa automáticamente).
statusstring
cStat devuelto por la SEFAZ; 135 significa evento registrado y vinculado.
motivostring
xMotivo devuelto por la SEFAZ.
protocolostring
Número de protocolo del evento; úselo como protocoloEvento para cancelar el evento.
datastring
Fecha y hora del registro del evento, ISO-8601 en UTC.
linkXmlstring
Enlace de descarga del XML del evento (procEvento). Vea Descarga de archivos.

Errores

Código	HTTP
CTe0001	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017040	400	El estado del documento no permite el evento; el CT-e debe estar `Autorizada`.
10017043	400	La SEFAZ rechazó el evento; `mensagem` trae el cStat y el motivo.
10017045	400	El evento referenciado por `protocoloEvento` no se encontró en este documento.

APP_SECRET='<APP_SECRET>'

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

TIMESTAMP=$(date +%s)

SIGN=$(printf '%s%s%s' "$APP_SECRET" "$API_PATH" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

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

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

{

"chaveAcesso": "35260940673061000134570010000000011000000010",

"tipo": "CancelamentoInsucessoEntrega",

"codigo": "110191",

"sequencia": 1,

"status": "135",

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

"protocolo": "135260000000102",

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

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

}