Enviando um e-mail para o Sacado
O Envio de e-mail se resume em preenchermos um modelo de integração (TX2) com os dados da conta e enviarmos para nosso servidor.
Método
O método FBoletoX.EnviarEmailLote possui apenas um parâmetro no formato WideString, nele deve ser informado o TX2 com as informações para o envio de e-mail.
TspdBoletox.EnviarEmailLote(WideString)
Campos
Para solicitar a impressão, o TX2 pode ter os seguintes campos:
Campo | Tipo | Descrição |
IdIntegracao | array | Objeto array com os IdIntegracao dos boletos que serão enviados por e-mail. Os IdIntegracao devem ter a vírgula como separador. |
EmailNomeRemetente | string | Nome do Remetente do e-mail. Esse nome irá aparecer na caixa de entrada do Sacado. |
EmailRemetente | string | E-mail do Remetente do e-mail. Caso o Sacado responda o e-mail, o mesmo será enviado para o usuário informado aqui. |
EmailAssunto | string | Assunto do e-mail enviado. |
EmailMensagem | string | Corpo da mensagem enviada no e-mail. Caso não deseje enviar o PDF em anexo, você pode usar a variável ${linkBoleto} no corpo do e-mail. Caso a mensagem não seja HTML (ou seja, EmailConteudoHtml seja false) pode-se utilizar o caractere pipe (|) para quebrar a linha. |
EmailDestinatario | array | Array com os e-mails dos destinatários. Os e-mails devem ter a vírgula como separador. |
EmailAnexarBoleto | boolean | Caso não queira utilizar o variável do link, você pode anexar o boleto no envio de e-mail. Informe o valor true para que o mesmo seja enviado como anexo para o Sacado. Caso não seja informado, iremos assumir o valor false. |
EmailConteudoHtml | boolean | Campo indica se o valor informado em EmailMensagem é um HTML ou texto normal. Informe o valor true para que o mesmo seja enviado como HTML. Caso não seja informado, iremos assumir o valor false. |
TipoImpressao | string | Campo que determina o Layout da impressão "0" Impressão normal. "1" Impressao carnet duplo (paisagem). "2" Impressao carnet triplo (retrato). "3" Impressao dupla (retrato). "4" Impressão normal (Com marca D'água) "99" para impressão personalizada. |
OutrosAnexos | Objeto | Informar o caminho do anexo, ex: "D:\Documentos\Teste\Exemplo.pdf" |
Os envios de e-mail para o TipoImpressao 0, 1, 2 e 3 tem o limite de 100 boletos por requisição,e para o TipoImpressao 4 e 99 possuem limite de 50 boletos por requisição.
É possível enviar no mesmo e-mail mais de um boleto para o destinatário, para isso basta informar no TX2 os IdIntegracao a serem enviados separados por virgula (",").
O campo EmailMensagem é do tipo texto, caso queira quebrar linhas, utilize o caractere pipe ("|"). Porém é possível mudar o tipo deste campo para HTML, para isso deve ser informado o campo EmailConteudoHtml=true no TX2 e o EmailMensagem poderá receber o conteúdo do HTML que você definir.
Para enviarmos o link para download do PDF ao cliente basta adicionar a string "${linkBoleto}" em qualquer posição no campo EmailMensagem, ou se preferir também é possível enviar com o PDF do boleto em anexo, para isso basta adicionar o campo EmailAnexarBoleto=true, desta forma o PDF do boleto já estará anexado no e-mail.
O envio é feito de forma assíncrona, por isso ao solicitar o envio do e-mail, será retornado um Protocolo. Você deve guardar este Protocolo, pois no próximo passo ele será utilizado para realizar a consulta, e verificar o status do envio.
Abaixo, segue um modelo de exemplo para ser informado como parâmetro no método EnviarEmailLote.
Modelo de Exemplo:
Exemplo de TX2:
INCLUIREMAIL
IdIntegracao=BkeSfKvXKg,BkeSfASXKg,BQtpfKvXKg
EmailNomeRemetente=Nome do Remetente
EmailRemetente=naoresponda@minhaempresa.com.br
EmailAssunto=Boleto para pagamento
EmailMensagem=Prezado cliente, segue link para pagamento de seu boleto ${linkBoleto}
EmailDestinatario=email1@destinatario.com,email2@destinatario.com
TipoImpressao=99
SALVAREMAIL
Retorno
Exemplo de retorno em caso de sucesso:
.:: Enviar Email Lote ::.
Mensagem: Solicitação pendente de processamento
Status: SUCESSO
Protocolo: HJiyP1g9X
Exemplo de retorno com erro:
.:: Enviar Email Lote ::.
Mensagem: Erro de validação.
'idintegracao': Campo obrigatório.
Status: ERRO
Protocolo:
ErroClasse: VALIDACAO
Abaixo, segue um exemplo implementado de como solicitar o envio de e-mail para as seguintes linguagens.
Exemplos
Delphi
_EnviarEmailLoteResposta := FBoletoX.EnviarEmailLote("Conteúdo do arquivo TX2");
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
C#
_EnviarEmailLoteResposta = boletox.EnviarEmailLote("Conteúdo do arquivo TX2");
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
Visual Basic 6
Set retornolote = FBoletoX.EnviarEmailLote("Conteúdo do arquivo TX2")
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
Fox Pro
retornolote = Boleto.EnviarEmailLote("Conteúdo do arquivo TX2")
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
Comentários
0 comentário
Por favor, entre para comentar.