Mudanças entre as edições de "UniDANFE/Integrando o UniDANFE ao ERP/ManutencaoContasEmail"

De unimake
Ir para: navegação, pesquisa
(Criou página com '__NOTITLE__ {{unidanfe_header}} ===Incluir ou atualizar conta de e-mail no UniDANFE=== É possível incluir ou atualizar as contas de e-mail que o UniDANFE utiliza para envi...')
 
 
(3 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 11: Linha 11:
  
 
Para forçar a manutenção imediatamente, após gerar o arquivo execute o UniDANFE para fazer isso.
 
Para forçar a manutenção imediatamente, após gerar o arquivo execute o UniDANFE para fazer isso.
−
Ex: UniDANFE.exe envia_email=1 // a importação da conta acontece no momento em que ele envia e-mails
+
Ex: UniDANFE.exe envia_email=1   // a importação da conta acontece no momento em que ele envia e-mails
  
 
Estrutura do arquivo XML com o conteúdo do e-mail a ser enviado pelo UniDANFE:
 
Estrutura do arquivo XML com o conteúdo do e-mail a ser enviado pelo UniDANFE:
Linha 28: Linha 28:
 
   <smtpHelo></smtpHelo>
 
   <smtpHelo></smtpHelo>
 
   <smtpFormatoRemetente>0</smtpFormatoRemetente>
 
   <smtpFormatoRemetente>0</smtpFormatoRemetente>
 +
  <smtpEnderecoResposta>[email protected]</smtpEnderecoResposta>
 +
  <smtpMaximoEmailsPorHora>500</smtpMaximoEmailsPorHora>
 
</contaEmail></pre>
 
</contaEmail></pre>
  
 
===Notas===
 
===Notas===
−
* TAGs obrigatórias: Destinatários, Assunto e Texto.
+
* TAGs obrigatórias: EmailRemetente, smtpServidor e smtpPorta.
−
* EmailRemetente: TAG opcional. Se existir, será utilizado esse remetente – que já deve estar previamente cadastrado no UniDANFE – para enviar o e-mail. Se essa TAG não for informada, ou se o e-mail informado não estiver cadastrado no UniDANFE, o remetente padrão cadastrado será utilizado para o envio.
 
−
* Data: TAG opcional. Se não informada, a data atual será utilizada.
 
−
* Anexo1 a Anexo9: arquivos que devem ser anexados ao e-mail. Devem ser informados os arquivos na sua pasta original, com o caminho completo. Eles não serão excluídos após importados pelo UniDANFE. A sequência deve ser informada sem “furos”. Por exemplo, se for definido <Anexo1> e <Anexo3>, apenas o <Anexo1> será utilizado, pois há um “furo” em <Anexo2>.
 
−
* Texto: - Texto do corpo do e-mail. Pode ser um texto plano ou um conteúdo HTML.
 
−
* Para o funcionamento desse recurso é necessário que a conta de e-mail do Remetente esteja devidamente cadastrada e configurada no UniDANFE, ou incluir no XML as TAGs do grupo <conta> para que o UniDANFE faça a manutenção da conta automaticamente.
 
−
 
 
−
=== Cadastro automático da conta de e-mail ===
 
−
 
 
−
Para que o UniDANFE faça o cadastro e a manutenção dos dados da conta automaticamente basta informar as TAGs do grupo <conta>.
 
−
Observe que, nesse caso, outras TAGs passam a ser obrigatórias no XML.
 
−
* TAGs obrigatórias: EmailRemetente, Destinatários, Assunto, Texto, smtpServidor, smtpPorta.
 
  
 
Conteúdo das TAGS:
 
Conteúdo das TAGS:
−
* smtpAutenticar: 1=o servidor requer autenticação (default); 0=não
+
* smtpAutenticar: 1=o servidor requer autenticação; 0=não
−
* smtpSSL: 1=autenticar usando SSL; 0=não (default)
+
* smtpSSL: 1=autenticar usando SSL; 0=não
−
* smtpTLS: 1=autenticar usando TLS; 0=não (default)
+
* smtpTLS: 1=autenticar usando TLS; 0=não
−
* smtpFormatoRemetente: [email protected] (default); 1=nome <[email protected]>
+
* smtpFormatoRemetente: [email protected]; 1=nome <[email protected]>
  
−
=== Como enviar outros emails usando a UNIDANFE_DFE.DLL ===
+
=== Como incluir ou atualizar contas de email usando a UNIDANFE_DFE.DLL ===
  
−
Caso seu sistema esteja integrado ao UniDANFE pela UNIDANFE_DFE.DLL, você pode enviar os e-mails de aplicações externas para o UniDANFE sem precisar gerar o XML acima. Basta, nesse caso, passar tudo por parâmetros.
+
Caso seu sistema esteja integrado ao UniDANFE pela UNIDANFE_DFE.DLL, você pode incluir ou atualizar as contas de e-mail sem precisar gerar o XML acima. Basta, nesse caso, passar tudo por parâmetros.
 
Os nomes dos parâmetros são idênticos aos nomes das TAGS do XML.
 
Os nomes dos parâmetros são idênticos aos nomes das TAGS do XML.
 
Abaixo, o mesmo exemplo utilizando a UNIDANFE_DFE.DLL:
 
Abaixo, o mesmo exemplo utilizando a UNIDANFE_DFE.DLL:
Linha 58: Linha 49:
 
<pre>
 
<pre>
 
   // inicializa a classe
 
   // inicializa a classe
−
   dfeInit("emailExt");
+
   dfeInit("contaEmail");
  
 
   // passa todos os parâmetro. A lista de parâmetros obrigatórios é a mesma da lista de Tags obrigatórias. Olhe a documentação acima para saber qual é.
 
   // passa todos os parâmetro. A lista de parâmetros obrigatórios é a mesma da lista de Tags obrigatórias. Olhe a documentação acima para saber qual é.
−
   dfeSetParametro("EmailRemetente", "[email protected]");                   // "remetente" também funciona
+
   dfeSetParametro("emailRemetente", "[email protected]");
−
   dfeSetParametro("NomeRemetente", "Meu Nome Ltda");
+
   dfeSetParametro("nomeRemetente", "Meu Nome Ltda");
−
  dfeSetParametro("Data", "2015-12-25");
 
−
  dfeSetParametro("Destinatarios", "[email protected]");                  // "email" também funciona
 
−
  dfeSetParametro("CC", "[email protected];[email protected]");                // "emailcc" também funciona
 
−
  dfeSetParametro("BCC", "[email protected];[email protected];[email protected]");  // "emailcco" também funciona
 
−
  dfeSetParametro("ReplyTo", "[email protected]");
 
−
  dfeSetParametro("Assunto", "Boletos para pagamento");
 
−
  dfeSetParametro("Anexo1", "c:\pasta\boleto1.pdf");
 
−
  dfeSetParametro("Anexo2", "c:\outrapasta\novoarquivo.xml");
 
−
  ...
 
−
  dfeSetParametro("Anexo9", "c:\pastaxx\teste\docto.docx");
 
−
  dfeSetParametro("Texto", "Bem vindo ao uso de e-mail externo para o UniDANFE.;;Esse é um exemplo de texto para o corpo do e-mail.;Use o ponto-e-vírgula para quebrar linhas.;;att,;Minha empresa");
 
−
 
 
−
  // Preencher essas tags abaixo apenas se você quer que a conta de e-mail seja cadastrada automaticamente do UniDANFE. Caso ela já esteja cadastrada, não precisa informá-las.
 
 
   dfeSetParametro("smtpServidor", "smtp.gmail.com");
 
   dfeSetParametro("smtpServidor", "smtp.gmail.com");
 
   dfeSetParametro("smtpPorta", "587");
 
   dfeSetParametro("smtpPorta", "587");
Linha 86: Linha 64:
 
   dfeSetParametro("smtpFormatoRemetente", "0");                            //0=Apenas o email  1=Nome + email
 
   dfeSetParametro("smtpFormatoRemetente", "0");                            //0=Apenas o email  1=Nome + email
 
   dfeSetParametro("smtpEnderecoResposta", "[email protected]");  // opcional
 
   dfeSetParametro("smtpEnderecoResposta", "[email protected]");  // opcional
−
   dfeSetParametro("smtpMaximoEmailsPorHora", 500)
+
   dfeSetParametro("smtpMaximoEmailsPorHora", 500);                        // opcional. Default=500
  
 
   // executa  
 
   // executa  
Linha 92: Linha 70:
  
 
   // verificar se deu algum erro
 
   // verificar se deu algum erro
−
   IF dfeGetErro() = ""
+
   IF NOT dfeGetErro()
−
       MESSAGE("O email foi enviado ao UniDANFE com sucesso!");
+
       MESSAGE("A conta de email foi cadastrada no UniDANFE com sucesso!");
 
   ELSE  
 
   ELSE  
 
       MESSAGE(dfeGetErro());
 
       MESSAGE(dfeGetErro());

Edição atual tal como às 15h14min de 9 de dezembro de 2025


Logo-unidanfe.png UniDANFE - Impressão e distribuição de Documentos Fiscais Eletrônicos

Home | Suporte | Download | Sobre

Incluir ou atualizar conta de e-mail no UniDANFE

É possível incluir ou atualizar as contas de e-mail que o UniDANFE utiliza para enviar e-mails com os documentos auxiliares diretamente pelo ERP.

Para isso, basta gerar um XML com a estrutura abaixo, e salvá-lo na pasta “Email\Enviar”, que fica dentro da pasta onde o UniDANFE está instalado (ex: c:\unimake\uninfe\email\enviar\conta-email.xml”), com qualquer nome único.

Após gerar o arquivo de e-mail, o UniDANFE fará a manutenção da conta de e-mail automaticamente na próxima vez em que um e-mail normal dele for gerado.

Para forçar a manutenção imediatamente, após gerar o arquivo execute o UniDANFE para fazer isso. Ex: UniDANFE.exe envia_email=1 // a importação da conta acontece no momento em que ele envia e-mails

Estrutura do arquivo XML com o conteúdo do e-mail a ser enviado pelo UniDANFE: 

<?xml version="1.0" encoding="UTF-8"?>
<contaEmail>
   <EmailRemetente>[email protected]</EmailRemetente>
   <NomeRemetente>Meu Nome Ltda</NomeRemetente>
   <smtpServidor>smtp.gmail.com</smtpServidor>
   <smtpPorta>587</smtpPorta>
   <smtpConta>[email protected]</smtpConta>
   <smtpAutenticar>1</smtpAutenticar>
   <smtpSSL>0</smtpSSL>
   <smtpTLS>1</smtpTLS>
   <smtpSenha>@MudeJa</smtpSenha>
   <smtpHelo></smtpHelo>
   <smtpFormatoRemetente>0</smtpFormatoRemetente>
   <smtpEnderecoResposta>[email protected]</smtpEnderecoResposta>
   <smtpMaximoEmailsPorHora>500</smtpMaximoEmailsPorHora>
</contaEmail>

Notas

  • TAGs obrigatórias: EmailRemetente, smtpServidor e smtpPorta.

Conteúdo das TAGS:

  • smtpAutenticar: 1=o servidor requer autenticação; 0=não
  • smtpSSL: 1=autenticar usando SSL; 0=não
  • smtpTLS: 1=autenticar usando TLS; 0=não
  • smtpFormatoRemetente: [email protected]; 1=nome <[email protected]>

Como incluir ou atualizar contas de email usando a UNIDANFE_DFE.DLL

Caso seu sistema esteja integrado ao UniDANFE pela UNIDANFE_DFE.DLL, você pode incluir ou atualizar as contas de e-mail sem precisar gerar o XML acima. Basta, nesse caso, passar tudo por parâmetros. Os nomes dos parâmetros são idênticos aos nomes das TAGS do XML. Abaixo, o mesmo exemplo utilizando a UNIDANFE_DFE.DLL: 

   // inicializa a classe
   dfeInit("contaEmail");

   // passa todos os parâmetro. A lista de parâmetros obrigatórios é a mesma da lista de Tags obrigatórias. Olhe a documentação acima para saber qual é.
   dfeSetParametro("emailRemetente", "[email protected]");
   dfeSetParametro("nomeRemetente", "Meu Nome Ltda");
   dfeSetParametro("smtpServidor", "smtp.gmail.com");
   dfeSetParametro("smtpPorta", "587");
   dfeSetParametro("smtpConta", "[email protected]");
   dfeSetParametro("smtpAutenticar", "1");
   dfeSetParametro("smtpSSL", "0");
   dfeSetParametro("smtpTLS", "1");
   dfeSetParametro("smtpSenha", "@MudeJa");
   dfeSetParametro("smtpHelo", "");
   dfeSetParametro("smtpFormatoRemetente", "0");                            //0=Apenas o email   1=Nome + email
   dfeSetParametro("smtpEnderecoResposta", "[email protected]");  // opcional
   dfeSetParametro("smtpMaximoEmailsPorHora", 500);                         // opcional. Default=500

   // executa 
   dfeExecuta();

   // verificar se deu algum erro
   IF NOT dfeGetErro()
      MESSAGE("A conta de email foi cadastrada no UniDANFE com sucesso!");
   ELSE 
      MESSAGE(dfeGetErro());
   END 

   // encerra a classe
   dfeKill();

Veja também

Disponível em "http://wiki.unimake.com.br/index.php?title=UniDANFE/Integrando_o_UniDANFE_ao_ERP/ManutencaoContasEmail&oldid=6719"