CCPFin ← Voltar ao sistema
Guia rápido

Seu financeiro organizado, sem complicação.

Este tutorial apresenta os recursos do CPFin e será ampliado a cada nova funcionalidade.

1Cadastre suas contas

Informe bancos, carteiras e caixas.

2Organize categorias

Crie quantos níveis precisar.

3Adicione contatos

Registre clientes e fornecedores.

Acesso correto Sempre abra o CPFin em http://localhost/cpfin/. Não abra o arquivo index.html diretamente pelo endereço file://, pois o navegador bloqueia os módulos e o login.
⌂
Tela inicial

Entenda seu dashboard

O dashboard reúne saldo, projeções, movimentações, contas, cartões e análises. Clique em qualquer card para abrir seus detalhes. Os botões Dia, Semana e Mês alteram o período analisado conforme cada módulo for alimentado.

+
Primeiro acesso

Solicite seu espaço financeiro

Na tela de login, escolha Criar minha conta e informe nome, e-mail e o nome do espaço. A solicitação fica pendente até a análise do administrador da plataforma.

  • Quando o acesso for aprovado, você receberá um e-mail de boas-vindas com um link pessoal válido por 72 horas.
  • No link, novos usuários criam a senha; quem já usa o CPFin apenas confirma a ativação do novo espaço.
  • O espaço nasce isolado dos demais, com “Minha Carteira” e categorias comuns já organizadas.
  • O administrador da plataforma participa de todos os espaços para prestar suporte e administrar acessos.
↻
Acesso

Redefina sua senha com segurança

Na tela de entrada, clique em Esqueci minha senha e informe exatamente o e-mail cadastrado no perfil. Por segurança, a resposta será igual mesmo quando o endereço não existir.

  • O link de recuperação expira após 30 minutos.
  • Cada link pode ser utilizado apenas uma vez.
  • Ao salvar a nova senha, todas as sessões anteriores são encerradas.
  • No ambiente localhost, o link aparece na própria tela; em produção ele deverá ser enviado pelo serviço de e-mail configurado.
◉
Privacidade

O ícone de olho protege seus valores

Clique no olho da barra superior para esconder todos os valores monetários. A escolha fica salva no seu usuário e será aplicada às demais telas do sistema.

Dica Use este recurso antes de compartilhar a tela ou trabalhar em locais públicos.
+
Personalização

Mostre somente os cards importantes

Na barra superior, selecione Adicionar e depois Adicionar componentes. Ative ou desative os cards e salve. A opção Restaurar padrão recupera a configuração inicial.

▣
Contas e caixas

Cadastre onde o dinheiro está

No menu Contas, use Novo para registrar conta corrente, caixa, carteira, poupança ou investimento. O saldo inicial representa o valor disponível na data informada.

  • Escolha a instituição no catálogo para aplicar seu ícone e sua cor automaticamente.
  • Use nomes claros, como “Conta principal” ou “Caixa da casa”.
  • A cor sugerida pelo banco pode ser personalizada.
  • Caixas e carteiras podem ficar sem banco vinculado.
  • Excluir desativa a conta sem apagar seu histórico financeiro.
⌘
Categorias

Comece com uma árvore pronta e adapte

O CPFin traz categorias comuns de receitas e despesas, com cores e ícones próprios. Você pode editar, desativar e ampliar essa base em níveis ilimitados.

  • Use a busca para localizar categorias ou subcategorias; o trecho encontrado aparece destacado.
  • Clique na seta para expandir ou recolher somente um ramo.
  • Use Expandir e Recolher para controlar toda a árvore.
  • Clique em + na linha de uma categoria para criar uma subcategoria já vinculada a ela.

Uma categoria pode conter subcategorias, que também podem conter outros níveis. Por exemplo: Despesas › Moradia › Manutenção › Elétrica.

Despesas└ Moradia 🏠 └ Manutenção 🔧  └ Elétrica ⚡

Categorias de receita só podem ficar dentro de receitas; despesas seguem a mesma regra.

♙
Contatos

