# Carteira de Cobrança

## Introdução
A **Carteira de Cobrança** é uma ferramenta essencial no Sistema para gerenciar e parametrizar as operações financeiras relacionadas à cobrança. Ela permite configurar dados bancários, emitir boletos e integrar com gateways de pagamento, proporcionando um controle eficiente das transações financeiras da empresa.

## Funcionalidades Principais
* Configurar integrações para geração de cobranças (Contas a Receber)
* Configuração de parâmetros específicos e personalizados de cobrança
* Configuração de modelos de impressão
* Configuração de modos de envio da cobrança ao cliente

> [!NOTE] **Acesso ao Formulário**
> **Caminho**: Menu Sistema > Cadastros > Financeiro > Carteira de cobrança

### Estrutura do Formulário
O menu "**Carteira de cobrança**" está organizado nas seguintes abas:

- Carteira de cobrança
- Juros, Multas e Desconto
- Instruções
- Configurações bancárias
- Configurações cartão de crédito
- Configurações gateway
- Configurações débito em conta
- Impressão
- Recebimento
- Configurações pix

### Aba Carteira de cobrança
Aqui serão definidas configurações como a nomenclatura da carteira, tipo de recebimento e filial a qual será utilizada.

#### Parâmetros

| **Campo**                                                  | **Descrição**                                                                                                                                       |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                                                         | ID ou numeração de registro da carteira                                                                                                             |
| Descrição                                                  | Descrição da carteira de cobrança                                                                                                                   |
| Conta                                                      | Conta bancária associada à carteira                                                                                                                 |
| Tipo de recebimento                                        | Define o tipo de recebimento (ex: boleto, cartão)                                                                                                   |
| Enviar e-mail para cliente ao gerar financeiro do contrato | Se marcado como "Sim", ao gerar financeiro do contrato as cobranças são enviadas ao cliente automaticamente                                         |
| Enviar mensagem push para cliente ao gerar financeiro      | Quando gerado financeiro, é enviada ao cliente uma notificação push para o aplicativo mobile da Central do Assinante                                |
| Imprimir ligações voip                                     | Se marcado como "Sim", no boleto irá conter detalhes das ligações VOIP                                                                              |
| Validar filial na venda                                    | Valida se a Filial da Conta é a mesma da saída, ao finalizar Venda ou gerar o financeiro do Contrato                                                |
| Ativo                                                      | Ativa ou Inativa o registro da carteira para o uso                                                                                                  |
| Filial                                                     | Define o ID da filial vinculada a carteira                                                                                                          |
| Configuração de alternativa de pagamento                   | Utilizado para vincular outras carteiras de cobrança como forma de pagamento alternativa                                                            |
| Planejamento analítico                                     | ID de planejamento no qual serão lançadas as tarifas de cobranças recebidas pela carteira                                                           |
| Data lançamento                                            | Define se o lançamento da tarifa de cobrança é lançado na data de pagamento ou na data de crédito                                                   |
| Enviar baixa do boleto ao banco ao ativar a recorrência    | Se a carteira é do tipo Boleto, ao ativar a recorrência de cartão, os boletos são enviados como pedido de baixa ao banco na próxima remessa gerada. |
|                                                            |                                                                                                                                                     |

### Aba Juros/Multas/Desconto
Aqui serão configurados parâmetros importantes sobre acréscimo e desconto personalizados para as cobranças geradas pela carteira.

#### Parâmetros

| **Campo**                     | **Descrição**                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| Juro % mês                    | Uso exclusivo para relatórios                                                                |
| Juros %                       | Percentual de juros ao dia aplicado na cobrança                                              |
| Juro R$                       | Valor em reais de juros a ser aplicado na cobrança                                           |
| Multa %                       | Valor fixo calculado em percentual de multa sob o valor da cobrança, se pago após vencimento |
| Multa R$                      | Valor fixo em reais de multa, se pago após vencimento                                        |
| Desconto até o vencimento R$  | Desconto fixo na cobrança para pagamentos adimplentes                                        |
| Desconto até o vencimento %   | Desconto fixo de um percentual sob o valor da cobrança, para pagamento adimplentes           |
| Desconto parcela proporcional | Habilitar os descontos até vencimento também para financeiros gerados de forma proporcional  |
| Protestar                     | Instrui ao banco para protestar automaticamente a cobrança após vencimento                   |
| Aceitar atraso (dias)         | Quantos dias após vencimento o banco deve aguardar até protestar a cobrança                  |
| Calcular juros                | Até quando os juros serão contabilizados após vencimento de cobrança                         |
> [!tip] Dica!
> Para mais informações, acesse a página [[juros, multas e desconto|Juros, Multas e Desconto]]. 

