GF - Como Fazer - Envio de Boletos por e-mail - Parametrização de Assunto e Modelo HTML

Objetivo

Este manual tem por objetivo demonstrar todas as formas de envio de e-mail de boletos disponíveis no ERP CIGAM, além de apresentar o novo formato de configuração de assuntos, nomenclatura de arquivos e novo modelo HTML com logo do cliente desenvolvidos na OS 759090/3.

Novas configurações de nomenclatura e assunto

3205 - Normatizar o nome do arquivo do boleto nos e-mails

Esta configuração visa normatizar a nomenclatura do arquivo de boleto enviado por e-mail e ainda viabilizar um novo formato de nomenclatura para o seu assunto quando utilizada em conjunto com a configuração 3206. Nesta liberação também foram disponibilizadas novas variáveis e modelo para a versão HTML do modelo que serão apresentadas mais adiante neste mesmo documento.

Todas as funcionalidades descritas neste documento partem do princípio de que esta configuração será marcada, sendo elas:

• Envio através do botão “imprimir/boleto” da tela de lançamento financeiro:

• Envio através do botão “Enviar e-mail de boleto” da capa da nota fiscal de saída:

• No momento da confirmação da NFe (mercadorias):

• Através da rotina de envio de boletos personalizados:

Conforme já demonstrado no conteúdo adicional da configuração, a nomenclatura dos arquivos de boletos enviados nos e-mails para estes quatro locais será a seguinte: “%NOME_MODELO_REL%_UN_SERIE_NF_LANCTO”.

Observações

• Este já era o formato utilizado pelo envio de e-mail no método de confirmação da NFe, porém nos demais locais a nomenclatura era apenas: “%NOME_MODELO_REL%”.

• Na impressão de lançamentos financeiros onde não haja número de série/nota, as lacunas referentes a essa informação serão suprimidas.

Exemplo:
“%NOME_MODELO_REL%_UN_LANCTO”

• A informação “LANCTO” na tag final do nome sempre se referirá ao primeiro lançamento do documento, ou seja, uma nota com dois lançamentos de números 1234 e 1235 terá o seu arquivo nomeado com 1234 no final.

Exemplo de e-mail com a configuração 3205 marcada

Onde:

0098_brasil_PIX_CTF = %NOME_MODELO_REL%
003 = UN de negócios
1_30281 = SÉRIE + NF
18777 = NÚMERO DO PRIMEIRO LANÇAMENTO DA NF

3206 - Personalizar assunto dos e-mails de boletos

Com a configuração 3206 será possível editar o assunto do e-mail de cobrança. Conforme apresentado na imagem abaixo, basta compor o assunto com qualquer combinação de texto fixo mais as variáveis disponíveis.

Exemplo de e-mail parametrizado com a configuração 3206

• Dado config: Boleto de cobrança de #A referente à NF #E emitida em #F
• Resultado no e-mail: Boleto de cobrança de ABYZ referente à NF 1/30280 emitida em 19/04/2023.

Observações:

• Esta configuração é dependente da marcação da configuração GF - GE - 3205 - Normatizar nome do arquivo do boleto nos e-mails e caso você deseje permanecer com o assunto no formato antigo deve apagar o conteúdo padrão preenchido na configuração GF - GE - 3206 - Personalizar assunto dos e-mails de boletos, caso contrário o novo formato será utilizado automaticamente.

• Esta configuração é válida para os quatro locais já apresentados neste manual: botão “imprimir boleto” do lançamento financeiro, botão “enviar boleto de NF” da nota fiscal de saída, rotina de confirmação da NFe (uso do botão “enviar NFe”) e a rotina de emissão de boletos personalizados.

Regra de busca do CIGAM utilizando as configurações 3205 e 3206

Com a adição das novas configurações GF - GE - 3205 - Normatizar nome do arquivo do boleto nos e-mails e GF - GE - 3206 - Personalizar assunto dos e-mails de boletos, a Regra de busca para a nomenclatura do assunto e dos arquivos de boletos enviados por e-mail ficará assim:

