CT-e

Insucesso na entrega

Registra o evento 110190, insucesso na entrega, em um CT-e autorizado.

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

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

O insucesso na entrega é o evento com que a transportadora registra na SEFAZ que tentou entregar e não conseguiu, dizendo quando tentou e por que falhou. 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 insucesso na entrega.

Parâmetros de caminho

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

* Campo obrigatório

Corpo da requisição

`dataTentativa*`	string	Momento da tentativa
`numeroTentativa`	int	Número da tentativa
`motivo*`	int	Motivo do insucesso
`justificativa*` obrigatório para `motivo=4`	string	Justificativa
`latitude`	number	Latitude da tentativa
`longitude`	number	Longitude da tentativa
`hashTentativa`	string	Impressão digital da imagem
`dataHashTentativa`	string	Momento da imagem
`chavesNfe`	array	Chaves das NF-e da tentativa

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

`motivo`Motivo do insucesso

Valores	Significado
1	Recebedor não encontrado
2	Recusa do recebedor
3	Endereço inexistente
4	Outros; exige `justificativa`

`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}/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=..."

}

Insucesso na entrega

Parâmetros

Parâmetros de caminho

Corpo da requisição

Respostas

Sanitização de texto

Enumerações4 tabelas

motivoMotivo do insucesso

tipoTipo do evento

codigoCódigo do evento

statusCódigo de retorno do registro

Erros7 itens

`motivo`Motivo do insucesso

`tipo`Tipo do evento

`codigo`Código do evento

`status`Código de retorno do registro