CT-e

Comprobante de entrega

Registra el evento 110180, comprobante de entrega, en un CT-e autorizado.

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

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

El comprobante de entrega es el evento con el que el transportista declara a la SEFAZ que la carga fue entregada, indicando quién firmó, cuándo y con qué imagen del acuse. 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 comprobante de entrega.

Parámetros de ruta

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

* Campo obligatorio

Cuerpo de la petición

`dataEntrega*`	string	Momento de la entrega
`documentoRecebedor*`	string	Documento de quien recibió
`nomeRecebedor*`	string	Nombre de quien recibió
`latitude`	number	Latitud de la entrega
`longitude`	number	Longitud de la entrega
`hashEntrega*`	string	Huella del acuse
`dataHashEntrega*`	string	Momento de la imagen
`chavesNfe`	array	Claves de las NF-e entregadas

* 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.

`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}/comprovante-entrega'

TIMESTAMP=$(date +%s)

BODY='{

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

"documentoRecebedor": "12345678909",

"nomeRecebedor": "JOSE DA SILVA",

"hashEntrega": "2jmj7l5rSw0yVb/vlWAYkK/YBwk=",

"dataHashEntrega": "2026-09-06T10:01:00-03:00",

"chavesNfe": ["35260966500544000120550010000001231000000002"]

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": "3526...",

"tipo": "ComprovanteEntrega",

"codigo": "110180",

"sequencia": 1,

"status": "135",

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

"protocolo": "135260000000099",

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

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

}

Comprobante de entrega

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Sanitización de texto

Enumeraciones3 tablas

tipoTipo del evento

codigoCódigo del evento

statusCódigo de retorno del registro

Errores7 ítems

`tipo`Tipo del evento

`codigo`Código del evento

`status`Código de retorno del registro