1. Parâmetro definido pela rotina em execução (ex: rotina de “emissão boletos personalizados”, campo “assunto parametrizável do e-mail”, programa customizado, etc);

• Desta forma, caso um cliente ainda tenha porventura informações preenchidas no campo abaixo ou alguma customização neste âmbito, elas continuarão valendo até que sejam removidas:

2. Parametrizações informadas nas configurações GF - GE - 3205 - Normatizar nome do arquivo do boleto nos e-mails e GF - GE - 3206 - Personalizar assunto dos e-mails de boletos;

3. Texto fixo “Boleto de cobrança”.

Regra de divisão dos filtros da rotina de boletos personalizados

Devido à sua natureza de multiplicidade de movimentos resultantes dos seus filtros, a rotina de envio de boletos em lote irá enviar uma mensagem (e-mail) com boletos para cada combinação de:

Cliente + Unidade de negócios + Portador + Nota Fiscal/Série

1. Exemplo:

Cliente	UN	Portador	NF/Série	N° lanctos	Resultado
000066	001	I01	336/1	3	3 e-mails
000066	001	I01	337/1	10
000066	002	I01	4577/2	5

Neste exemplo, temos 3 notas do mesmo cliente, com unidades de negócio variadas e de mesmo portador. Essa combinação resultará em 3 e-mails com um arquivo PDF com 3, 10 e 5 boletos em seu conteúdo.

2. Exemplo:

Cliente	Un. de negócios	Portador	Nota Fiscal/Série	N° lanctos	Resultado
000066	001	I01	336/1	3	2 e-mails
000066	001	I01	337/1	10

Neste exemplo, temos 2 notas do mesmo cliente, com unidades de negócio iguais e de mesmo portador. Essa combinação resultará em 2 e-mails com um arquivo PDF com 3 e 10 boletos em seu conteúdo.

Através dos exemplos apresentados fica demonstrado que haverá sempre um e-mail por nota fiscal mesmo que as outras 3 informações utilizadas pelo CIGAM para agrupar os movimentos sejam iguais.

Modelo de e-mail de boleto personalizado em HTML (logo cliente)

Parametrização do modelo HTML de e-mail de boleto

A utilização do modelo de e-mail personalizável, embora facultativa é uma ótima forma de apresentar uma informação mais agradável aos olhos do receptor, para tanto, deve-se realizar a parametrização conforme a imagem abaixo:

• Modelo apontado através do botão “Modelo HTML”:

• Utilizar a opção “Enviar boleto por e-mail” marcada:

Exemplo de envio sem o uso de HTML e configs 3205 e 3206 inativas

O e-mail será impresso neste formato sem o uso das novas configurações:

Observação: O envio do modelo HTML através da rotina de Lançamentos Financeiros somente ocorrerá se a configuração GF - GE - 3205 - Normatizar nome do arquivo do boleto nos e-mails estiver marcada e possuir um modelo HTML padrão, caso esteja desmarcada o envio permanece como o exemplo explícito na imagem acima.

Exemplo de envio sem o uso de HTML e configs 3205 e 3206 ativas

Mesmo sem o uso de um modelo HTML será possível utilizar as evoluções proporcionadas pelas configurações GF - GE - 3205 - Normatizar nome do arquivo do boleto nos e-mails e GF - GE - 3206 - Personalizar assunto dos e-mails de boletos.

Novo modelo padrão

Para o novo modelo, o HTML base foi disponibilizado no caminho abaixo:

I:\CIGAM\DOC\Modelos_relatorios\GestãoFinanceira\CG00098_Boleto.html

Já a lista de tags/variáveis disponíveis, poderá ser consultada no Identificador de Sessão "HTML Email" em:

