ERP - eDocs NFS-e - Como enviar arquivo XML/DANFSE da NFS-e para mais de um e-mail automaticamente (utilizando regra personalizada)
Dúvida
Como enviar arquivo XML/DANFSE da NFS-e para mais de um e-mail automaticamente, seja esse e-mail fixo ou variável, utilizando regra personalizada?
Exemplo de cenário sobre envio de e-mail fixo: além de enviar o XML/DANFSE para o email cliente@senior.com.br, a necessidade também enviar de forma fixa uma cópia desse e-mail para contabilidade@senior.com.br.
Solução
Importante
- Esse artigo tem como objetivo reportar informações sobre um processo automatizado de envio de DANFSE/XML da NFS-e. Para o envio manual, verifique o artigo ERP - eDocs E-mail - Como enviar arquivo XML/DANFE/DANFSE/DACTE da NF-e/NFS-e/CT-e para mais de um e-mail manualmente;
- Verifique também as informações presentes no artigo ERP - eDocs NF-e - Como enviar arquivo XML/DANFE/DANFSE da NF-e/NFS-e para mais de um e-mail automaticamente (sem utilizar regra personalizada);
- Esta solução aplica-se apenas para NFS-e. Para informações sobre NF-e, verifique o artigo ERP - eDocs NF-e - Como enviar arquivo XML/DANFE da NF-e para mais de um e-mail automaticamente (utilizando regra personalizada).
Observação
O campo 'Destinatário' da parametrização de e-mails do eDocs serve para especificar um destinatário padrão para receber os e-mails de alerta do eDocs e não um e-mail padrão para receber o arquivo XML e PDF da DANFE. Caso este campo seja mantido em branco, os e-mails de alerta serão enviados para o e-mail informado no campo Remetente;
1. Envio pelo modelo convencional (endereço presente em tag do XML, sendo interpretada pelo eDocs para envio do e-mail)
Neste caso, a parametrização deve ser feita no Gestão Empresarial | ERP Senior e não no eDocs. Verifique os passos a seguir:
1. Cadastre e ative na tela F098REG - Cadastros / Identificadores e parâmetros / Identificador de Regras o identificador de regras GER-000ABRASF1. Clique aqui para acessar a documentação do identificador;
1.1. Defina uma regra onde seja retornado para a variável VSIntTomEml o endereço de e-mail para o qual você deseja enviar o XML/DANFSE.
Importante
- Ao retornar um valor para a variável VSIntTomEml o valor anterior sugerido pelo sistema (com base no campo 'Email para documentos eletrônicos' do cadastro do Cliente na tela F085CAD - Cadastros / Clientes e Fornecedores / Clientes / Cadastro será sobreposto. Sendo assim, a sua regra personalizada deverá tratar adequadamente o valor a ser retornado para essa variável, conforme a sua necessidade;
- A quantidade máxima de caracteres permitida para a tag <email> do grupo <Tomador> (que é gerada baseada na variável VSIntTomEml) é de 80 caractyeres, conforme padrão ABRASF 1.0 seguido pelo eDocs.
Observação
- As Prefeituras para onde as NFS-e serão enviadas poderão ter restrições como, por exemplo, tag para envio do e-mail menor que 60 caracteres, ou até mesmo, a impossibilidade de definição de mais de um e-mail para o tomador;
- A utilização de mais de um e-mail no cadastro do tomador do serviço no Gestão Empresarial | ERP deverá ser homologada para cada Prefeitura para onde as NFS-e são enviadas, do contrário, poderão haver inconsistências no envio das NFS-e;
- Caso a Prefeitura para onde você esteja enviando NFS-e permita o envio de tags de e-mails de forma diferenciada (Exemplo: em outras tags, com mais caracteres do que o padrão ABRASF 1.0), havendo necessidade desse tipo de tratativa na integração Gestão Empresarial | ERP com eDocs, é necessário o registro de um ticket para o seu Canal de Atendimento com todas as evidências dessa questão (principalmente manuais de integração da Prefeitura). Com base nisso será realizada análise e validação da possibilidade de homologação desse cenário específico.
2. Envio do e-mail posterior à autorização, de forma customizada
A possibilidade de customização para a rotina envolve:
- Utilização de regra customizada no Gestão Empresarial | ERP;
- Lógica customizada para acionamento desta regra (exemplo: processo agendado que se baseie em campos/tabelas também personalizadas para controle do processo);
- Cadastramento e utilização do WebService de Envio de E-mail do eDocs como um WebService de terceiros dentro do Gestão Empresarial | ERP.
Descrição para a solução customizada:
O eDocs possui o WebService de E-mail. Esse WebService permite solicitar o envio de e-mail de uma NFS-e incluindo destinatários adicionais nessa solicitação.
Então, os passos que você pode seguir para tratar essa questão de forma personalizada são:
2.1. Cadastre o WebService de E-mails do eDocs como um WebService de terceiros no Gestão Empresarial | ERP;
2.2. A partir disso, utilize uma personalização (regra LSP) que chame o WebService do eDocs e solicite o envio de e-mail para endereços de e-mail adicionais após a autorização da NFS-e ter sido retornada ao ERP. Isso pode ser feito baseando-se nos registros da tabela E140IDE e a execução desse processo pode ser feita através de um processo agendado do tipo regra, que busca os endereços de e-mail adicionais e faz a chamada do WebService do eDocs;
2.3. Utilize artefatos customizados adicionais (tabelas/campos) para controle da sua customização.
Observação
Caso você precise de apoio para criar essa customização, poderá adquirir horas de Consultoria para apoiá-lo na implantação desta rotina.