Clientes e fornecedores

Cadastre pessoas ou empresas como cliente, fornecedor ou ambos. CPF/CNPJ, telefone e e-mail são opcionais. Depois, esses contatos poderão ser vinculados a pagamentos e recebimentos.

Durante uma transação, abra o seletor de cliente ou fornecedor e use Cadastrar para fazer um cadastro rápido com nome e CPF/CNPJ. O novo contato será selecionado automaticamente, sem fechar a transação.

↕
Movimentações

Acompanhe o saldo dia após dia

Abra Movimentações para alternar entre Dia, Semana e Mês. Cada ponto do gráfico representa o saldo acumulado naquela data; ao clicar, o valor destacado e a listagem acompanham o dia selecionado.

  • A visão semanal apresenta os sete dias da semana.
  • A visão mensal relaciona todos os dias do mês, inclusive os que não tiveram lançamentos.
  • A linha contínua representa valores realizados e a linha tracejada inclui provisionamentos.
  • Cada linha da listagem mostra a ordem do lançamento, um ícone colorido para o tipo, sua classificação, o valor e o saldo projetado logo depois dele, identificado por sobra.
  • Passe o mouse ou toque em uma movimentação para acessar comprovantes, realizar, editar ou cancelar sem poluir a leitura da lista.
  • No cadastro, o valor é formatado automaticamente em reais enquanto você digita.
  • Data, situação, pagamento, condição, parcelas e categorias abrem seletores próprios.
  • Todo gasto começa como Pagamento único e todo ganho como Recebimento único. Em Repetição, escolha diário, semanal, mensal ou anual e defina quantas vezes deve ocorrer — ou Sempre, sem data final.
  • As próximas ocorrências de gastos e ganhos recorrentes são criadas como provisionadas, facilitando a projeção do saldo.
  • O seletor de categorias preserva ícones, cores, busca e todos os níveis de subcategorias.
  • Nos gastos, o seletor pesquisável mostra fornecedores; nos ganhos, mostra clientes. Contatos marcados como cliente e fornecedor aparecem nos dois.

Use o botão verde + para registrar ganho, gasto, transferência ou criar uma recorrência.

Atalhos e organização Os controles de período ficam presos ao topo durante a rolagem. Use Hoje para voltar ao período atual e posicionar o dia de hoje no topo da lista. Clique no cabeçalho de qualquer dia para adicionar rapidamente um gasto ou ganho já nessa data. Arraste uma movimentação pela alça pontilhada para mudar sua ordem ou levá-la a outro dia; pelo teclado, use Alt + ↑/↓. Cards sólidos com trilho e confirmação estão realizados, enquanto previsões usam contorno tracejado.
✎
Extrato

Pesquise, edite e concilie seus lançamentos

Na tela Movimentações, use a busca para localizar descrições, categorias, contas ou contatos. Os filtros de tipo e situação trabalham dentro do dia, semana ou mês selecionado, sem alterar o gráfico consolidado.

  • ✓ Realizar: confirma um lançamento provisionado, pendente ou atrasado.
  • ✎ Editar: permite corrigir descrição, valor, data, conta, categoria, contato e situação.
  • × Cancelar: remove o lançamento dos cálculos sem apagar seu histórico no banco.

Em uma recorrência, cancelar pela listagem afeta somente aquela ocorrência. Pagamentos de fatura exibem o símbolo do cartão e devem ser pagos ou ajustados no módulo Cartões, garantindo a liberação correta do limite.

⌕
Documentos

Guarde o comprovante junto do lançamento

Na tela Movimentações, clique no botão de comprovantes na linha desejada. Você pode anexar recibos, notas e comprovantes em PDF, JPG, PNG ou WebP, com até 5 MB por arquivo.

  • O número sobre o botão indica quantos documentos estão anexados.
  • Use ↗ para abrir o arquivo em uma nova aba.
  • Use × para remover um comprovante após confirmar a operação.
  • Os documentos são privados e só podem ser acessados por usuários autorizados do mesmo espaço financeiro.