### Aba Instruções
Aba destinada à configuração das instruções que serão impressas no campo de observações do boleto impresso.

#### Parâmetros
| **Campo**                                            | **Descrição**                                                                                      |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Instrução 1 (até 8 dependendo da integração)         | Campo do tipo texto, destinado a descrever informações que serão impressas na impressão do boleto  |
| Imprimir instruções quando o título estiver vencido  | Define quais linhas de instrução serão impressas quando a cobrança estiver vencida                 |
| Imprimir instruções quando o título for proporcional | Define quais linhas de instrução serão impressas quando a cobrança é gerada com valor proporcional |
| Imprimir obs contas a receber                        | Inclui na observação do boleto, o campo de observação do contas a receber                          |
| Observação anterior                                  | Texto impresso antes de {obs contas a receber}                                                     |
| Observação posterior                                 | Texto impresso depois de {obs contas a receber}                                                    |

### Aba Configurações bancárias
Aba destinada à configuração das informações do seu banco e instruções de ação que o banco deve acatar no registro das cobranças.

> [!EXAMPLE] Integrações Disponíveis
> * Banco Banese
> * Banco Banpará
> * Banco Banrisul
> * Banco BMP Money Plus
> * Banco Bradesco
> * Banco Citibank
> * Banco Credisan
> * Banco da Amazonia
> * Banco Daycoval
> * Banco de Brasília
> * Banco do Brasil
> * Banco do Espirito Santo
> * Banco do Nordeste
> * Banco HSBC
> * Banco Itaú
> * Banco Olé Consignado
> * Banco QI Tech
> * Banco Safra
> * Banco Santander
> * Banco Unicred
> * Banco Unicred - 091
> * Banco Unicred 136
> * Banco Uniprime
> * Banco Uniprime 084
> * Bancoob/Sicoob
> * Caixa Econômica Federal CIBCB16
> * Caixa Econômica Federal SICOB11
> * Caixa Econômica Federal SICGB
> * Carnê
> * Cecred
> * CrediSIS
> * Cresol
> * Sicredi

#### Parâmetros Principais
| **Campo**                                      | **Descrição**                                                                                             |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Espécie documento                              | Espécie da cobrança gerada (ex: DM, DS)                                                                   |
| Contador de nosso número                       | Registro que armazena o sequencial de número dos boletos a serem gerados pela carteira                    |
| Classe das funções                             | Define a pré-configuração da carteira de acordo com a instituição bancária                                |
| Número do convênio                             | Dado bancário                                                                                             |
| Títulos cancelados                             | Inclui na próxima remessa gerada os títulos cancelados                                                    |
| Títulos renegociados                           | Inclui na próxima remessa gerada os títulos renegociados                                                  |
| Títulos com recebimento manual                 | Inclui na próxima remessa gerada os títulos recebidos manualmente                                         |
| Títulos com recebimentos via cartão de crédito | Inclui na próxima remessa gerada os títulos cancelados                                                    |
| Layout remessa                                 | Sistema de troca de arquivos com o banco (CNAB 240 ou 400)                                                |
| Layout retorno                                 | Seleciona o Layout usado por seu banco                                                                    |
| Baixar automaticamente                         | Define um comando para que o banco baixe o título automaticamente após vencimento em um determinado tempo |
| Prazo após vencimento (dias)                   | Define o tempo para o banco realizar a baixa após vencimento                                              |
| Utilizar baixa após vencimento                 | Define um comando para que o sistema encaminhe os títulos como pedido de baixa conforme prazo determinado |
| Enviar pedido de baixa após vencimento (dias)  | Define o tempo para o título entrar em remessa de baixa após vencimento                                   |

