UniDANFE/Integrando o UniDANFE ao ERP/EnviarOutrosEmails
Enviar e-mails de outras aplicações com o UniDANFE
É possível usar o UniDANFE para enviar e-mails de outras aplicações, como por exemplo, enviar boletos de cobranças e outras mensagens geradas 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\boletos-fat-1234.xml”), com qualquer nome único.
Após gerar o arquivo de e-mail, o UniDANFE tentará enviá-lo automaticamente na próxima vez em que um e-mail normal dele for gerado.
Para forçar o envio imediatamente, após gerar o arquivo execute o UniDANFE para fazer isso. Ex: UniDANFE.exe envia_email=1
Estrutura do arquivo XML com o conteúdo do e-mail a ser enviado pelo UniDANFE:
<?xml version="1.0" encoding="UTF-8" ?> <emailExt> <EmailRemetente>[email protected]</EmailRemetente> <NomeRemetente>Meu Nome Ltda</NomeRemetente> <Data>2015-12-25</Data> <Destinatarios>[email protected]</Destinatarios> <CC>[email protected];[email protected]</CC> <BCC>[email protected];[email protected];[email protected]</BCC> <ReplyTo>[email protected]</ReplyTo> <Assunto>Boletos para pagamento</Assunto> <Anexo1>c:\pasta\boleto1.pdf</Anexo1> <Anexo2>c:\outrapasta\novoarquivo.xml</Anexo2> ... <Anexo9>c:\pastaxx\teste\docto.docx</Anexo9> <ComprovanteTEF1>c:\pasta\boleto1.pdf</ComprovanteTEF1> <SolicitarConfirmacaoLeitura>0</SolicitarConfirmacaoLeitura> <Prioridade>3</Prioridade> <ClienteEmailExterno>0</ClienteEmailExterno> <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</Texto> <conta> </conta> </emailExt>
Notas
- TAGs obrigatórias: Destinatários, Assunto e Texto.
- 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>.
- Prioridade: TAG opcional. Indica a prioridade do e-mail. Válidos os valores 1 (alta), 3 (normal) e 5 (baixa).
- ClienteEmailExterno: TAG opcional. Indica se será utilizado um cliente de e-mail externo para o envio do e-mail. Valores válidos: 0 (não) e 1 (sim).
- 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. Caso contrário, é obrigatório passar no XML todas as configurações da conta no grupo "<conta>" e as outras TAGs que passam a ser obrigatórias, conforme lista abaixo:
- TAGs obrigatórias: EmailRemetente, Destinatários, Assunto, Texto, smtpServidor, smtpPorta.