Manual do Usuário e FAQ

O que é o Firmus

O Firmus organiza receitas, despesas, contas, cartões, contas a pagar e a receber, metas e orçamentos, e devolve uma nota de saúde financeira. Três ideias sustentam o produto:

• Funciona sem internet. O dia a dia fica no aparelho e sincroniza quando há rede. A cópia confirmada mora no servidor.
• A família cabe no mesmo lugar. Até quatro pessoas, com login próprio, contas e cartões compartilhados e uma visão consolidada.
• A IA sugere; você decide. Nenhum lançamento nasce só porque o modelo sugeriu.

Menus e abas

Quatro destinos, iguais no app e no Firmus Web. No celular eles ficam na barra de baixo, com Lançar no centro. No computador ficam na barra lateral, com o Assistente ao lado e Lançar num botão fixo. O cabeçalho guarda o Assistente (no app), o alternador Minha/Família, o estado da sincronização, o olho que oculta valores e o perfil.

Pelo perfil, nesta ordem: Configurações, Editar perfil, Meu plano, Família (quando o plano permite ou você já é membro) e Dados.

Hoje

É o resumo do mês. O título é uma frase curta do dia — atraso, algo que vence hoje, fatura que fecha ou vence em até três dias, saldo do mês no negativo, contas da semana — com o seu primeiro nome, sem valor e sem quantidade. Abaixo, a data de hoje. Sem lançamentos, a frase volta a ser um olá.

Seletor de mês

Mês anterior e próximo recalculam o resumo sem recarregar a tela. Fora do mês atual, dá para voltar para hoje. A nota de saúde financeira mostra sempre a nota atual, não a do mês escolhido.

Sobra do mês

Um número, com o rótulo Realizado ou Projetado. Realizado conta só o que já foi conciliado (pago ou recebido). Projetado soma a isso o que está agendado ou marcado para pagar sozinho no vencimento, no mês selecionado, mais o que está atrasado até o fim desse mês. Transferência não entra.

Fluxo de caixa

A série diária do saldo do mês: o que já aconteceu e o projetado. O eixo das datas marca as segundas-feiras. Tocar um ponto mostra a data e o saldo. A linha fica verde se o saldo final não é negativo e vermelha se é. O card recolhe pelo chevron.

Despesas por categoria

Rosca e lista do mês selecionado, sempre realizado mais projetado. Cada linha traz cor, nome, percentual e valor. Escolher uma categoria troca a rosca para as subcategorias. Compra no cartão entra no mês da fatura, não no dia da compra.

Contas e cartões

Dois cards. Contas reúne conta corrente e carteira. Cartões mostram a fatura do ciclo que vence no mês, com o status Aberta, Fechada, Paga, Parcialmente paga ou Vencida. O selo “Fatura simulada” aparece quando o teto do período é maior que as compras e a fatura ainda não fechou. “Fatura fechada” e “Fatura parcial” cobrem os outros casos.

Três escolhas ficam com esses cards e são lembradas: incluir saldo zero (desligado por padrão), Apenas em Real ou Todas as Moedas, e Realizado ou Projetado. Em Todas as Moedas, dólar e euro entram convertidos para real. Expandido, o card de cartões oferece Ver Saúde Financeira.

Destaques e pendências

Destaques são até duas frases curtas: falta de cobertura para o que ainda vai pagar, o primeiro dia em que o saldo projetado fica negativo, orçamento acima de 80%, fatura pesada em relação à renda, categoria que concentra o mês, categoria fora do ritmo do mês anterior, gasto diário acima do mês passado, ou dias já passados no negativo quando o mês se recupera. O link do Assistente só aparece se a IA conversacional estiver no plano e ligada.

A pagar e A receber abrem as próximas cinco de cada tipo, atrasadas primeiro. Dá para quitar dali, com o resumo do lançamento, ou abrir a edição sem gravar a quitação. O filtro de cada card é Acumulado (padrão) ou Só do mês. “Ver todas” abre Movimentos na vista Próximos.

