CT-e

Comprovante de entrega

Registra o evento 110180, comprovante de entrega, em um CT-e autorizado.

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

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

O comprovante de entrega é o evento com que a transportadora declara à SEFAZ que a carga foi entregue, dizendo quem assinou, quando e com que imagem do canhoto. Enviado de forma síncrona; em caso de sucesso o objeto do evento é devolvido. Guarde o protocolo da resposta: ele é o protocoloEvento usado em Cancelar comprovante de entrega.

Parâmetros de caminho

`empresaId*`	string	Identificador da empresa
`cteId*`	string	Identificador do documento

* Campo obrigatório

Corpo da requisição

`dataEntrega*`	string	Momento da entrega
`documentoRecebedor*`	string	Documento de quem recebeu
`nomeRecebedor*`	string	Nome de quem recebeu
`latitude`	number	Latitude da entrega
`longitude`	number	Longitude da entrega
`hashEntrega*`	string	Impressão digital do canhoto
`dataHashEntrega*`	string	Momento da imagem
`chavesNfe`	array	Chaves das NF-e entregues

* Campo obrigatório

200

Evento registrado na SEFAZ. O objeto do evento é devolvido de forma síncrona.

`chaveAcesso`	string	Chave de acesso
`tipo`	string	Tipo do evento
`codigo`	string	Código do evento
`sequencia`	int	Sequência
`status`	string	Código de retorno
`motivo`	string	Motivo
`protocolo`	string	Protocolo
`data`	string	Data do registro
`linkXml`	string	Link do XML do evento

Antes de medir o comprimento, a plataforma limpa os campos de texto: os acentos são removidos e os espaços em branco repetidos viram um só. Isso acontece antes da validação de comprimento; um texto que fica fora do intervalo depois dessa limpeza retorna 10017042.

`tipo`Tipo do evento

Valores	Significado
Cancelamento	Cancelamento do CT-e; código 110111
CartaCorrecao	Carta de correção; código 110110
Epec	Autorização prévia em contingência EPEC, registrada pela plataforma; código 110113
ComprovanteEntrega	Comprovante de entrega; código 110180
CancelamentoComprovanteEntrega	Cancelamento do comprovante de entrega; código 110181
InsucessoEntrega	Insucesso na entrega; código 110190
CancelamentoInsucessoEntrega	Cancelamento do insucesso na entrega; código 110191
PrestacaoDesacordo	Prestação do serviço em desacordo; código 610110
CancelamentoPrestacaoDesacordo	Cancelamento da prestação em desacordo; código 610111

`codigo`Código do evento

Valores	Significado
110111	Cancelamento do CT-e (`Cancelamento`)
110110	Carta de correção (`CartaCorrecao`)
110113	Autorização prévia em contingência EPEC, registrada pela plataforma (`Epec`)
110180	Comprovante de entrega (`ComprovanteEntrega`)
110181	Cancelamento do comprovante de entrega (`CancelamentoComprovanteEntrega`)
110190	Insucesso na entrega (`InsucessoEntrega`)
110191	Cancelamento do insucesso na entrega (`CancelamentoInsucessoEntrega`)
610110	Prestação do serviço em desacordo (`PrestacaoDesacordo`)
610111	Cancelamento da prestação em desacordo (`CancelamentoPrestacaoDesacordo`)

`status`Código de retorno do registro

A plataforma só devolve 200 com um destes códigos; qualquer outro retorno da SEFAZ vira 10017043.

Valores	Significado
134	Evento registrado; a SEFAZ o trata como sucesso
135	Evento registrado e vinculado ao CT-e
136	Evento registrado, mas não vinculado ao CT-e

Código	HTTP
10017003	404	`cteId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10003000	404	`empresaId` não encontrado.
10017004	400	A empresa não está em condição de emitir: desabilitada ou certificado indisponível. Registrar eventos também exige o certificado; reative a empresa ou vincule um certificado válido.
10017040	400	O status do documento não permite o evento; o CT-e precisa estar `Autorizada`.
10017042	400	Texto do evento inválido: comprimento fora do intervalo após a sanitização.
10017043	400	A SEFAZ rejeitou o evento; `mensagem` traz o código de retorno e o motivo dela.
10001001	400	Falha de validação de campos, uma entrada por campo; corrija conforme `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=..."

}

Comprovante de entrega

Parâmetros

Parâmetros de caminho

Corpo da requisição

Respostas

Sanitização de texto

Enumerações3 tabelas

tipoTipo do evento

codigoCódigo do evento

statusCódigo de retorno do registro

Erros7 itens

`tipo`Tipo do evento

`codigo`Código do evento

`status`Código de retorno do registro