Emitir Evento

post

https://api.focusnfe.com.br/v2/cte/{referencia}/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.

Path Params

referencia

string

required

Referência do CT-e

Body Params

tipo_evento

string

enum

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)

Allowed:

data_tentativa_entrega

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

integer

enum

Motivo do insucesso na entrega:

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

Allowed:

justificativa_insucesso

string

length between 15 and 256

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

date-time

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

notas_fiscais

array of objects

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.

notas_fiscais

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Requisição processada com sucesso

400Requisição inválida

401Não autorizado

404Recurso não encontrado

422O servidor entendeu a requisição, mas os dados são inválidos ou não podem ser processados