O que aparece no Hoje

O ícone de ajustes escolhe quais cards entram e em que ordem: captura, sobra e saúde, fluxo de caixa, despesas por categoria, A pagar, A receber, destaques, contas e cartões. A escolha fica na sua conta e volta no outro aparelho.

Movimentos

Três vistas no mesmo destino.

Próximos

A agenda do que ainda não quitou: a pagar e a receber, em lista ou calendário. Não entra transferência nem compra de cartão — entra a fatura. Fatura aberta aparece como prevista; depois do fechamento, a ação é fechar e pagar. O filtro padrão são as pendentes. “Mostrar pagas” revela o que você quitou e que continua na lista. Em atraso, o selo diz quantos dias. Parcela mostra n/N. Lançamento fixo mostra o selo “fixo”.

Quitar pede valor e data, mostra o resumo e permite desfazer. Valor zero ou negativo não confirma. Se o pagamento da fatura for parcial, o Firmus pergunta se o restante vai para o próximo ciclo; fechar essa pergunta sem responder não grava.

Histórico

Tudo o que já passou, inclusive pago e recebido, no período inteiro. Recortes de 7, 30 e 90 dias são opcionais. Dá para editar um lançamento único, uma parcela ou um fixo. Mudar a estrutura (tipo, número de parcelas, frequência) preserva o que já foi pago e o que é anterior, e reescreve só o que ainda não foi pago dali para a frente.

Conciliação

Você escolhe a conta corrente ou o cartão — carteira não entra — e envia OFX, CSV, planilha, PDF ou foto (até 5 MB). OFX, CSV e planilha são lidos no aparelho. PDF e imagem passam pelo servidor. O Firmus sugere pares quando valor, data e descrição somam pelo menos 50 pontos, e separa o que casou, o que divergiu, o que só está no documento e o que só está no Firmus. A decisão é sua. Casar com o extrato não é a mesma coisa que marcar como pago.

Carteira

Contas

Conta corrente e carteira. O saldo realizado da conta é o saldo na data de referência mais o que foi confirmado depois. Saldo negativo é permitido. Na criação, o obrigatório é o nome; saldo atual é opcional. Moeda, data de referência, agência, número, cheque especial e conta conjunta ficam em “Mais detalhes”. O selo do banco é opcional. Carteira usa o ícone de carteira. Conta conjunta aparece para quem está na família.

Cartões

Nome, dia de vencimento, dia de fechamento e a próxima fatura (mês e ano) são obrigatórios. Limite, conta de pagamento, titular, bandeira e compartilhado são opcionais na criação. A conta de pagamento passa a ser obrigatória na hora de fechar a fatura. O limite disponível é o limite menos as faturas ainda não pagas e as parcelas futuras.

Dá para definir um teto para a fatura daquele mês. Com teto, a previsão a pagar é o maior valor entre as compras e o teto, até o fechamento. Fechar a fatura confere o total com o da administradora: o que já estava confirmado fecha, o previsto rola para o próximo ciclo sem mudar a data da compra. Pagar pode ser o total, uma parte (o resto vai ao próximo ciclo, se você confirmar) ou a maior (vira crédito). Fatura paga não reabre.

Planejar

Metas

Meta financeira tem valor alvo, valor atual, prazo e aportes. O aporte atualiza a meta; não cria lançamento nem transferência. Metas de hábito (não gastar por impulso, ou não gastar numa categoria) acompanham sequência e medalhas. Meta compartilhada com a família existe no plano Família. “Meta privada” respeita esse recurso.

Orçamentos

Teto por categoria e período. A sugestão olha as despesas dos três meses anteriores já fechados e propõe cerca de 10% acima da média, em múltiplos de R$ 50. Se a sugestão sair da faixa razoável, vale a média com esses 10%. O pilar de disciplina da saúde financeira usa o quanto do teto já foi gasto.

