Faturamento em massa: boleto e Pix
Configure o banco, gere as cobranças do mês inteiro e acompanhe boleto/Pix por unidade.
O que é
Todo mês, o condomínio precisa cobrar a cota de cada unidade. O Aptofy gera essa cobrança em massa (boleto e/ou Pix) direto integrado com o banco — sem precisar exportar/importar arquivos manualmente.
Passo a passo (configurar o banco, uma vez só)
- Em Financeiro › Contas & Integrações, cadastre a conta bancária do condomínio.
- Escolha o banco (Inter, Cora, Itaú, Asaas, BB, Bradesco, Santander ou Mock para testes) e informe as credenciais de integração.
- Salve — a partir daqui, toda cobrança gerada já sai integrada com esse banco.
Os campos de segredo (client secret, API key, certificado e webhook secret) nunca voltam preenchidos quando você reabre a integração — o Aptofy não devolve segredo salvo para a tela, só mostra "✓ já configurado". Deixe-os em branco para manter o que já está gravado; preencha só quando quiser substituir. Não é possível salvar um segredo em branco: o webhook secret é o que prova que a confirmação de pagamento veio mesmo do banco, e sem ele o Aptofy passa a recusar todas as confirmações daquela conta.
Passo a passo (gerar a cobrança do mês)
- Em Financeiro › Cobrança, clique em Nova Cobrança.
- Veja a prévia: valor por unidade, vencimento, e quantas unidades serão cobradas.
- Confirme — a geração roda em segundo plano (pode levar alguns minutos em condomínios grandes) e você acompanha o progresso na tela.
- Prontos os boletos/Pix, cada morador já vê a cobrança dele no app.
Sem uma conta bancária integrada configurada, o sistema ainda gera a cobrança, mas sem boleto/Pix real — configure a integração antes do primeiro faturamento de verdade.
Perguntas frequentes
E se eu gerar a cobrança duas vezes no mesmo mês?▾
Não duplica — o sistema é idempotente por competência (mês/ano); rodar de novo não cria uma segunda cobrança para quem já tem uma.
Reabri a integração e os campos de senha estão vazios. Perdi as credenciais?▾
Não. Segredo salvo nunca é devolvido para a tela — ao lado do campo aparece "✓ já configurado" quando existe um valor gravado. Salvar com o campo vazio mantém o valor anterior; para trocar, digite o novo por cima.
Como eu vejo se um morador já pagou?▾
Na aba Faturas, o status muda pra "Paga" automaticamente assim que o banco confirma o pagamento (webhook) — normalmente minutos depois do pagamento real.
O que a Linha do tempo do boleto mostra?▾
Só o que realmente aconteceu e tem data registrada: quando a fatura foi gerada, quando lembretes de cobrança foram enviados (com a data do último e quantos foram), quando o pagamento foi compensado e, se for o caso, quando a fatura foi cancelada. Evento sem data registrada não aparece — a linha do tempo não estima nem presume nada. Para ver por qual canal a cobrança saiu (e-mail, WhatsApp, app), use o bloco Entrega por Canal, logo abaixo.
Os botões de baixar PDF e copiar a linha digitável estão apagados. Por quê?▾
Porque essa fatura ainda não tem boleto emitido — sem integração bancária configurada, ou porque a emissão ainda não rodou. Passe o mouse sobre o botão e ele explica. Assim que o boleto existir, os dois ficam ativos.
A tela de faturas mostrou um aviso vermelho em vez da lista. E agora?▾
Isso significa que a lista não pôde ser carregada — não que o condomínio esteja sem faturas. É uma distinção que importa: antes, uma falha de conexão aparecia como "Nenhuma fatura encontrada", o que induzia ao erro. Clique em Tentar novamente; se persistir, é problema de conexão ou do servidor.
Posso cancelar ou tentar de novo uma cobrança que travou?▾
Sim. Enquanto o status ainda é "Na fila" (ainda não começou), tem um botão Cancelar na tabela de faturamentos. Se der erro (status "Falhou" — normalmente porque falta alguma configuração, como plano de contas), tem um botão Reprocessar que refaz a mesma tentativa depois de você corrigir o problema. Uma cobrança já em processamento não pode ser cancelada — espere ela terminar.