# Variáveis de SMS - Emissão de Boletos

## Introdução
O envio de mensagens por SMS 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 SMS 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 SMS, 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 SMS 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 SMS.

> [!NOTA] **Acesso às Variáveis**
> **Caminho:** Sistema > CRM > Mensagens  > Mensagens SMS > Variáveis

## Entrega de Valor
- Personalização eficiente de SMS;
- 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 SMS 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 [[gateway sms|Gateway SMS]];
- [[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]];
- Parametrização do servidor de SMS nos [[parametros financeiro|Parâmetros Financeiro]] para envio através do relatório de [[emissao de boletos|Emissão de Boletos]];

## Variáveis de SMS
A seguir, consta a listagem das variáveis de SMS 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_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               |
| `#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_fantasia#`         | Informação respectiva ao Nome Fantasia do cliente, definido no campo Nome Fantasia no cadastro do Cliente.                                                           | Sistema > Cadastros > Clientes > Nome Fantasia                     |
| `#cliente_nome#`             | Informação respectiva ao primeiro nome do cliente, definido no campo Razão social/nome no cadastro do Cliente.                                                       | Sistema > Cadastros > Clientes > Razão social/Nome                 |
| `#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 (primeiro nome) |
| `#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                  |
>[!CAUTION] Atenção:
>O envio de boletos por SMS **não** permite o anexo do PDF da fatura. Por isso, apenas as informações financeiras e cadastrais relacionadas ao cliente e/ou à filial vinculada estarão disponíveis no corpo da mensagem. É importante considerar o limite de caracteres permitido, garantindo que todas as informações relevantes sejam transmitidas de forma clara e concisa.

>[!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 sms pelo relatorio de emissao de boletos|Envio de Boletos por SMS pelo Relatório de Emissão de Boletos]]
>- [[envio de pix por sms|Envio de Pix por SMS]]
>- [[variaveis de sms para envio manual de cobrancas pix|Variáveis de SMS para Envio Manual de Cobranças Pix]]

## Casos de Uso

### [[envio de boletos por sms pelo relatorio de emissao de boletos|Envio de Boletos por SMS pelo Relatório de Emissão de Boletos]]

>[!CAUTION] Importante:
>Lembre-se de realizar o **[[cadastro de mensagem de sms|Cadastro de Mensagem de SMS]]** e configurar sua parametrização 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 SMS 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 SMS** 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

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

## Fluxo de Trabalho
```mermaid
flowchart TD
    A[Início] --> B[Integração de um Gateway SMS]
    B --> C[Cadastro da mensagem de SMS]
    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 SMS]
    G --> H[Fim]
```

## Considerações Finais
O uso adequado das variáveis de SMS 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 SMS antes de implementá-los em produção para garantir que as variáveis estejam sendo substituídas corretamente.

## Etiquetas
#Integracoes #IntegracaoGatewaySMS #MensagemDeSMS #EmissaoDeBoletos #Boletos #Pix 

## Leia Também
- [[integracoes|Integrações]]
- [[gateway sms|Gateway SMS]]
- [[financeiro|Financeiro]]
- [[contas a receber|Contas a Receber]]
- [[emissao de boletos|Emissão de Boletos]]
- [[parametros financeiro|Parâmetros Financeiro]]