# Variáveis da Carteira de Cobrança

## Introdução
As Variáveis da Carteira de Cobrança são elementos essenciais para personalizar as instruções de boletos de cobrança. Elas permitem que as empresas adaptem suas instruções conforme as necessidades específicas de cada cliente ou situação, garantindo uma gestão financeira mais eficiente e precisa.

> [!NOTA] Acesso ao Formulário
> Caminho: Menu Sistema > Cadastros > Financeiro > Carteira de Cobrança > aba Instruções

## Benefícios
- Personalização das instruções de cobrança.
- Integração de dados específicos do cliente ou sobre a cobrança em seus boletos.
- Melhoria na comunicação com instituições financeiras.
- Aumento da eficiência na recuperação de créditos.

## Passo a Passo - Variáveis da Carteira de Cobrança
1. Acesse o menu **Sistema**.
2. Clique em **Cadastros**.
3. Selecione a pasta **Financeiro**.
4. Clique no submenu **Carteira de cobrança**.
5. Selecione um cadastro existente ou clique em **Novo** para criar uma nova carteira.
6. Clique em **Editar**.
7. Navegue até a aba **Instruções**.
8. Preencha os campos de instruções conforme necessário, inserindo as variáveis que julgar necessárias entre o texto da linha de instrução.
9. Nos parâmetros **Imprimir instruções quando** for título vencido ou proporcional, insira o número das respectivas linhas que serão impressas para cada situação.
10. Clique em **Salvar** para aplicar as alterações.
11. Fim.

### Fluxo de Processo
```mermaid
graph TD
    A[Início] --> B[Acesse o menu Sistema]
    B --> C[Clique em Cadastros]
    C --> D[Selecione a pasta Financeiro]
    D --> E[Clique no submenu Carteira de cobrança]
    E --> F{Criar nova carteira ou editar existente?}
    F -->|Nova| G[Clique em Novo]
    F -->|Existente| H[Selecione um cadastro existente]
    G --> I[Clique em Editar]
    H --> I
    I --> J[Navegue até a aba Instruções]
    J --> K[Preencha os campos de instruções]
    K --> L[Insira variáveis nas linhas de instrução]
    L --> M[Configure parâmetros de impressão]
    M --> N[Clique em Salvar]
    N --> O[Fim]

```

## Variáveis Instruções Carteira de Cobrança
| **Variável**                | **Conceito**                                                                                                                                          |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `#cliente_id#`              | ID do cliente.                                                                                                                                        |
| `#cliente_nome#`            | Nome do cliente.                                                                                                                                      |
| `#plano#`                   | Descrição do plano de venda principal atrelado ao contrato da fatura.                                                                                 |
| `#id_contrato#`             | ID do contrato da fatura.                                                                                                                             |
| `#filial_telefone#`         | Número de telefone da filial do título.                                                                                                               |
| `#filial_site#`             | Site da filial do título.                                                                                                                             |
| `#juro#`                    | Calcula os juros.                                                                                                                                     |
| `#multa#`                   | Calcula a multa.                                                                                                                                      |
| `#login_hotsite#`           | Login do hotsite.                                                                                                                                     |
| `#senha_hotsite#`           | Senha na central do assinante do cliente em: aba contato ➜ senha (não é recomendado, pode ser falha de segurança).                                    |
| `#vencimento_original#`     | Data de vencimento original do título.                                                                                                                |
| `#vencimento_atual#`        | Data de vencimento atual do título.                                                                                                                   |
| `#desconto_ate_vencimento#` | Desconto que é configurado no plano de venda.                                                                                                         |
| `#desconto#`                | Calcula o desconto que foi configurado dentro da carteira de cobrança.                                                                                |
| `#data_final_fidelidade#`   | Fornece a identificação da data final para os contratos com fidelidade. A informação será buscada do campo **Data expiração** do contrato do cliente. |

## Casos de Uso

### Variável de Juros e Multa - Carteiras CNAB
> [!EXAMPLE] Instruções
> - **Instrução 1:**
>```
> Após o vencimento cobrar juros de R$ #juro# ao dia.
>```
><br>
>
> - **Instrução 2:**
>```
> Após o vencimento cobrar multa de R$ #multa#.
>```

### Variável de Juros e Multa - Carteiras API e Gateway
Carteiras de Gateway e API tem limitações sobre a quantidade de caracteres e linhas de instruções, aqui está um exemplo encurtado das instruções de Juros e Multa.

> [!EXAMPLE] Instruções
> - **Instrução 1:**
>```
> Após vencimento juros R$ #juro# ao dia.
>```
><br>
>
> - **Instrução 2:**
>```
> Após vencimento multa R$ #multa#.
>```

### Variável de Desconto no Plano de Venda
> [!EXAMPLE] Instruções
> - **Instrução 1:**
>```
> Conceder o #desconto_ate_vencimento# se pago até o vencimento.
>```
><br>
> ou...
><br>
>
> - **Instrução 2:**
>```
> Descontar #desconto_ate_vencimento# até venc.
>```

### Variável de Desconto na Carteira de Cobrança
> [!EXAMPLE] Instruções
> - **Instrução 1:**
>```
> Conceder o desconto de #desconto# se pago até o vencimento.
>```
><br>
> ou...
> <br>
> 
> - **Instrução 2:**
>```
> Descontar #desconto# se pago até venc.
>```

## Considerações Finais
A configuração adequada das Variáveis da Carteira de Cobrança é crucial para otimizar os processos de cobrança. Seguindo o passo a passo detalhado, os usuários podem personalizar seus títulos e faturas de boletos de acordo com as necessidades específicas da empresa. É importante revisar periodicamente essas configurações para garantir que elas continuem atendendo às demandas em constante evolução do negócio e do mercado financeiro. Isso assegura que as instruções nos boletos sejam claras, facilitando a comunicação com os clientes e melhorando a eficiência na recuperação de créditos.

## Etiquetas
#Cadastros #Financeiro #CarteiraCobranca #Variaveis #Instrucoes #VariaveisCarteiraDeCobranca

## Leia Também
- [[carteira de cobranca|Carteira de Cobrança]]
- [[parametrizacoes da carteira de cobranca|Parametrizações da Carteira de Cobrança]]
- [[contas a receber|Contas a Receber]]
- [[integracoes bancarias - remessa e retorno manual|Integrações Bancárias - Remessa e Retorno Manual]]