Através do Insucesso na entrega você pode indicar o insucesso de entrega da carga pelo transportador.
obs.: O insucesso de entrega possui regras e prazos definidos pela Secretaria da Fazendo que devem ser considerados e respeitados. Para maiores informações clique aqui
URL
versão 4.00
Produção: POST https://cte.ns.eti.br/cte/insuentrega
Dados de entrada
| Campo | Descrição | Observação |
|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | |
| chCTe | Chave de acesso do CT-e | |
| tpAmb | Tipo do ambiente de autorização do CT-e: 1 – Produção, 2 – Homologação | |
| dhEvento | Data e hora da ocorrência do evento | Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SSEx.: 2023-10-02T15:38:00-03:00 |
| nSeqEvento | Numero da sequência do evento | |
| nProt | Informar o número de protocolo de autorização do CTe | |
| dhTentativaEntrega | Data e hora da tentativa da entrega | Formato = AAAA-MM-DDTHH:MM:SS TZD |
| nTentativa | número da tentativa de entrega que não teve insucesso | |
| tpMotivo | Motivo do Insucesso | 1- Recebedor não encontrado; 2-Recusa do recebedor; 3-Endereço inexistente; 4-outros (exige informar justificativa) |
| xJustMotivo | Justificativa do motivo de insucesso. | informar apenas para tpMotivo = 4 |
| hashTentativaEntrega | Hash (SHA1) no formato Base64 resultante da concatenação: Chave de acesso do CTe + Base64 da imagem capturada na tentativa da entrega (Exemplo: Imagem capturada da assinatura eletrônica, digital ao recebedor, foto, etc) | Nota 1: A critério do autor deste evento, esse campo deve ser utilizado como índice para acesso as informações do insucesso de entrega. Nota 2: A SEFAZ não tem nenhum controle sobre a informação deste campo |
| dhHashTentativaEntrega | Data e hora da geração do Hash da tentativa de entrega. | Formato: AAAA-MM-DDTHH:MM:SS TZD |
| latitude | Latitude do ponto da entrega (detectado pelo equipamento do transportador, exemplo: PDA, tablet, celular) | |
| longitude | Longitude do ponto da entrega (detectado pelo equipamento do transportador, exemplo: PDA, tablet, celular) | |
| infEntrega | Grupo de informações das NFe que não tiveram sucesso na entrega ao destinatário. | Informar apenas para CTe com tipo de serviço normal |
Exemplo de requisição
Requisição do insucesso na entrega
curl -X POST
\-H "Content-Type: application/json"
\-d '{
"X-AUTH-TOKEN": "ADQWREQW561D32AWS1D6",
"chCTe": "43231007364617000135570010000072621000009843",
"tpAmb": 2,
"dhEvento": "2023-10-02T15:01:00-03:00",
"nSeqEvento": 1,
"nProt": "143230003385974",
"dhTentativaEntrega": "2023-10-02T14:55:00-03:00",
"nTentativa": "2",
"tpMotivo": 1,
"xJustMotivo": "Recebedor não encontrado",
"hashTentativaEntrega": "Tnpnek5rTTNRVFV3UkRa",
"dhHashTentativaEntrega": "2023-10-02T14:55:00-03:00",
"latitude": "-31.776000",
"longitude": "-52.359400",
"infEntrega": [
"35171108733713000761550010000109471432652222"
]
}' \
https://cte.ns.eti.br/cte/insuentrega
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| retEvento | Objeto contendo dados de processamento do CT-e | Somente em status = 200 |
| retEvento.cStat | Código de situação do processamento | |
| retEvento.xMotivo | Descrição literal da situação do processamento na Sefaz | |
| retEvento.chCTe | Chave de acesso do CT-e | |
| retEvento.dhRegEvento | Data e hora de registro do evento na Sefaz | Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS Ex.: 2016-06-13T15:04:10-03:00 |
| retEvento.nProt | Número do protocolo de autorização do evento | |
| xml | XML de distribuição do evento de cancelamento | Somente em status = 200 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "IECTe vinculado ao CT-e com sucesso",
"retEvento": {
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a CT-e",
"chCTe": "43231007364617000135570010000072241000009842",
"dhRegEvento": "2023-10-02T16:51:49-03:00",
"nProt": "143230003386069"
},
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoCTe versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/cte\"><eventoCTe versao=\"4.00\"><infEvento>...</procEventoCTe>"
}
Códigos de retorno
| Código | Descrição |
| 200 | CT-e cancelado com sucesso |
| -2 | Campos obrigatórios na requisição não informados |
| -3 | Chave de acesso inválida |
| -4 | Erro de informações de acordo com o tipo de dados |
| -5 | Erro ao enviar o cancelamento para a Sefaz. Verificar os campos codigo e descricao para mais informações |