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
Autenticação de Dois Fatores:
As ações Novo, Duplicar, Salvar e Deletar no formulário de Carteira de Cobrança exigem uma camada extra de segurança. Para realizar essas operações, o usuário precisa estar com a autenticação em dois fatores (2FA) ativada ou estar conectado via SSO. Saiba mais em:
Acesso ao Formulário
Caminho: Menu Sistema > Cadastros > Financeiro > Carteira de cobrança
Informação!
Quer saber como homologar uma 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 |
Dica!
Para mais informações, acesse a página 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.
Parâmetros Principais
| Campo | Descrição |
|---|---|
| Espécie documento | Espécie da cobrança gerada (ex: DM, DS) |
| Quem emite | Define quem será o responsável pela emissão da cobrança. Este campo deve ser sempre marcado como Empresa. Caso contrário, a remessa gerada pelo sistema poderá conter dados incompletos, impedindo o registro correto no banco (por exemplo, o número do nosso número – NN – do boleto). |
| 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.
Integrações Disponíveis
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)
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
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.
Na opção Recorrentes, a taxa será aplicada nas cobranças que possuem recorrência ativa.
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.
Integrações Disponíveis
Parâmetros Principais
| Campo | Descrição |
|---|---|
| Gateway | Seleciona o gateway de pagamento. |
| Importado gateway | Indica se o gateway foi importado. |
| Ambiente gateway | Define se o ambiente é de homologação ou produção. |
| Tipo impressão | Define o tipo de impressão (Carnê, Boleto, etc.). |
| Adiciona observação na descrição do item | Indica se adiciona observações na descrição do item. |
| Adiciona vencimento na descrição do item | Indica se adiciona a data de vencimento na descrição. |
| Envia e-mail gateways | Indica se os e-mails do gateway são enviados. |
| Gera Pix | Indica se é gerado um código Pix. |
| Enviar cobrança Pix pelo WhatsApp | Visível apenas se Gera Pix= Sim.Habilita o envio do Template de cobrança Pix via WhatsApp, por meio da integração com o Opa! Suite. |
| Tipo da chave Pix | Visível apenas se Enviar cobrança Pix pelo WhatsApp= Sim.Especifica o tipo da chave Pix que será inserida no campo Chave Pix (CPF/CNPJ, Celular, E-mail ou Aleatória). |
| Chave Pix | Visível apenas se Enviar cobrança Pix pelo WhatsApp= Sim. Insira a chave Pix associada à conta da instituição bancária de uso da carteira de cobrança. |
| Espécie documento | Define a espécie do documento gerado. |
| Lança tarifa gateway | Define como a tarifa do gateway é lançada (não lança, na impressão ou no recebimento). |
Aba Configurações débito em conta
Aba destinada à configuração das credenciais de API da integração bancária que será utilizada na carteira.
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 à configuração do layout de impressão de boleto.
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
- Fatura personalizada + boleto + modobank
Para mais detalhes, verifique em Layouts de Impressão.
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 (campo Razão social do cadastro da Filial) |
| 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 Logs carteira de cobrança
Aba destinada ao armazenamento dos logs de criação e alteração dos Gateways e APIs. Esta funcionalidade é compatível com os seguintes gateways de pagamento: Asaas, BBapi, Lytex, Santander, Sicoob e Sicredi.
É importante ressaltar que, mesmo que a autenticação falhe, a carteira de cobrança será salva, e o log detalhado será registrado para posterior investigação.
Grid - Logs carteira de cobrança
| Campo | Descrição |
|---|---|
| ID | Identificação do log |
| Status | Mostra se a operação teve Falha ou Sucesso |
| Log | Mensagem de retorno da operação |
| Ambiente | Indica o ambiente de operação |
| Response HTTP status | Código de status HTTP na resposta |
| Data criação | Data e hora da criação do log |
Visualização - Logs carteira de cobrança
| Campo | Descrição |
|---|---|
| ID | Identificação do log |
| ID carteira de cobrança | Identificação da carteira de cobrança |
| Status | Mostra se a operação teve Falha ou Sucesso |
| Ambiente | Indica o ambiente de operação:Produção, Homologação ou Teste |
| Log | Mensagem de retorno da operação |
| Método HTTP | Método utilizado na requisição HTTP |
| URL | Endpoint da requisição |
| Cabeçalho da requisição | Informações no cabeçalho da requisição HTTP |
| Corpo da requisição | Conteúdo enviado na requisição HTTP |
| Corpo da resposta | Conteúdo da resposta recebida |
| Status HTTP | Código de status HTTP na resposta |
| Data Criação | Data e hora da criação do log |
Dica!
Para mais informações sobre a aba Logs carteira de cobrança, consulte em:
Aba Configurações pix
Aba destinada a configuração das credenciais de API Pix da integração bancária que será utilizada na carteira.
Integrações Disponíveis
Parâmetros Principais
| Campo | Descrição |
|---|---|
| Pix gateway | Seleciona a plataforma de gateway para processamento de pagamentos via Pix |
| Chave Pix | Campo para inserir a chave Pix, que pode ser um e-mail, CPF/CNPJ, telefone ou chave aleatória |
| Enviar cobrança Pix pelo WhatsApp | Habilita o envio do Template de cobrança Pix via WhatsApp, por meio da integração com o Opa! Suite. |
| Tipo da chave Pix | Especifica o tipo da chave Pix que será inserida no campo Chave Pix (CPF/CNPJ, Celular, E-mail ou 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. |
| Enviar cobrança Pix pelo WhatsApp | Visível apenas se Gera Pix= Sim.Habilita o envio do Template de cobrança Pix via WhatsApp, por meio da integração com o Opa! Suite. |
| Tipo da chave Pix | Visível apenas se Enviar cobrança Pix pelo WhatsApp= Sim.Especifica o tipo da chave Pix que será inserida no campo Chave Pix (CPF/CNPJ, Celular, E-mail ou Aleatória). |
| 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. |
Novidade!
Adicionado parâmetro Permitir pagamento via Chave PIX na aba Configurações pix da carteira de cobrança, onde possui valor padrão Sim e é exibido apenas para a integração Efí 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
- Integrações Bancárias - Carteira de Cobrança
- Integrações Bancárias - Remessa e Retorno Manual
- Integrações Bancárias - Gateway
- Integrações Bancárias - API
- Integrações Bancárias - Pix Avulso
- Integrações Bancárias - Cartão de Crédito
- Integrações Bancárias - Débito Automático
- Integrações Bancárias - Arrecadação
- Carteira Interna - Conta Caixa
- Troca de Carteira de Cobrança em Massa
- Comunicação com Gateway
- Contas a Receber
- Financeiro
- Logs Gateway