ERP – eDocs NFS-e Recebimento – Como realizar a análise de integração entre eDocs e o Motor Senior de Conversão para documentos recebidos por e-mail
Dúvida
Como realizar a análise de integração entre eDocs e o Motor Senior de Conversão para documentos recebidos por e-mail?
Solução
Importante
Pré-requisitos:
- Necessário conhecimento no item 1 - Verificações da documentação Verificações adicionais para recebimento de documentos eletrônicos, clique aqui e acesse o Portal de Documentação Senior, pesquise por "Verificações adicionais para recebimento de documentos eletrônicos" e localize a documentação completa desta rotina no produto eDocs;
- Necessário conhecimento na coleta e análise de logs. Verifique o artigo eDocs – Como coletar logs de texto (Sde.Log, Monitor.Log, PrintService.log);
- Necessário conhecimento no fluxo de comunicação entre o eDocs e o Motor Senior. Para mais informações consulte o artigo ERP – eDocs NFS-e Recebimento – Onde encontrar informações sobre o recebimento de NFS-e (índice);
Atenção
- Para que a análise de casos retroativos possa ser feita, é obrigatório que o parâmetro Habilitar coleta de XML esteja ativo no dia a ser analisado, ele é encontrado em Configurações / Gerais / aba Log. Se o parâmetro não estava ativo, é necessário ativá-lo e após isso realizar o envio do documento ao e-mail novamente;
- Para realizar a análise de integração entre eDocs e o Motor Senior de documentos recebidos através do e-mail, siga os passos abaixo;
Caso já tenha em mãos o arquivo original e horário que o fornecedor enviou no e-mail, vá direto ao bloco 3.
1. Identificando o e-mail que contém a NFS-e que deveria ter sido integrada;
Observação
Não há uma forma exata para encontrar o e-mail que contém o documento, então as alternativas abaixo podem ser verificadas.
1.1. Verifique o arquivo .EML do diretório de recebimento, caso tenha o parâmetro Diretório e-mails (em descontinuação) configurado em Configurações / Empresas / aba Recebimento / aba E-mail;
1.2. Analise o servidor de e-mail ou caixa de entrada para tentar localizar o e-mail;
1.3. Verifique com o fornecedor que enviou o e-mail;
2. Abra o e-mail;
2.1. Copie e/ou salve:
- O horário que o e-mail foi recebido;
- O nome do arquivo que contém a NFS-e.
3. Buscando os logs de comunicação no Sde.log;
3.1. Abra o Sde.log no horário em que o e-mail foi recebido;
3.2. Busque pelo nome do arquivo, ele será apresentado na tag <NomeArquivo>. É importante conferir a extensão pois existem casos onde é recebido o XML e o PDF com o mesmo nome. Neste ponto poderá ser encontrado o envio do arquivo ao Motor Senior.
Importante
Salve a thread que realizou o envio, dessa forma é possível encontrar facilmente o protocolo. A thread poderá ser vista entre colchetes logo no início do registro do log, após os milésimos da hora, por exemplo 2023-05-08 10:19:09,471 [6], onde o 6 é o número da thread.
3.3. Copie o protocolo retornado;
Importante
Por padrão essa informação estará logo no próximo registro de log, com alguns poucos milésimo de diferença e obrigatoriamente estará na mesma thread pois é uma comunicação síncrona.
Uma forma de validar se o protocolo realente é do arquivo a ser analisado é buscar na tabela N140CRE pelo protocolo, nesta tabela será visto o caminho do arquivo EML salvo atrelado ao protocolo, que poderá será aberto para validação dos arquivos anexados nele.
3.4. Busque pelo protocolo até que seja identificado o retorno do documento.
4. Analisando o retorno do protocolo;
4.1. Verifique as tag <Sucesso> e <Falhas>;
4.1.1. Sendo apresentada a tag <Sucesso> com o valor 1, o documento deverá estar integrado e já pode ser verificado na respectiva aba;
Importante
Havendo sucesso no retorno de um documento que foi recebido através de um PDF, mas que o município não está homologado, será gerada a crítica em NFS-e / Recebimentos / aba Críticas de integração informando que o município não está homologado. Para esse caso consulte o artigo ERP – eDocs NFS-e Recebimento – Crítica de integração: O município XXXX não é homologado para recebimento de arquivos PDF;
4.1.2. Sendo apresentada a tag <Falhas> com o valor 1, verifique a tag <Descricao> para identificar o motivo e será gerada uma crítica de integração em NFS-e / Recebimentos / aba Críticas de integração;
Observação
Para mais informações sobre o processo de recebimento de NFS-e, consulte o artigo ERP – eDocs NFS-e Recebimento – Onde encontrar informações sobre o recebimento de NFS-e (índice).