# Variáveis de E-mail - Emissão de Boletos

## Introdução
O envio de mensagens por e-mail através do relatório de [[emissao de boletos|Emissão de Boletos]] é uma ferramenta essencial no sistema que permite a personalização e gerenciamento eficiente da comunicação com os clientes.

>[!TIP] O que são variáveis?
>As variáveis são valores que podem ser substituídos quando existe a variação de uma informação. É possível incluir variáveis para que, no ato do envio da mensagem para mais de um cliente, a informação da variável seja preenchida individualmente para cada envio, com a respectiva informação para cada cliente.

O uso de variáveis nas mensagens de e-mail possibilita a criação de conteúdos personalizados para múltiplos clientes a partir de um único template. Desta forma, o sistema permite que informações específicas de cada cliente, boleto e empresa sejam automaticamente inseridas nos locais apropriados do e-mail, resultando em mensagens individualizadas e adaptadas às necessidades particulares de cada situação, sem a necessidade de criar um modelo separado para cada envio.

- Este documento descreve as variáveis disponíveis para uso nos templates de e-mail do sistema;
- As variáveis permitem a inserção automática de informações específicas do cliente, boleto, serviço e empresa nas mensagens de e-mail.

> [!NOTA] **Acesso às Variáveis**
> **Caminho:** Configurações > Integrações > E-mail SMTP > Mensagem > Variáveis

## Entrega de Valor
- Personalização eficiente de e-mails;
- Comunicação clara e detalhada sobre boletos;
- Redução de dúvidas e chamados relacionados a cobranças.

## Estrutura da Funcionalidade
A funcionalidade de variáveis de e-mail para uso no **Relatório de [[emissao de boletos|Emissão de Boletos]]** está estruturada nas configurações:
- Configuração e integração de um [[e-mail smtp|E-mail SMTP]] e definição do conteúdo da mensagem relacionada ao SMTP;
- Parametrização do servidor de e-mail nos [[parametros financeiro|Parâmetros Financeiro]] para envio através do relatório de [[emissao de boletos|Emissão de Boletos]];

## Variáveis de E-mail
A seguir, consta a listagem das variáveis de e-mail disponíveis para o envio através do **Relatório de Emissão de Boletos.**

>[!INFO] **Informação:**
>Os envios realizados pelo **Relatório de [[emissao de boletos|Emissão de Boletos]]** possuem ligação direta com o financeiro do cliente e alguns dados cadastrais, portanto, variáveis com este cunho podem ser utilizadas neste tipo de envio.

| **Variável**                 | **Conceito**                                                                                                                                                                                            | Caminho                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `#areceber_data_emissao#`    | Data de emissão do boleto.                                                                                                                                                                              | Contas a receber > Data da emissão                                 |
| `#areceber_data_vencimento#` | Data de vencimento do boleto.                                                                                                                                                                           | Contas a receber > Data do vencimento                              |
| `#areceber_numero#`          | Informação respectiva ao ID do boleto no IXC.                                                                                                                                                           | Contas a receber > ID                                              |
| `#areceber_valor#`           | Informação respectiva ao valor do boleto.                                                                                                                                                               | Contas a receber > Valor                                           |
| `#areceber_valor_atual#`     | Informação respectiva ao valor total em aberto, acrescido de juros e multa.                                                                                                                             | Contas a receber > Histórico boleto > Valor atual                  |
| `#cliente_cnpj_cpf#`         | Informação respectiva ao CPF/CNPJ do cliente, definido no campo CNPJ/CPF no cadastro do Cliente.                                                                                                        | Sistema > Cadastros > Clientes > CNPJ/CPF                          |
| `#cliente_razao#`            | Informação respectiva à razão social, definido no campo Razão social/nome no cadastro do Cliente.                                                                                                       | Sistema > Cadastros > Clientes > Razão social/nome                 |
| `#filial_cidade#`            | Informa a cidade registrada no campo Cidade, no cadastro da filial.                                                                                                                                     | Configurações > Empresa > Filiais > aba Filial > Endereço > Cidade |
| `#filial_email#`             | Informa o e-mail registrado no campo E-mail, no cadastro da filial.                                                                                                                                     | Configurações > Empresa > Filiais > aba Filial > E-mail            |
| `#filial_fantasia#`          | Informa o nome fantasia registrado no campo Nome Fantasia, no cadastro da filial.                                                                                                                       | Configurações > Empresa > Filiais > aba Filial > Nome fantasia     |
| `#filial_razao#`             | Informa a razão social da filial, registrada no campo Razão Social, no cadastro da filial.                                                                                                              | Configurações > Empresa > Filiais > aba Filial > Razão social      |
| `#filial_site#`              | Informa o site da filial, registrado no campo Site, no cadastro da filial.                                                                                                                              | Configurações > Empresa > Filiais > aba Filial > Site              |
| `#filial_telefone#`          | Informa o telefone da filial, registrado no campo Telefone, no cadastro da filial.                                                                                                                      | Configurações > Empresa > Filiais > aba Endereço > campo Telefone  |
| `#imprimir_produtos_fatura#` | É apresentada uma tabela com os principais dados relacionados ao produto do qual o boleto foi gerado, como ID, descrição do produto, quantidade, valores unitários e gerais, acréscimo e valor líquido. | Sistema > Cadastros > Contratos > Vendas > aba Produtos            |
| `#linha_digitavel#`          | Quando o boleto possui código de barras, preencherá a linha digitável. Respectiva ao campo de linha digitável nas informações do boleto.                                                                | Contas a receber > aba Informações > Linha digitável               |
| `#link_boleto_gerencianet#`  | Quando o boleto é gerado para a carteira de cobrança Gerencianet e estiver comunicado, irá gerar o link gateway para a Gerencianet. Esta variável é específica para este Gateway de Pagamento.          | Contas a receber > aba Informações > Link gateway                  |
| `#link_gateway#`             | Quando a carteira de cobrança é do tipo Gateway, e gera link gateway, preencherá esta informação. Depende do campo link gateway preenchido nas informações do boleto.                                   | Contas a receber > aba Informações > Link gateway                  |
| `#obs_boleto#`               | Imprime o valor de _Período de prestação_ do boleto que foi enviado.                                                                                                                                    | Contas a receber > Período de prestação                            |
| `#pix_copia_cola#`           | Código pix do boleto quando o boleto o possuir.                                                                                                                                                         | Contas a receber > Copiar código pix                               |
>[!INFO] Cobranças Pix:
>Para realizar o envio e cobranças Pix, utilize o filtro no relatório para selecionar a carteira de cobrança configurada para emitir e gerar os envios do tipo Pix. Certifique-se de que as cobranças foram emitidas corretamente antes de prosseguir.
><br>
>No cenário de envio de cobranças do tipo Pix, o sistema irá considerar a mensagem padrão de SMS para envio de boletos, localizado em Configurações > Parâmetros > Parâmetros financeiro > **SMS para envio de boletos.**

