Insucesso na Entrega

POST/v1/nfe/{id}/insucesso-entrega

Registra o evento de Insucesso na Entrega (evento 110192) de uma NF-e, quando a mercadoria não pôde ser entregue ao destinatário. O evento é roteado via SVRS (cOrgao=92).

Só se aplica a documentos com mod 55 (NF-e) que já estejam AUTORIZADA.

Esse é um evento síncrono — a resposta HTTP já traz o resultado da SEFAZ, sem necessidade de polling.

Parâmetros do corpo

data_tentativa_entregastringobrigatório

Data e hora da tentativa de entrega (formato ISO 8601, com timezone).

numero_tentativasnumber

Número de tentativas de entrega já realizadas.

motivo_insucessonumberobrigatório

Valores aceitos: 1 | 2 | 3 | 4

Motivo do insucesso: 1 Destinatário ausente, 2 Recusado, 3 Endereço não localizado, 4 Outros.

justificativa_insucessostring

Justificativa do insucesso. Obrigatório quando motivo_insucesso for 4.

latitude_entregastring | number

Latitude do local da tentativa de entrega.

longitude_entregastring | number

Longitude do local da tentativa de entrega.

hash_tentativa_entregastringobrigatório

Hash que identifica unicamente a tentativa de entrega.

data_hash_tentativastring

Data de geração do hash_tentativa_entrega.

Resposta

200 OK / 201 Created

statusstring

Valores aceitos: autorizado | erro_autorizacao

Resultado do registro junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xml_insucesso_entregastring

URL pública do XML do evento, quando autorizado.

numero_insucesso_entreganumber

Número sequencial do evento de Insucesso na Entrega registrado para este documento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../insucesso-entrega \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "data_tentativa_entrega": "2026-08-19T14:30:00-03:00",
    "numero_tentativas": 1,
    "motivo_insucesso": 1,
    "hash_tentativa_entrega": "a1b2c3d4e5f6"
  }'

Node.js

const resposta = await client.registerDeliveryFailure(invoiceId, {
  data_tentativa_entrega: '2026-08-19T14:30:00-03:00',
  numero_tentativas: 1,
  motivo_insucesso: 1,
  hash_tentativa_entrega: 'a1b2c3d4e5f6',
});
console.log(resposta.status); // 'autorizado'

Python

resposta = client.register_delivery_failure(invoice_id, {
    "data_tentativa_entrega": "2026-08-19T14:30:00-03:00",
    "numero_tentativas": 1,
    "motivo_insucesso": 1,
    "hash_tentativa_entrega": "a1b2c3d4e5f6",
})
print(resposta["status"])  # 'autorizado'

Java

RegisterDeliveryFailureData data = new RegisterDeliveryFailureData();
data.data_tentativa_entrega = "2026-08-19T14:30:00-03:00";
data.numero_tentativas = 1;
data.motivo_insucesso = 1;
data.hash_tentativa_entrega = "a1b2c3d4e5f6";

SyncEventResponse resposta = client.registerDeliveryFailure(invoiceId, data);
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "caminho_xml_insucesso_entrega": "https://storage.../evento-insucesso-entrega.xml",
  "numero_insucesso_entrega": 1
}

Cancelar insucesso de entrega

DELETE/v1/nfe/{id}/insucesso-entrega

Cancela o evento de Insucesso na Entrega (evento 110193) autorizado mais recentemente para este documento.

Sem parâmetros

Esta chamada não recebe corpo nem número de evento: ela cancela automaticamente o último Insucesso na Entrega autorizado registrado neste documento.

cURL

curl -X DELETE https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../insucesso-entrega \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI"

Node.js

const resposta = await client.cancelDeliveryFailure(invoiceId);
console.log(resposta.status); // 'autorizado'

Python

resposta = client.cancel_delivery_failure(invoice_id)
print(resposta["status"])  # 'autorizado'

Java

SyncEventResponse resposta = client.cancelDeliveryFailure(invoiceId);
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "caminho_xml_cancelamento_insucesso_entrega": "https://storage.../evento-cancelamento-insucesso-entrega.xml",
  "numero_cancelamento_insucesso_entrega": 1
}

Resposta

200 OK

statusstring

Valores aceitos: autorizado | erro_autorizacao

Resultado do cancelamento junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xml_cancelamento_insucesso_entregastring

URL pública do XML do evento de cancelamento, quando autorizado.

numero_cancelamento_insucesso_entreganumber

Número sequencial do evento de cancelamento registrado para este documento.