⇩
Importação bancária

Traga seu extrato CSV ou OFX

No menu Importar extrato, escolha a conta financeira e selecione o arquivo fornecido pelo banco. O CPFin analisa até 500 lançamentos por vez e mostra uma prévia antes de salvar.

  • Entradas positivas são reconhecidas como ganhos e saídas negativas como gastos.
  • Lançamentos já importados aparecem como duplicados e ficam desmarcados.
  • Você pode selecionar ou remover lançamentos individualmente antes de confirmar.
  • As regras de transação são aplicadas automaticamente e aparecem na prévia.

Para CSV, use colunas de data, descrição e valor. Também são aceitas colunas separadas de débito e crédito. Datas podem estar em formato brasileiro, como 07/10/2026, ou ISO, como 2026-10-07.

✓
Conciliação

Confirme o que realmente passou pelo banco

Durante a prévia do extrato, o CPFin compara cada movimentação com lançamentos provisionados, pendentes ou atrasados da mesma conta. A sugestão considera tipo, valor, proximidade da data e semelhança da descrição.

  • Conciliar: transforma o lançamento existente em realizado, mantendo sua categoria, contato e histórico.
  • Criar novo: registra outra movimentação quando a sugestão não corresponde ao item do banco.
  • O sistema nunca concilia ganhos com gastos ou valores diferentes.
  • Cada lançamento existente só pode ser sugerido uma vez dentro da mesma prévia.

Revise a opção exibida abaixo de cada item antes de confirmar. Depois da conciliação, o identificador do extrato também passa a impedir importações duplicadas.

⚒
Automação

Classifique lançamentos pela descrição

No botão verde +, abra Regras de transação. Informe um trecho que costuma aparecer na descrição e escolha a categoria ou o cliente/fornecedor que deve ser preenchido.

  • A prioridade menor é executada primeiro quando mais de uma regra corresponde.
  • A comparação ignora diferenças entre maiúsculas e minúsculas.
  • Uma escolha feita manualmente nunca é substituída.
  • O botão de raio aplica a regra em lançamentos antigos que ainda estejam sem classificação.

Ao digitar uma nova transação, o CPFin avisa quando uma regra será aplicada.

▰
Cartões

Limites, parcelas e faturas provisionadas

Cadastre o cartão informando limite, fechamento, vencimento e a conta usada para pagar a fatura. Ao digitar o número, a bandeira é identificada e a prévia muda com uma animação; somente os quatro últimos dígitos são salvos.

  • Compras parceladas são distribuídas automaticamente nas próximas faturas.
  • O valor total da compra ocupa o limite imediatamente.
  • Cada fatura gera um pagamento provisionado na conta escolhida.
  • Ao pagar a fatura, a conta é debitada e o limite correspondente é liberado.
◔
Planejamento

Saiba quando o mês entra em equilíbrio

O ponto de equilíbrio compara as receitas com todas as despesas conhecidas do mês. O círculo mostra quanto das despesas já está coberto por receitas realizadas.

  • Alcançado: as receitas realizadas já cobrem as despesas.
  • Previsto: uma receita provisionada fará a cobertura em uma data futura.
  • Sem previsão: ainda falta receita conhecida para cobrir o mês.

Clique no card para abrir o relatório completo.

⌁
Relatórios

Compare períodos e encontre onde você gasta

O relatório usa o regime de competência: despesas comuns entram na data do lançamento e compras no cartão entram na data da compra. O pagamento da fatura não é contado novamente, evitando duplicidade.

  • Use os atalhos para mês, últimos três meses ou ano.
  • Informe datas personalizadas quando precisar de outro intervalo.
  • A evolução compara receitas e despesas mês a mês.
  • A distribuição mantém o caminho completo das subcategorias.
⇩
Exportação e backup

Leve seus dados com você

