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.

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

Parâmetros de caminho

empresaIdstringobrigatório
Identificador da empresa (transportadora) devolvido no registro.
Exemplo: 1934811222334455
cteIdstringobrigatório
O id enviado na emissão do CT-e.
Exemplo: CTE-ORD-1

Corpo da requisição

dataTentativastringobrigatório
Data e hora da tentativa de entrega, ISO-8601 com deslocamento.
Exemplo: 2026-09-06T10:00:00-03:00
numeroTentativaintegeropcional
Número da tentativa (nTentativa), opcional.
Exemplo: 1
motivointegerobrigatório
Motivo (tpMotivo): 1 recebedor ausente, 2 recusa, 3 endereço incorreto, 4 outro (exige justificativa).
Valores:1234
Exemplo: 2
justificativastringobrigatório para `motivo=4`
Justificativa, 15 a 256 caracteres.
latitudenumberopcional
Latitude da tentativa (opcional), registrada com seis casas decimais.
longitudenumberopcional
Longitude da tentativa (opcional), registrada com seis casas decimais.
hashTentativastringopcional
Hash da imagem da tentativa (hashTentativaEntrega), opcional.
dataHashTentativastringopcional
Data e hora de geração da imagem, ISO-8601 com deslocamento, opcional.
chavesNfearrayopcional
Chaves das NF-e envolvidas (strings de 44 dígitos), opcional.

Respostas

200

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

chaveAcessostring
Chave de acesso de 44 dígitos do CT-e ao qual o evento foi vinculado.
tipostring
Tipo do evento.
Valores:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
Código do evento na SEFAZ (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Número sequencial do evento dentro do tipo (a carta de correção incrementa automaticamente).
statusstring
cStat devolvido pela SEFAZ; 135 significa evento registrado e vinculado.
motivostring
xMotivo devolvido pela SEFAZ.
protocolostring
Número de protocolo do evento; use-o como protocoloEvento para cancelar o evento.
datastring
Data e hora do registro do evento, ISO-8601 em UTC.
linkXmlstring
Link de download do XML do evento (procEvento). Veja Download de arquivos.

Erros

Código	HTTP
CTe0001	404	`cteId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10003000	404	`empresaId` não encontrado.
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 cStat e o motivo.
10001001	400	Falha de validação de campos (uma entrada por campo); corrija conforme `mensagem`.

Sanitização de texto e coordenadas

Os campos de texto são sanitizados (acentos removidos, espaços em branco consolidados) antes da validação de comprimento; um texto que fica fora do intervalo após a sanitização retorna 10017042. As coordenadas são registradas com seis casas decimais.