### Aba Configurações cartão de crédito
Aba destinada à configuração das credenciais de API da integração operadora de crédito que utilizará na carteira.

> [!EXAMPLE] Integrações Disponíveis
> * Asaas
> * Bin
> * Cielo 3.0
> * Efí (Gerencianet)
> * GalaxPay (Cel_cash)
> * Iugu
> * Vindi
> * Yapay

#### Parâmetros Principais
| **Campo**             | **Descrição**                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------- |
| Gateway               | Define a integração que será utilizada pela carteira                                     |
| Ambiente              | Define o ambiente da integração (Homologação ou Produção)                                |
| Credenciamento        | Credenciais que o sistema utilizará para comunicar com a API                             |
| Parâmetros            | Configurações específicas da integração                                                  |
| Parcelamento          | Configuração de parcelamento das cobranças                                               |
| Bandeiras contratadas | Configurar as bandeiras de instituições de crédito em que serão permitidos os pagamentos |

## Redirecionar Taxas (Nova Função)

> [!TIP] Melhoria!
> Nas configurações de Carteiras de Cobrança para **Cartão de Crédito**, foi adicionada a opção de repassar as taxas transacionais ao cliente (seção "Redirecionar taxas"). Essa prática, prevista por lei, pode agora ser aplicada a pagamentos manuais e recorrentes.

Caso marque o parâmetro **Repassar taxa para o cliente** como "Sim", novos campos serão mostrados para a parametrização das taxas:
- **Será aplicada em pagamentos:** Individuais, Recorrentes ou Ambos
- **Porcentagem da taxa (%):** Informe o percentual que será calculado sobre o valor da venda e adicionado como acréscimo ao cliente no pagamento com Cartão de Crédito
- **Valor fixo da taxa (R$):** Informe o valor fixo em **Reais** que será acrescentado ao cliente no pagamento com Cartão de Crédito

> [!WARNING] Aviso!
> Ao selecionar a opção **Individuais**, a taxa será aplicada somente a pagamentos realizados pela Central do Assinante, onde será paga apenas uma parcela. <br>
> Na opção **Recorrentes**, a taxa será aplicada nas cobranças que possuem recorrência ativa. <br> 
> E selecionando **Ambos** a taxa será aplicada para as duas modalidades.

### Aba Configurações gateway
Aba destinada à configuração das credenciais de API da integração bancária que será utilizada na carteira.

> [!EXAMPLE] Integrações Disponíveis
> * Banco do Brasil
> * CrediSIS
> * Efí (Gerencianet)
> * GalaxPay (Cel_cash)
> * Iugu
> * Juno (inativado)
> * Santander
> * Sicoob Api
> * Sicredi Api
> * Widepay
> * Asaas
> * Lytex
#### Parâmetros Principais
| **Campo**             | **Descrição**                                                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Gateway               | Define o gateway bancário que será utilizado e o conjunto de parâmetros de instrução que serão adicionados e considerados para sua configuração |
| Importado gateway     | Define se a carteira é destinada para importação de cobrança de outros sistemas, ou não                                                         |
| Envia e-mail gateways | Define se o próprio gateway de pagamento fará o envio da cobrança ao e-mail do cliente                                                          |
| Espécie documento     | Espécie da cobrança gerada (ex: DM, DS)                                                                                                         |
| Tarifas gateway       | Define os parâmetros de tarifa das cobranças que serão recebidas por esta carteira no sistema                                                   |

### Aba Configurações débito em conta
Aba destinada a configuração das credenciais de API da integração bancária que será utilizada na carteira.

> [!EXAMPLE] Layouts Disponíveis
> * Débito automático Itau 240 V. 04
> * Débito automático SIACC
> * Débito automático V. 04
> * Débito automático v. 05