>[!TIP] **Manual:**
>Confira o manual de configuração de envio de mensagens através do relatório de emissão de boletos:
>- [[envio de boletos por e-mail pelo relatorio de emissao de boletos|Envio de Boletos por E-mail pelo Relatório de Emissão de Boletos]];
>- [[envio de pix por e-mail|Envio de Pix por E-mail]]

## Casos de Uso

### [[envio de boletos por e-mail pelo relatorio de emissao de boletos|Envio de Boletos por E-mail pelo Relatório de Emissão de Boletos]]

>[!CAUTION] Importante:
>Lembre-se de realizar a parametrização da conta de [[e-mail smtp|E-mail SMTP]] e sua respectiva mensagem adequadamente, para que as mensagens sejam enviadas corretamente através do **Relatório de Emissão de Boletos**. A correta configuração do envio de e-mail garantirá que as notificações financeiras sejam entregues de forma eficiente e conforme a necessidade do cliente.

1. Acesse o **Relatório de [[emissao de boletos|Emissão de Boletos]]** através do caminho: Relatórios > Relatórios financeiros > Relatórios de Saída > Emissão de boletos;
2. Na aba **Filtros**, aplique os filtros necessários;
	
	**Campos principais:**
	- **Carteira de cobrança:** clique na lupa e selecione a carteira de cobrança da qual os boletos que deseja enviar estão gerados;
	- **Data emissão inicial e final:** o sistema permite inserir a data de emissão dos boletos. Se necessário, filtre por **período** de emissão preenchendo a data inicial e a data final de emissão;
	- **Data vencimento inicial e final:** filtre pela data de vencimento inicial e final para o sistema considerar os boletos com data de emissão no período filtrado;
	- **Status dos títulos:** indique o status dos títulos que deseja enviar a mensagem. Caso sejam boletos em aberto, filtre pelo status **Abertos.**
	  
3. Com os filtros aplicados, clique em **Listar faturas > Padrão** para visualizar quais clientes serão indicados na listagem;
4. Na sequência, após conferir os clientes listados, clique em **Enviar por E-mail** para efetivar os disparos.
5. Após realizar a requisição de envio, o sistema apresentará um relatório apresentando os clientes que receberão estas mensagens. As mensagens serão armazenadas na [[fila de e-mails|Fila de E-mails]] e serão enviadas conforme definidos os limites de envio por hora e por dia.

>[!TIP] Dica:
>Para mais informações sobre o envio de boletos por E-mail, acesse os materiais disponíveis:  
>- [[envio de boletos por e-mail pelo relatorio de emissao de boletos|Envio de Boletos por E-mail pelo Relatório de Emissão de Boletos]];
>- [[envio de pix por e-mail|Envio de Pix por E-mail]].

## Fluxo de Trabalho
```mermaid
flowchart TD
    A[Início] --> B[Integração de uma conta de e-mail SMTP]
    B --> C[Cadastro da mensagem de e-mail]
    C --> D[Inserção das variáveis no corpo da mensagem]
    D --> E[Parametrização da mensagem padrão nos parâmetros financeiros]
    E --> F[Envio através do relatório de emissão de boletos]
    F --> G[Registro de log nos logs de e-mail]
    G --> H[Fim]
```

## Considerações Finais
O uso adequado das variáveis de e-mail para o **relatório de emissão de boletos** permite uma comunicação clara e eficiente com os clientes. Certifique-se de testar todos os modelos de e-mail antes de implementá-los em produção para garantir que as variáveis estejam sendo substituídas corretamente.

## Etiquetas
#Integracoes #IntegracaoEmail #MensagemDeEmail #EmissaoDeBoletos #Boletos #Pix 


## Leia Também
- [[integracoes|Integrações]]
- [[e-mail smtp|E-mail SMTP]]
- [[financeiro|Financeiro]]
- [[contas a receber|Contas a Receber]]
- [[emissao de boletos|Emissão de Boletos]]
- [[parametros financeiro|Parâmetros Financeiro]]