Objetivo
Esta documentação apresenta como criar, enviar, consultar e realizar o download dos arquivos relacionados ao evento de Insucesso na Entrega no Invent Apps NF-e.
O que é o evento Insucesso na Entrega?
O evento de Insucesso na Entrega é utilizado para registrar que a entrega da mercadoria vinculada à NF-e não foi concluída. O registro permite informar o motivo da não conclusão, os dados do entregador e o local onde ocorreu a tentativa de entrega.
Após o envio e processamento, o evento passa a compor o histórico da NF-e e pode ser acompanhado nas telas de eventos vinculados e na tela de eventos da NF-e.
Registrar formalmente uma tentativa de entrega não concluída, informando o motivo do insucesso, o endereço da tentativa e as informações do entregador responsável.
As informações preenchidas devem representar a situação real observada no momento da tentativa de entrega, incluindo o motivo do insucesso, o local da tentativa e os dados do entregador.
Formas de criação do evento
O evento de Insucesso na Entrega pode ser criado pelos mesmos caminhos disponíveis no assistente de eventos da NF-e.
| Local | Descrição |
|---|---|
| Notas Fiscais > Emitidas > Ações em Massa | Permite criar o evento para várias notas fiscais selecionadas na tabela de resultados, quando todas estiverem relacionadas à mesma situação de insucesso na entrega. |
| Notas Fiscais > Emitidas > Ação da linha | Permite criar o evento para uma única NF-e. Neste caso, o sistema já carrega automaticamente os dados da nota selecionada no Assistente de Evento. |
| Notas Fiscais > Eventos > Novo Evento | Permite criar o evento manualmente, informando a chave de acesso da NF-e que receberá o evento. |
O evento deve ser criado para documentos com status Autorizado. Para documentos em outros status, o sistema pode impedir a criação do evento.
Como criar o evento Insucesso na Entrega
- Acesse uma das telas disponíveis para criação do evento.
- Selecione o evento Insucesso na Entrega.
- Clique em Próximo.
- No passo de detalhes do evento, preencha os dados obrigatórios sobre a tentativa de entrega.
Campos do passo de detalhes
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome do Entregador | Sim | Nome da pessoa responsável pela tentativa de entrega. |
| Documento do Entregador | Sim | Documento de identificação do entregador responsável pela tentativa de entrega. |
| Local da tentativa de entrega | Sim | Endereço ou local onde ocorreu a tentativa de entrega. O sistema utiliza essa informação para registrar o ponto da tentativa e a geolocalização associada. |
| Motivo do Insucesso na Entrega | Sim | Motivo pelo qual a entrega não foi concluída. |
Motivos disponíveis
| Motivo | Quando utilizar |
|---|---|
| Recebedor não encontrado | Quando a entrega não foi concluída porque não havia pessoa disponível para receber a mercadoria. |
| Recusa do recebedor | Quando a pessoa localizada no ponto de entrega recusou o recebimento da mercadoria. |
| Endereço inexistente | Quando o endereço informado para a entrega não foi localizado ou não existe. |
| Outros | Quando o motivo do insucesso não se enquadra nas opções anteriores. Ao selecionar esta opção, o sistema exige o preenchimento da justificativa. |
Ao selecionar o motivo Outros, o sistema exibe o campo Justificativa. O texto deve conter no mínimo 25 caracteres e no máximo 250 caracteres.
- Clique em Próximo.
- Revise as informações apresentadas.
- Clique em Enviar Evento.
- Na janela de confirmação, confirme o envio do evento.
Após a confirmação, o sistema envia o evento para processamento.
Acompanhamento do processamento
É possível acompanhar o processamento do evento por duas telas:
- Notas Fiscais > Emitidas > Mais Opções > Eventos Vinculados
- Menu Lateral > Notas Fiscais > Eventos > aba Insucesso na Entrega
Para este evento, o sistema disponibiliza o download do XML. O evento não gera documento auxiliar específico.
| Arquivo | Regra de disponibilidade |
|---|---|
| XML | Quando o evento não estiver autorizado ou registrado, o sistema disponibiliza o XML de envio. Quando o evento estiver autorizado ou registrado, o sistema disponibiliza o XML processado. |
Tela Eventos > Insucesso na Entrega
No menu lateral, acesse Notas Fiscais > Eventos e selecione a aba Insucesso na Entrega para consultar todos os eventos desse tipo emitidos pelo sistema.
Filtros disponíveis
| Filtro | Descrição |
|---|---|
| Chave de Acesso | Permite localizar eventos vinculados a uma NF-e específica por meio da chave de acesso do documento. |
| Emitente | Filtra os eventos conforme a empresa emitente da NF-e. |
| Sequencial do Evento | Localiza eventos pelo número sequencial do evento vinculado à NF-e. |
| Data do Evento | Permite consultar eventos considerando a data em que o evento foi gerado ou registrado no sistema. |
| Nº NF-e de Origem | Filtra os eventos pelo número da NF-e de origem. |
| Status | Permite consultar eventos conforme a situação atual de processamento, como evento autorizado, rejeitado ou em processamento. |
Ações da tabela
| Ação | Descrição |
|---|---|
| Download de Arquivos | Permite realizar o download do XML do evento, seguindo a regra de disponibilidade do XML de envio ou XML processado. |
| Exportar Tabela | Gera um arquivo Excel com uma cópia dos registros selecionados via checkbox. |
| Reordenar Tabela | Restaura a ordenação padrão da tabela de resultados, baseada na Data do Evento em ordem decrescente. |
| Configuração da Tabela | Permite incluir, remover ou ajustar as colunas exibidas na tabela de resultados. |
Status do evento
| Status | Descrição |
|---|---|
| Autorizado | Indica que o evento foi autorizado e vinculado à NF-e. |
| Rejeitado | Indica que o evento foi rejeitado no processamento. Consulte o histórico para verificar a mensagem de retorno. |
| Em Processamento | Indica que o evento foi enviado e ainda aguarda retorno definitivo de processamento. |
Ações da linha
| Ação | Descrição |
|---|---|
| Detalhes do Evento | Direciona o usuário para a tela de detalhes, onde são exibidas as informações completas do evento e o histórico de processamento. |
| Download | Permite baixar o XML disponível conforme a situação do evento. |
Tela Detalhes do Evento
A tela de detalhes apresenta as informações do evento selecionado, incluindo dados da NF-e, status, protocolo, dados do entregador, motivo do insucesso, justificativa quando aplicável e localização da tentativa de entrega.
| Campo | Descrição |
|---|---|
| Chave de Acesso | Apresenta a chave de acesso da NF-e à qual o evento está vinculado. |
| Série e Número | Exibe a série e o número da NF-e de origem relacionada ao evento. |
| Nº Tentativa Entrega | Indica o número da tentativa de entrega registrada para a NF-e. |
| Status | Demonstra a situação atual do evento. |
| Emitente | Exibe a razão social e o CNPJ da empresa emitente da NF-e. |
| Data/Hora da Tentativa | Informa a data e hora registradas para a tentativa de entrega. |
| Protocolo | Exibe o número de protocolo retornado no processamento do evento. |
Detalhes do Evento
| Campo | Descrição |
|---|---|
| Entregador | Exibe o nome e o documento do entregador informado na criação do evento. |
| Endereço Interpretado | Endereço interpretado pelo sistema a partir do local informado para a tentativa de entrega. |
| Motivo do Insucesso na Entrega | Exibe o motivo selecionado no assistente de eventos. |
| Longitude e Latitude | Apresenta as coordenadas geográficas relacionadas ao local da tentativa de entrega. |
| Justificativa | Exibida quando o motivo selecionado exige detalhamento, como no caso da opção Outros. |
| Mapa | Exibe visualmente o ponto relacionado ao endereço interpretado e às coordenadas da tentativa de entrega. |
Histórico de processamento
A aba de histórico de processamento apresenta as etapas registradas para o evento, permitindo acompanhar o retorno obtido no processamento.
| Coluna | Descrição |
|---|---|
| Status | Apresenta a situação do processamento registrado no histórico. |
| Data/Hora de Processamento | Informa a data e hora em que a etapa foi processada. |
| Mensagem | Exibe a mensagem de retorno do processamento, como confirmação de recebimento, enfileiramento, protocolo ou motivo de rejeição. |
Quando o evento estiver rejeitado, consulte o histórico de processamento para identificar a mensagem apresentada e avaliar a necessidade de ajuste ou novo envio.
FAQ
Utilize quando a entrega da mercadoria não foi concluída e for necessário registrar o motivo da tentativa sem sucesso.
O sistema exibe o campo Justificativa, que deve ser preenchido com no mínimo 25 e no máximo 250 caracteres.
Não. Para este evento, o sistema disponibiliza o download do XML.
O motivo pode ser consultado na tela Detalhes do Evento, na aba Histórico de Processamento.