#### Parâmetros Principais
| **Campo**                           | **Descrição**                                                                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Convênio                            | Dado fornecido pelo banco                                                                                                       |
| Débito carteira vinculada           | Destinado ao vínculo de uma carteira alternativa de pagamento, caso o cliente não tenha seu débito efetuado por qualquer motivo |
| Classe de funções                   | Layout de troca de arquivos que o Banco utiliza (CNAB)                                                                          |
| Validar vencidos ao baixar remessas | Valida se há títulos já vencidos e não deixa baixar o arquivo de remessa                                                        |
| Tarifas gateway                     | Define os parâmetros de tarifa das cobranças que serão recebidas por esta carteira no sistema                                   |

### Aba Impressão
Aba destinada a configuração do layout de impressão de boleto.

> [!EXAMPLE] Layouts Disponíveis
> * 1 por página
> * 2 por página
> * 3 por página
> * 3 por página com margem menor
> * 3 por página personalizável + modobank
> * 4 por página
> * Boleto + fatura detalhada
> * Boleto + fatura detalhada + modobank
> * Boleto + fatura detalhada com consumo
> * Boleto + fatura detalhada com consumo + modobank
> * Boleto + NF
> * Boleto + NF + modobank
> * Boleto + NF + vários produtos
> * Carnê (utilizar somente para carteira interna)
> * Carnê detalhado (utilizar somente para carteira interna)
> * Detalhamento com boleto
> * Extrato fechado
> * Fatura detalhada + boleto + NF mod.21
> * Fatura personalizada + boleto + modobank

#### Parâmetros Principais
| **Campo**                                     | **Descrição**                                                                                                    |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Layout de impressão                           | Seletor para escolher o layout de impressão a ser utilizado no boleto                                            |
| Imprimir endereço do beneficiário no boleto   | Escolhe se o endereço do beneficiário deve ser impresso no boleto                                                |
| Imprimir telefone cliente na fatura detalhada | Define se o telefone do cliente deve aparecer na fatura detalhada                                                |
| Imprimir sacador/avalista no boleto           | Opta por imprimir ou não o nome do sacador/avalista no boleto                                                    |
| Filial impressa na nota fiscal                | Determina se a filial impressa na nota deve buscar da venda ou da conta da carteira de cobrança                  |
| Filial impressa no boleto                     | Determina se a filial impressa no boleto deve buscar da venda ou da conta da carteira de cobrança                |
| Imprimir produtos de valor zerado             | Escolhe se produtos com valor zero devem ser listados no boleto                                                  |
| Mascarar CPF no boleto                        | Define se o CPF do cliente deve ser mascarado no boleto                                                          |
| Mostra CEP do beneficiário no boleto          | Determina se o CEP do beneficiário deve aparecer no boleto                                                       |
| Nome do beneficiário (cedente) no boleto      | Define como o nome do beneficiário deve ser exibido no boleto, podendo optar entre razão social ou nome fantasia |
| Nome do beneficiário (cedente) no recibo      | Define como o nome do beneficiário deve ser exibido no recibo, podendo optar entre razão social ou nome fantasia |
| Imprimir capa                                 | Seleciona se a capa do boleto deve ser impressa ou não                                                           |
| Imprimir referência do cliente na capa        | Define se a referência do cliente deve ser impressa na capa                                                      |
| Imprimir telefone do cliente na capa          | Opta por imprimir ou não o telefone do cliente na capa                                                           |
| Posição da capa                               | Define a posição da capa no documento, podendo ser no início ou no fim                                           |
| Imagem de fundo da capa                       | Permite selecionar uma imagem de fundo para a capa do boleto                                                     |
| Posição X do quadro endereço (mm)             | Permite definir, em milímetros, a posição X do quadro de endereço na capa do boleto                              |
| Posição Y do quadro endereço (mm)             | Permite definir, em milímetros, a posição Y do quadro de endereço na capa do boleto                              |
| Tamanho X do quadro endereço                  | Permite definir, em milímetros, o tamanho X do quadro de endereço na capa do boleto                              |
| Tamanho Y do quadro endereço                  | Permite definir, em milímetros, o tamanho Y do quadro de endereço na capa do boleto                              |

