---
title: "Emitir Evento"
method: POST
path: "/cte/{referencia}/evento"
tags: ["CTe/CTeOs"]
---

# Emitir Evento

`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

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.

## Path parameters

- `referencia` string, required

## Request body

- EventoCteRequest
  - `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_entrega` string, date-time: Data e hora da tentativa de entrega, no formato AAAA-MM-DDThh:mm:ssTZD. Obrigatório para o evento `insucesso_entrega`.
  - `numero_tentativa` integer: Número da tentativa de entrega que não teve sucesso.
  - `motivo_insucesso` 1 | 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_insucesso` string: Justificativa do motivo de insucesso. Informar apenas quando `motivo_insucesso` for igual a 4.
  - `latitude` string: Latitude do ponto de entrega.
  - `longitude` string: Longitude do ponto de entrega.
  - `hash_tentativa_entrega` string: 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_entrega` string, date-time: Data e hora de geração do hash da tentativa de entrega, no formato AAAA-MM-DDThh:mm:ssTZD.
  - `notas_fiscais` object[]: Lista das NF-e que não tiveram sucesso na entrega ao destinatário. Informar apenas para CT-e com tipo de serviço Normal.
    - `chave_nfe` string: Chave de acesso da NF-e com insucesso na tentativa de entrega.

## Response `200`

Requisição processada com sucesso

- EventoCteResponse
  - `evento` string: Nome do evento enviado
  - `status_sefaz` string: Status do evento na SEFAZ
  - `mensagem_sefaz` string: 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_protocolo` string: Número do protocolo do evento

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `404`: Recurso não encontrado
- `422`: O servidor entendeu a requisição, mas os dados são inválidos ou não podem ser processados

---

[API](https://skmtc.dev/focusnfe/apis/cte-cteos.md) - [All operations](https://skmtc.dev/focusnfe/apis/cte-cteos/llms.txt) - [OpenAPI document](https://skmtc.dev/focusnfe/apis/cte-cteos/revisions/08b71d5f64bf?raw)