NFeEnviaEmail (obsoleta)

Função obsoleta: com a adoção da criptografia STARTTLS, está função foi substituída pela NFeEnviaEmailV2, que além das criptografias já suportadas por esta função, também suporta a STARTTLS.

A função NFeEnviaEmail permite enviar e-mail em formato texto ou html e com ou sem anexos.

Tipo de Retorno

Integer

Pacote

A função NFeEnviaEmail está definida dentro do pacote NF-eEnviaEmail.pkg.

Sintaxe

Move (NFeEnviaEmail({sRemetente}, {sNomeRemetente}, {sDestinatarios}, ;
                    {sBCC}, {sAssunto}, {sMensagem}, {sAnexos}, {sSMTP}, ;
                    {iPortaSMTP}, {iSSL}, {sSMTPUsuario},  {sSMTPSenha}, ;
                    &{sMsgResultado}, {bExibeErro} [, {bHTML}, ;
                    {bConfirmacaoLeitura}, {iTimeout}])) to {iRet}

Onde:

  • {sRemetente} é o endereço de e-mail do remetente;
  • {sNomeRemetente} é o nome do remetente;
  • {sDestinatarios} informe o endereço do destinatário, sendo possível informar mais de 1 endereço separando os endereços por ponto-e-vírgula (;) ou vírgula (,);
  • {sBCC} informe os endereços para cópia oculta da mensagem (BCC - Blind Carbon Copy), sendo possível informar mais de 1 endereço separando por ponto-e-vírgula (;) ou vírgula (,);
  • {sAssunto} é o assunto do e-mail;
  • {sMensagem} é a mensagem do corpo do e-mail, sendo a quebra de linha identificada pelos caracteres 13 e 10;
  • {sAnexos} é a lista de arquivos que serão enviados como anexo, sendo que os arquivos devem ser informados com o caminho completo do arquivo, e para informar mais de 1 arquivo basta separá-los por ponto-e-vírgula (;) ou vírgula (,);
  • {sSMTP} é o endereço de SMTP que será usado para enviar o e-mail, como por exemplos smtp.live.com (hotmail) ou smtp.gmail.com (gmail);
  • {iPortaSMTP} é a porta utilizada para comunicação com o servidor SMTP, sendo que a maioria dos servidores usam a porta 25, mas há exceções. O gmail, por exemplo, usa a porta 587;
  • {iSSL} indica se o servidor usa SSL (1) ou não (0). O gmail, por exemplo, usa SSL e se não for informado 1 neste parâmetro a autenticação irá falhar;
  • {sSMTPUsuario} é o nome do usuário para acessar o servidor SMTP, sendo que em alguns servidores o usuário é a parte que vem antes do "@" no endereço de e-mail e em outros é o próprio endereço de e-mail;
  • {sSMTPSenha} é a senha para acessar o servidor SMTP;
  • &(sMsgResultado} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá a mensagem literal do resultado da chamada da função;
  • {bExibeErro} é usado para indicar se a função deve exibir ou não os erros que ocorrerem na execução;
  • {bHTML} é um parâmetro opcional, por padrão False, que indica o formato da mensagem que será usado, sendo que True indica que o corpo do e-mail está em formato HTML e False indica que o corpo do e-mail é texto simples;
  • {bConfirmacaoLeitura} é um parâmetro opcional, por padrão False, que indica se será solicitada confirmação de leitura para o destinatário (True) ou não (False);
  • {iTimeout} é um parâmetro opcional, que permite definir o timeout do envio do e-mail em milisegundos. Caso o parâmetro não seja informado a NFeLibrary utiliza como padrão 180.000 ms.
  • {iRet} é o código do retorno da chamada da função onde 0 (zero) indica que o e-mail foi enviado e qualquer valor diferente de 0 (zero) indica que houve algum erro no envio.

Observações

  • O parâmetro {iTimeout} está disponível a partir da versão 2022/01.
  • É muito comum que o envio de e-mails por esta função seja bloqueado por programas de antivírus, gerando erro para a função. Neste caso, consulte a documentação do seu programa de e-mail para verificar como fazer para configurar o antivírus para não bloquear o envio.
  • Em 10/09/2015, tivemos relatos de dificuldades para usar a função com o gmail. Fizemos testes e tivemos sucesso no envio após habilitar a opção "Permitir aplicativos menos seguros" na conta do google e usando a porta 587 com SSL=1. Para mais detalhes sobre a opção, acesse este link: https://support.google.com/accounts/answer/6010255?hl=pt-BR.
  • No caso de dúvidas referente às informações do servidor como endereço SMTP, porta de comunicação, utilização do protocolo SSL e/ou usuário de autenticação consulte o suporte técnico do seu provedor de e-mail.
  • A função considerará o corpo do e-mail como texto simples caso o parâmetro {bHTML} não seja informado.
  • Caso o parâmetro {bConfirmacaoLeitura} não seja informado será considerado False, indicando que não será solicitada ao destinatário a confirmação do recebimento do e-mail.
  • A função não suporta o uso de proxy.

Configuração dos provedores mais utilizados

Provedor SMTP Porta SSL Usuário
Genérico smtp.dominio 25 Não usuario@dominio
GMail smtp.gmail.com 587 Sim usuario@gmail.com
Hotmail smtp.office365.com 587 Sim usuario@hotmail.com
Yahoo smtp.yahoo.com 587 Não usuario
Yahoo Br smtp.mail.yahoo.com.br 587  Não usuario

 

Não encontrou o que precisava, entre em contato conosco.