TF Fiscal
Documentação

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.

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

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

  • dataEntregastringobrigatório

    Data e hora da entrega, ISO-8601 com deslocamento, por exemplo 2026-09-06T10:00:00-03:00.

    Exemplo: 2026-09-06T10:00:00-03:00
  • documentoRecebedorstringobrigatório

    Documento de quem recebeu (nDoc), 2 a 20 dígitos.

    Exemplo: 12345678909
  • nomeRecebedorstringobrigatório

    Nome de quem recebeu (xNome), 2 a 60 caracteres.

    Exemplo: JOSE DA SILVA
  • latitudenumberopcional

    Latitude da entrega (opcional), registrada com seis casas decimais.

  • longitudenumberopcional

    Longitude da entrega (opcional), registrada com seis casas decimais.

  • hashEntregastringobrigatório

    Base64 do SHA-1 da imagem do comprovante (hashEntrega).

    Exemplo: 2jmj7l5rSw0yVb/vlWAYkK/YBwk=
  • dataHashEntregastringobrigatório

    Data e hora de geração da imagem, ISO-8601 com deslocamento.

    Exemplo: 2026-09-06T10:01:00-03:00
  • chavesNfearrayopcional

    Chaves das NF-e entregues (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ódigoHTTP
CTe0001404

cteId não encontrado ou não pertence à empresa. Verifique o id e o empresaId.

10003000404

empresaId não encontrado.

10017040400

O status do documento não permite o evento; o CT-e precisa estar Autorizada.

10017042400

Texto do evento inválido (comprimento fora do intervalo após a sanitização).

10017043400

A SEFAZ rejeitou o evento; mensagem traz o cStat e o motivo.

10001001400

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.

AnteriorCarta de correçãoPróximoCancelar comprovante de entrega