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) |
| 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). |
Atenção!
A criptografia do campo de Credencial/Token da API está presente na versão Beta do sistema. Sua disponibilidade na versão Estável será a partir de Outubro de 2025.
Aviso!
O campo usado para a Credencial/Token da API será criptografado assim que inserido na carteira de cobrança. Além disso, seu conteúdo será exibido como campo de senha, tanto na carteira de cobrança quanto na auditoria. Essa medida foi implementada para aumentar a segurança e evitar acessos não autorizados às suas credenciais.
Se houver alterações na aplicação de API ou nesse campo na carteira de cobrança, a Credencial/Token deverá ser copiada novamente na aplicação da API correspondente e reinserida na carteira de cobrança para que a autenticação funcione corretamente.
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 mod.21
- 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 |
Atenção, Beta!
A aba Logs carteira de cobrança está presente na versão Beta do Sistema. Sua disponibilidade na versão Estável será a partir de Julho de 2025.
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. |
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