### Aba Recebimento
Aba destinada ao tratamento de recebimento de cobranças com o valor diferente do esperado.

#### Parâmetros Principais
| **Campo**                               | **Descrição**                                                                  |
| --------------------------------------- | ------------------------------------------------------------------------------ |
| Divergência de valor (valor inferior)   | Define como tratar divergências de valor inferior em relação ao valor esperado |
| Desconto                                | Aplica um desconto para cobrir a diferença                                     |
| Incluir na próxima fatura (contratos)   | Adiciona a diferença à próxima fatura                                          |
| Baixa parcial                           | Permite baixar parcialmente o valor, sem descontar ou somar na próxima fatura. |
| Produto para cobrança na próxima fatura | Permite selecionar um produto específico para cobrança na próxima fatura       |
| Modelo de recibo personalizado          | Permite selecionar um modelo de recibo personalizado                           |

### Aba Configurações pix
Aba destinada a configuração das credenciais de API Pix da integração bancária que será utilizada na carteira.

> [!EXAMPLE] Integrações Disponíveis
> * Efí
> * modobank

#### Parâmetros Principais
| Campo                 | Descrição                                                                                                      |
| --------------------- | -------------------------------------------------------------------------------------------------------------- |
| Pix gateway           | Seleciona a plataforma de gateway para processamento de pagamentos via Pix                                     |
| Pix chave             | Campo para inserir a chave Pix, que pode ser um e-mail, CPF/CNPJ, telefone ou chave aleatória                  |
| Pix Client ID         | Credencial Pix para autenticação da aplicação.                                                                 |
| Pix Client Secret     | Campo para inserir o segredo do cliente fornecido pelo provedor do serviço Pix para autenticação da aplicação. |
| Pix tempo de validade | Define o tempo de validade para a transação Pix em minutos.                                                    |
| Pix URL callback      | Campo para inserir a URL que receberá notificações de status das transações Pix.                               |
| Lançar tarifa pix     | Escolha se a tarifa do Pix deve ser lançada (Sim/Não).                                                         |
| Valor tarifa pix      | Campo para inserir o valor da tarifa Pix que será cobrada por transação.                                       |

> [!TIP] Melhoria!
> Agora, a Carteira de Pix Avulso da Efí conta com a opção de **bloquear a Chave Pix** para transferências manuais. <br>
> Essa melhoria evita que os clientes realizem transferências avulsas entre contas utilizando a Chave Pix como código de pagamento. Dessa forma, os pagamentos só poderão ser efetuados via código Pix exclusivo da fatura (TxID). <br>
> Para realizar este bloqueio, acesse a configuração de sua Carteira de Pix Avulso da Efí, vá até a aba de **Configurações Pix** e clique no botão **Desabilitar pagamento com chave Pix**.

## Considerações Finais
A Carteira de Cobrança é uma ferramenta versátil e essencial para o gerenciamento financeiro eficiente. Sua correta configuração e utilização podem otimizar processos, reduzir inadimplência e melhorar a experiência do cliente.

## Etiquetas
#CarteiraDeCobranca #IntegracaoBancaria #Bancos #ContasAReceber #Gateway #API #Pix #DebitoAutomatico #CartaoDeCredito 

## Leia Também
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - remessa e retorno manual|Integrações Bancárias - Remessa e Retorno Manual]]
- [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[integracoes bancarias - pix avulso|Integrações Bancárias - Pix Avulso]]
- [[integracoes bancarias - cartao de credito|Integrações Bancárias - Cartão de Crédito]]
- [[integracoes bancarias - debito automatico|Integrações Bancárias - Débito Automático]]
- [[integracoes bancarias - arrecadacao|Integrações Bancárias - Arrecadação]]
- [[carteira interna - conta caixa|Carteira Interna - Conta Caixa]]
- [[troca de carteira de cobranca em massa|Troca de Carteira de Cobrança em Massa]]
- [[comunicacao com gateway|Comunicação com Gateway]]
- [[contas a receber|Contas a Receber]]
- [[financeiro|Financeiro]]
- [[logs gateway|Logs Gateway]]