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

De CIGAM WIKI


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 é 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

Disponível em “https://www.cigam.com.br/wiki/index.php?title=GF_-_Como_Fazer_-_Envio_de_Boletos_por_e-mail_-_Parametrização_de_Assunto_e_Modelo_HTML&oldid=125757”