Relatórios

Três visões no mês selecionado. Fluxo de caixa abre por padrão: saldo de cada dia e uma tabela só dos dias com movimento. Categorias ranqueia despesas e receitas. Lançamentos lista o que foi pago e recebido, com filtro de status. A exportação de relatório depende do plano: CSV no Plus e na Família; CSV, Excel e PDF no Pro. Isso é diferente de exportar os dados da conta, que existe em todos os planos.

Lançar

Um toque em qualquer destino. Obrigatórios: tipo (receita, despesa ou transferência), valor, categoria (ou as duas contas, na transferência), conta ou cartão, e data. A descrição é opcional. O valor é digitado pelos centavos: 1 vira 0,01. Data até hoje nasce paga ou recebida; data futura nasce a pagar, a receber, ou “pagar automaticamente no vencimento”. Futuro nunca nasce pago.

Compra no cartão não pede status: a avulsa já nasce confirmada, e a parcela ou o fixo nasce automático. A quitação é a da fatura. “Lançar na fatura de” vem preenchido com o ciclo da data.

Parcelado não tem teto de quantidade; acima de 60 parcelas o Firmus pede confirmação. Fixo se estende sozinho. “Salvar +” mantém a folha aberta para o próximo. Até quatro atalhos recentes preenchem categoria e subcategoria. A frase em linguagem natural (“almoço de 38 no débito”) abre um rascunho; gravar continua sendo uma confirmação sua.

Assistente

Conversa sobre as suas finanças, se o resumo estiver ligado: saldos, a pagar, atraso e o que já foi gasto no mês e na semana. Você pode pedir para marcar uma conta como paga. Descrever um gasto devolve um card de rascunho, com editar, confirmar e descartar. Cada mensagem do Assistente na nuvem conta na cota do plano. Limpar o histórico apaga a conversa. Desligar “Habilitar o uso da IA” esconde a captura por frase e o atalho do Assistente, e desliga o envio do resumo junto.

Configurações, perfil e plano

• Perfil. Nome completo editável. E-mail somente leitura. Opcionais: apelido, CPF, telefone, se o telefone é WhatsApp, nascimento e gênero. A foto aceita JPEG, PNG, WebP, GIF e HEIC, até 2 MB, e é reduzida antes do envio.
• Preferências. Tema claro ou escuro, ocultar valores, moeda padrão (real, dólar ou euro), notificações e o tour de introdução. Ocultar valores vale em toda tela e volta no próximo login. Sem rede, a preferência volta ao valor anterior.
• Categorias. Dois níveis. Não dá para excluir categoria que já tem lançamento, nem categoria de sistema.
• Segurança. Biometria só no app, como trava ao abrir — não substitui a senha. Troca de senha pede no mínimo 8 caracteres e encerra as outras sessões.
• Família. Convite, membros, vagas usadas e sair ou remover. O link do convite não guarda o segredo em texto claro no servidor.
• Dados. Sincronizar agora, exportar JSON, importar, resetar registros e excluir a conta.
• Meu plano. Catálogo, troca com o valor proporcional, cancelamento ao fim do período, aviso se o pagamento está em atraso e, no anual, aviso pelo menos 7 dias antes da renovação. Contas e cartões acima do limite de um plano menor continuam visíveis e editáveis; só a criação nova é bloqueada.

Regras que mudam o número

• Liquidação. Agendado é a pagar ou a receber. Automático quita na data, se ela já chegou, ou fica para o vencimento. Conciliado é pago ou recebido.
• Transferência gera o par de saída e entrada e não conta como receita nem despesa.
• Pagamento de fatura é saída da conta, não uma despesa de categoria. O gasto do cartão já entrou pelas compras.
• Conciliação sugere; não aplica sozinha. A sugestão só aparece com 50 pontos ou mais, somando valor, data e descrição parecida.
• Minha e Família. Minha mostra o que é seu, mais contas conjuntas e cartões compartilhados. Família agrega o grupo. O lançamento de outra pessoa não aparece em Minha.

