Pular para o conteúdo principal

Hub de Cobrança

O Hub de Cobrança é o módulo central para automatizar a geração de cobranças condominiais, definir regras de multa e juros, e gerenciar a integração com o provedor bancário (PJBank). Ele é dividido em três abas principais.

Plano MASTER

Este módulo avançado de integração financeira requer o Plano MASTER. Assinantes desta modalidade contam com acompanhamento exclusivo do nosso time de especialistas (Concierge) durante toda a fase de configuração.

Acessando o Módulo​

  1. Faça login no painel do síndico
  2. No menu lateral, clique em Cobrança
  3. O Hub de Cobrança é aberto na aba de Status da Automação

Hub Financeiro com abas Status da Automação, Regras de Cobrança e Integração Bancária

Aba 1: Status da Automação​

Esta aba apresenta o panorama completo do ciclo de cobrança automática:

Prévia do Próximo Ciclo​

Um painel mostra um resumo antecipado do que será cobrado na próxima execução automática:

  • Número de cobranças que serão geradas
  • Valor total estimado do ciclo
  • Data da próxima execução — quando o sistema disparará a cobrança automaticamente

Disparo Manual​

Se necessário, você pode gerar as cobranças do ciclo atual imediatamente, sem aguardar a data programada:

  1. Clique no botão Disparar Cobrança Manualmente
  2. O sistema gera todas as cobranças do ciclo de uma vez
aviso

O disparo manual executa o mesmo processo da automação programada. Use com cautela para evitar cobranças duplicadas — verifique se o ciclo atual já não foi processado.

Histórico de Execuções​

Uma tabela detalhada registra todas as execuções de cobrança (automáticas e manuais):

ColunaDescrição
Data/HoraQuando a execução ocorreu
TipoAutomática ou Manual
ResultadoSucesso ou Erro (com detalhes)
Cobranças GeradasQuantidade de cobranças processadas

Aba 2: Regras de Cobrança​

Nesta aba, você configura os parâmetros financeiros que são aplicados automaticamente na geração de cobranças:

Parâmetros Configuráveis​

ParâmetroDescriçãoExemplo
Juros ao Mês (%)Percentual de juros aplicado sobre cobranças em atraso1% a.m.
Multa (%)Percentual de multa aplicado após o vencimento2%
Prazo de Vencimento (dias)Número de dias após o fechamento do ciclo para vencimento do boleto10 dias

Opções de Automação​

OpçãoDescrição
Aplicar juros em atrasoAtiva/desativa a cobrança automática de juros sobre pagamentos em atraso
Aplicar multaAtiva/desativa a aplicação de multa por atraso
Gerar cobranças automaticamenteAtiva/desativa a geração mensal automática de cobranças
Configuração recomendada

Para a maioria dos condomínios, recomendamos ativar as três opções e configurar juros de 1% ao mês e multa de 2%, conforme previsto no Código Civil brasileiro (Art. 1.336 e Art. 395).

Configuração de Consumo​

Quando o condomínio possui medição individualizada (água e/ou gás), opções adicionais aparecem nesta seção:

ParâmetroDescrição
Tipo de ÁguaRateio por área, medidor individual ou taxa fixa
Tipo de GásRateio por área, medidor individual ou taxa fixa
Tarifa de Água (R$/m³)Valor cobrado por metro cúbico de água consumida
Tarifa de Gás (R$/m³)Valor cobrado por metro cúbico de gás consumido
Relação com Leituras

Quando configurado como "Medidor Individual", o sistema utiliza as leituras registradas no módulo de Leituras de Medidores para calcular o consumo de cada unidade e incluir na cobrança mensal.

Aba 3: Recebimentos e Boletos (Integração Bancária)​

Esta aba conecta o Condo+ à conta do condomínio onde o dinheiro será depositado. Ao contrário de sistemas engessados, o Condo+ oferece a liberdade de escolher o provedor de pagamentos que faz mais sentido para as finanças do seu condomínio.

Os provedores homologados que geram Boletos e PIX com retorno automático são:

  • Asaas: Ideal para síndicos que buscam tecnologia moderna e conta digital com split de pagamentos.
  • Boleto Cloud: Ideal para faturamentos junto aos maiores bancos comerciais tradicionais (Bradesco, Itaú, Santander, etc).
  • PJBank: Solução tradicional e amplamente utilizada para boletos de retaguarda.

Suporte Exclusivo de Integração (Concierge)​

💡 O que você precisa saber: A configuração bancária pode ser complexa. Por se tratar de uma funcionalidade do Plano MASTER, nós garantimos um acompanhamento exclusivo e guiado (Concierge). Nossa equipe de engenharia e suporte financeiro fará uma reunião de Setup com o síndico para validar as credenciais, configurar as opções no painel e inserir as URLs secretas de Webhooks na sua conta bancária. Entre em contato com o suporte técnico para agendar o seu Setup Financeiro.

Webhooks (Baixa Automática)​

O processo de conciliação das taxas condominiais é feito de forma totalmente automática através de Webhooks. Quando um morador paga um boleto ou o PIX no Asaas, PJBank ou Boleto Cloud, o provedor envia um aviso silencioso para nossos servidores e o Condo+ automaticamente altera o status da Fatura para PAGO, destravando recibos e prestação de contas no mesmo instante. Todo esse fluxo de Callback é ativado pela equipe de Concierge durante o Setup inicial.

Como Configurar​

  1. Acesse o portal do provedor escolhido (ex: Asaas ou Boleto Cloud) e crie a conta do condomínio.
  2. Gere a Chave de Acesso (API Key / Access Token) nas configurações de desenvolvedor do provedor.
  3. No Hub de Cobranças do Condo+, selecione seu Provedor de Pagamento no menu suspenso.
  4. Conforme sua escolha, o painel indicará qual formato de chave utilizar. Insira o JSON correspondente no campo Credenciais da API.
    • Asaas: Exige o access_token (Ex: {"access_token": "$aact_..."}).
    • Boleto Cloud: Exige a api_key (Ex: {"api_key": "..."}).
    • PJBank: Exige credencial e chave (Ex: {"credential_key": "...", "chave": "..."}).
  5. Ative a funcionalidade Ativar Emissão de Cobranças.
  6. Clique em Salvar. A nossa plataforma validará a integração.

Como Desativar​

  1. Desmarque o botão de "Ativar Emissão de Cobranças"
  2. Quando a emissão está desativada, o sistema continua registrando cobranças internamente no Condo+, mas os boletos não serão gerados nem enviados aos moradores.

Fluxo Completo de Cobrança​

Configurar Regras → Escolher Provedor e Adicionar Chaves → Automação Gera Cobranças
                                                                 ↓
                                           Boletos/PIX Emitidos no Banco Configurado
                                                                 ↓
                                                       Morador Recebe e Paga
                                                                 ↓
                                                  Baixa Automática no Condo+

Boas Práticas​

  • Configure as regras antes de ativar a automação — defina juros, multa e prazo de vencimento antes de ligar a geração automática
  • Ative a integração bancária antes de disparar cobranças — sem a integração, os boletos não são emitidos
  • Confira o histórico de execuções após cada ciclo — verifique se todas as cobranças foram geradas sem erros
  • Não dispare manualmente quando a automação já está ativa — isso pode causar cobranças duplicadas
  • Registre as leituras de consumo antes do fechamento — se o condomínio usa medição individual, as leituras precisam estar lançadas para serem incluídas na cobrança