TF Fiscal
Documentación

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.

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

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

Cuerpo de la petición

  • dataTentativastringobligatorio

    Fecha y hora del intento de entrega, ISO-8601 con desplazamiento.

    Ejemplo: 2026-09-06T10:00:00-03:00
  • numeroTentativaintegeropcional

    Número del intento (nTentativa), opcional.

    Ejemplo: 1
  • motivointegerobligatorio

    Motivo (tpMotivo): 1 receptor ausente, 2 rechazo, 3 dirección incorrecta, 4 otro (exige justificativa).

    Valores:1234
    Ejemplo: 2
  • justificativastringobligatorio para `motivo=4`

    Justificación, de 15 a 256 caracteres.

  • latitudenumberopcional

    Latitud del intento (opcional), registrada con seis decimales.

  • longitudenumberopcional

    Longitud del intento (opcional), registrada con seis decimales.

  • hashTentativastringopcional

    Hash de la imagen del intento (hashTentativaEntrega), opcional.

  • dataHashTentativastringopcional

    Fecha y hora de generación de la imagen, ISO-8601 con desplazamiento, opcional.

  • chavesNfearrayopcional

    Claves de las NF-e implicadas (cadenas de 44 dígitos), opcional.

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ódigoHTTP
CTe0001404

cteId no encontrado o no pertenece a la empresa. Verifique el id y el empresaId.

10003000404

empresaId no encontrado.

10017040400

El estado del documento no permite el evento; el CT-e debe estar Autorizada.

10017042400

Texto del evento inválido (longitud fuera del rango tras la sanitización).

10017043400

La SEFAZ rechazó el evento; mensagem trae el cStat y el motivo.

10001001400

Falló la validación de campos (una entrada por campo); corrija según mensagem.

Sanitización de texto y coordenadas

Los campos de texto se sanitizan (acentos eliminados, espacios en blanco consolidados) antes de la validación de longitud; un texto que queda fuera del rango tras la sanitización devuelve 10017042. Las coordenadas se registran con seis decimales.

AnteriorCancelar comprobante de entregaSiguienteCancelar insuceso en la entrega