Operação sem internet

O app guarda os dados num banco local. O Firmus Web guarda no navegador. Os dois funcionam com a sincronização desligada e também quando a rede cai no meio do uso.

• Criar ou editar grava na hora e coloca a mudança numa fila. Com rede, a fila sai primeiro; depois o aparelho busca o que o servidor tem de mais novo.
• Se a mesma linha foi editada nos dois lados, vale a versão do servidor quando ela é mais nova. O app avisa uma vez por atualização quando a sua edição local é substituída.
• Um manifesto confere se falta alguma linha no servidor. O que falta, ou o que está mais novo no aparelho, volta para a fila. O Firmus não descarta um lançamento só porque o identificador veio inválido: ele corrige e reenvia.
• O indicador do cabeçalho fica verde, com o tempo relativo, só quando a fila está vazia e essa conferência fechou nesta sessão. Pendente e erro não usam verde. Tocar o indicador tenta de novo. No app, puxar a lista para baixo também atualiza; sem rede, ele só relê o que já está no aparelho.
• Dólar e euro usam a cotação de venda mais recente. Sem cotação, os fallbacks são 5,45 e 5,90.
• O plano contratado fica em cache. Sem snapshot nenhum, os recursos pagos ficam bloqueados, nos limites do Grátis. Sair da conta ou uma sessão inválida apaga esse cache.
• Sair da conta só limpa o aparelho depois que a fila esvazia e o servidor confirma o que estava nele. Com fila pendente, ou sem rede, o logout é cancelado.

Modelo embarcado

Além do Assistente na nuvem, o Firmus pode interpretar uma frase e algumas perguntas no próprio aparelho ou no navegador do Firmus Web. O arquivo não entra no pacote da loja. O download, de cerca de 1,1 GB, aparece uma vez no primeiro uso da captura por frase ou do Assistente — com a IA ligada e o recurso no plano — e continua disponível em Configurações. Há aviso para preferir Wi-Fi. O arquivo só é usado depois da conferência de integridade.

• A saída do modelo é obrigada a ser um objeto estruturado: tipo, valor, categoria, conta ou cartão e data. Texto livre não vira lançamento.
• A soma de “quanto tenho a pagar nesta semana” é feita pelas contas do Firmus, não pelo modelo. Pergunta que pede a lista das contas segue para o Assistente na nuvem.
• O rascunho é validado contra as suas categorias, contas e cartões. Rascunho que não dá para salvar é descartado. Nada é gravado antes de você confirmar.
• Esse processamento não envia a frase para a nuvem e não consome a cota mensal de comandos. Frase sem valor segue para o Assistente do servidor.
• No iPhone a inferência usa Metal. No Android fica no processador, com no máximo quatro threads. O modelo sai da memória depois de um tempo sem uso, para não pesar no restante do app.
• O Firmus não treina nem ajusta esse modelo no dispositivo. É um peso pronto, que você baixa.

Privacidade da IA na nuvem

O Assistente, a sugestão de orçamento, o ícone de uma categoria nova e a leitura de PDF ou foto de extrato podem sair do aparelho. O pedido leva só o que aquela função precisa. Não vão CPF, CNPJ, e-mail, telefone, senha, token de sessão, número completo de cartão, agência nem número de conta — e um filtro final ainda remove esses dados se aparecerem no texto.

“Enviar resumo financeiro ao Assistente” nasce ligado. Desligado, a conversa não recebe saldos nem lançamentos. Desligar a IA também desliga esse resumo; ligar de novo não religa o resumo sozinho. O histórico fica no máximo 90 dias. Detalhe em Como a IA usa seus dados.

Perguntas frequentes

Não achou a resposta? Escreva para ola@firmus.app.br.