Na tela de movimentações, use CSV para baixar o extrato do período selecionado. Em Relatórios, escolha as datas e use PDF para gerar um documento financeiro pronto para arquivar ou compartilhar.

  • O CSV contém data, vencimento, tipo, situação, descrição, valor e classificações.
  • O PDF usa o mesmo regime de competência mostrado na tela.
  • O proprietário encontra o backup completo em Equipe e acesso, clicando no próprio avatar.
  • O JSON inclui dados do espaço e comprovantes codificados, mas nunca inclui senhas ou tokens de sessão.
Guarde com segurança O backup contém informações financeiras e documentos. Armazene-o em local protegido. Nesta versão, a restauração automática do JSON ainda não está disponível.
♢
Lembretes

Não perca vencimentos importantes

O sino da barra superior reúne pagamentos, recebimentos e faturas que já venceram, vencem hoje ou acontecerão nos próximos sete dias. O número vermelho informa quantos avisos ainda não foram lidos.

  • Vermelho: lançamento ou fatura atrasada.
  • Amarelo: vencimento no dia atual.
  • Verde: vencimento próximo.
  • Clique no aviso para marcá-lo como lido e abrir a tela correspondente.

A leitura é salva individualmente: cada usuário do espaço financeiro mantém seu próprio controle de notificações. Novos vencimentos continuam visíveis para todos que possuem acesso ao dashboard.

⚙
Preferências

Receba somente os avisos importantes

Abra o sino e selecione Preferências. Cada usuário pode configurar seus próprios canais, tipos de lançamento e antecedência sem alterar as escolhas dos demais membros.

  • Ative ou desative a central de avisos dentro do CPFin.
  • Escolha pagamentos, recebimentos e faturas separadamente.
  • Decida se deseja ver atrasados, vencimentos do dia e próximos eventos.
  • Defina uma antecedência entre 1 e 30 dias.
  • Ative notificações do navegador após conceder a permissão solicitada.

As notificações do navegador são verificadas a cada cinco minutos enquanto o CPFin está aberto. Para alertas com o navegador fechado será necessária uma integração futura com push ou e-mail.

☺
Minha conta

Personalize seus dados e sua foto

Clique no avatar no canto superior direito e abra Meu perfil. Nessa área você pode atualizar nome, e-mail e foto, além de trocar sua senha. Para encerrar o acesso rapidamente, use o ícone Sair ao lado do avatar.

  • A foto pode ser JPG, PNG ou WebP com até 2 MB.
  • Alterar o e-mail exige a confirmação da senha atual.
  • A nova senha precisa ter pelo menos oito caracteres e ser diferente da atual.
  • Ao trocar a senha, as outras sessões da conta são encerradas por segurança.

As abas Minhas sessões e Equipe continuam disponíveis no mesmo painel conforme suas permissões.

✓
Segurança

Dados separados por espaço financeiro

O CPFin associa cada operação ao tenant da sessão. Papéis e permissões controlam o que cada usuário pode visualizar ou alterar. Nunca compartilhe sua senha e encerre sessões em dispositivos que não sejam seus.

♟
Multiusuário

Convide sua equipe com o acesso certo

O proprietário encontra Equipe e acesso no menu lateral. Informe o e-mail, escolha o papel e envie à pessoa o link gerado. O convite expira em sete dias.

  • Administrador: administra os módulos financeiros, mas não gerencia usuários.
  • Operador: registra e altera movimentações e cadastros operacionais.
  • Consulta: acessa dashboard, movimentações e relatórios sem fazer alterações.

Alterar o papel encerra as sessões antigas da pessoa para que as novas permissões sejam carregadas no próximo login. O proprietário é protegido contra alteração ou remoção acidental.

▣
Dispositivos

Veja onde sua conta está conectada

Clique no avatar da barra superior e abra Minhas sessões. A lista identifica navegador, sistema, endereço IP e horário de conexão.

  • Encerre individualmente qualquer sessão que não reconhecer.
  • Use Encerrar outras para preservar apenas o dispositivo atual.
  • O proprietário também pode encerrar todas as sessões de um membro pela área da equipe.
  • Remover o acesso de uma pessoa revoga imediatamente todos os refresh tokens dela.