I:\CIGAM\DOC\Modelos_relatorios\Gestão Financeira\Variaveis\GB00089_olha_para_CG00098.tag

Descritivo das novas tags HTML (Merge)

Abaixo estão descritos os campos de onde são adquiridos os dados de cada TAG:

UN:
<!$MG_h_l_u_nome>	Nome	Campo ‘Nome’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_fantasia>	Fantasia	Campo ‘Fantasia’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_cnpj>	CNPJ	Campo ‘CNPJ’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_endereco>	Endereço	Campo ‘Endereço’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_municipio>	Município	Campo ‘Município’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_fone>	Fone	Campo ‘Fone’ do Cadastro da Unidade de Negócios.
<!$MG_h_l_u_email>	Email	Pega o remetente (e-mail) informado na Config 2709.
<!$MG_h_l_u_UF>	UF	Campo ‘UF’ do Cadastro da Unidade de Negócios.
CLIENTE:
<!$MG_h_l_e_nome>	Nome	Campo ‘Nome’ do Cadastro da empresa.
<!$MG_h_l_e_fantasia>	Fantasia	Campo ‘Fantasia’ do Cadastro da empresa.
GERAIS:
<!$MG_saldoTotal>	Valor Total	Corresponde ao somatório do valor de todos os boletos contidos no Email.
<!$MG_dataAtual>	Data Atual	Data em que o Email foi enviado.
<!$MG_usuarioLogado>	Nome do Usuário	Campo ‘Nome’ do cadastro do usuário logado.

Tratamento do Site e das imagens do e-mail

Para uma melhor apresentação do e-mail de boletos, além do modelo HTML, são apontadas os logotipos tanto da CIGAM quanto do Cliente. Atualmente a gestão destas imagens é feita diretamente dentro do modelo através do apontamento de um caminho web onde estas imagens estejam hospedadas. Indicamos que cada cliente, ao realizar a sua implementação, substitua no mínimo a imagem “Sua Empresa” informando em seu lugar, o seu logotipo oficial, porém, o Cliente é livre para realizar a edição de todo o modelo HTML padrão conforme a sua preferência, o mesmo vale para o site da sua empresa, que pode substituir a informação padrão da CIGAM SOFTWARE CORPORATIVO.

Dentro do modelo, o logo “sua empresa” é representado pelo link externo https://i.imgur.com/4U27MjH.png, você pode substituí-lo pelo link do seu logo em qualquer aplicação de repositório web onde hospede as suas imagens:

Por exemplo, temos este link no Google Drive com um logo da CIGAM:

https://drive.google.com/file/d/1OjTW-98kGV7Q_nqrTlUc2pgCYXi5cg_G/view?usp=share_link

1. Observação: O link deve ser público a qualquer pessoa que tenha acesso, caso contrário a imagem não será apresentada.

2. Observação: dependendo do local utilizado para hospedar a sua imagem, pode haver a necessidade de edição no link para que ele seja visível a qualquer um. No caso do Google Drive é preciso fazer o seguinte procedimento (usando o link acima):

Dentro do HTML ficará assim:

Já o link para a abertura do seu site quando clicado no seu logo, basta alterar o link https://www.seusite.com.br colocando o site da sua empresa, desta forma, ao clicar no seu logo, será feito o redirecionamento para o seu site.

Exemplo de e-mail HTML com as novas Tags

Por fim, o e-mail será enviado com estas características:

Manuais Referenciados

• GF - Como Fazer - Parametrização de Envio de Boletos por e-mail
• Envio de Boletos por E-mail: Configurações e rotinas que podem ser utilizadas
• GF - Como Fazer - Envio de Boleto por e-mail com Assunto editável na rotina Emissão de Boletos Personalizados
• Como enviar XML + DANFE + BOLETO no envio da NFe?
• GF - Como Fazer - Envio de Boletos com Modelo HTML
• GF - Como Fazer - Emissão de Múltiplos Modelos de Boletos