FOfocusnfe
CTe/CTeOs

Emitir Evento

Com os eventos é possível vincular a um CT-e qualquer ato, realizado por agente envolvido ou relacionado com a operação acobertada pelo CT-e.

O tipo do evento é informado pelo parâmetro tipo_evento. Atualmente o único evento disponível é o Insucesso na Entrega (insucesso_entrega), que indica o insucesso na entrega da carga pelo transportador e é exclusivo da versão 4.00 do CT-e.

Este endpoint possui retorno síncrono.

Veja abaixo os campos que podem ser enviados na requisição.

post/cte/{referencia}/evento

Request

  • Base URL
    https://api.focusnfe.com.br/v2
  • URL
    https://api.focusnfe.com.br/v2/cte/{referencia}/evento
  • Auth
    HTTP basic

Path parameters

referenciastring required

Referência do CT-e

Request body

tipo_evento'insucesso_entrega' required

Tipo do evento. Informar um dos códigos abaixo:

  • insucesso_entrega: Indica o insucesso na entrega da carga pelo transportador (exclusivo da versão 4.00 do CT-e)
data_tentativa_entregastring date-time

Data e hora da tentativa de entrega, no formato AAAA-MM-DDThh:mm:ssTZD. Obrigatório para o evento insucesso_entrega.

numero_tentativainteger

Número da tentativa de entrega que não teve sucesso.

motivo_insucesso1 | 2 | 3 | 4

Motivo do insucesso na entrega:

  • 1: Recebedor não encontrado
  • 2: Recusa do recebedor
  • 3: Endereço inexistente
  • 4: Outros (exige informar a justificativa)
justificativa_insucessostring

Justificativa do motivo de insucesso. Informar apenas quando motivo_insucesso for igual a 4.

latitudestring

Latitude do ponto de entrega.

longitudestring

Longitude do ponto de entrega.

hash_tentativa_entregastring

Hash (SHA1) em Base64 resultante da concatenação da chave de acesso do CT-e com o Base64 da imagem capturada na tentativa de entrega.

data_hash_tentativa_entregastring date-time

Data e hora de geração do hash da tentativa de entrega, no formato AAAA-MM-DDThh:mm:ssTZD.

Example request

{
  "tipo_evento": "insucesso_entrega",
  "data_tentativa_entrega": "2026-10-19T10:00:00-03:00",
  "numero_tentativa": 1,
  "motivo_insucesso": 4,
  "justificativa_insucesso": "Recebedor ausente no endereço informado.",
  "latitude": "-23.5505",
  "longitude": "-46.6333",
  "hash_tentativa_entrega": "SGVsbG8gV29ybGQgSGVsbG8=",
  "data_hash_tentativa_entrega": "2026-10-19T10:00:00-03:00",
  "notas_fiscais": [
    {
      "chave_nfe": "35230912345678000199550010000000011000000017"
    }
  ]
}

Response

Requisição processada com sucesso

eventostring

Nome do evento enviado

status_sefazstring

Status do evento na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ detalhando o status

status'autorizado' | 'erro_autorizacao'

Autorizado, se o evento for registrado com sucesso, ou erro_autorizacao, se houve algum erro no registro do evento

caminho_xml_evento_[NOME_DO_EVENTO]string

Caso o evento tenha sido registrado, será informado aqui o caminho para download do XML

numero_evento_[NOME_DO_EVENTO]string

Número sequencial do evento

numero_protocolostring

Número do protocolo do evento

Changes

No recorded changes to this operation across all 1 revision of this API.