Lançamentos

Criar um lançamento

O Lançamento é a unidade central do Orbyra: cada movimentação financeira (entrada ou saída) é um lançamento. Para criar um, vá em Lançamentos > Novo Lançamento e preencha:

  • Tipo: Receita ou Despesa.
  • Descrição e valor: obrigatórios.
  • Categoria/Subcategoria: o sistema sugere automaticamente com base no histórico ou via IA. Use o × ao lado do campo para limpar a seleção e voltar ao vazio.
  • Conta ou Cartão: escolha onde o dinheiro entra/sai.
  • Pessoa: quem realizou.
  • Data de vencimento (sempre) e data de pagamento (se já foi pago).
  • Favorecido, observação, evento: opcionais.

No celular, o formulário abre no modo simplificado com apenas os campos essenciais. Use o botão "Lançamento Expandido" para acessar todos os campos.

Abrir tela de Novo Lançamento
Parcelamento

Ao criar um lançamento, informe o número total de parcelas (ex: 12). O Orbyra distribui o valor de forma justa (sem perder centavos) e gera 12 lançamentos com numeração 1/12, 2/12, …, 12/12, um por mês a partir da data de vencimento informada.

  • A parcela 1 assume a data de pagamento que você informou (se já pagou) — as demais nascem como pendentes.
  • As parcelas formam uma série: editar uma não afeta as outras automaticamente.
  • Para compras parceladas no cartão, as parcelas seguintes nascem como "Fatura Pendente" — aguardando o pagamento da fatura correspondente.
Recorrência

Para gastos ou receitas que se repetem (aluguel, salário, mensalidades), use o campo Tipo de Recorrência: Semanal, Quinzenal, Mensal, Bimestral, Trimestral, Semestral ou Anual. Informe a data fim da recorrência e o sistema gera todas as ocorrências automaticamente.

Diferença para parcelamento: na recorrência, cada ocorrência é um lançamento independente, sem valor distribuído — todas têm o mesmo valor cheio.

Recorrência no cartão de crédito (Netflix, Spotify, SaaS): cadastre uma única vez como Mensal e o lançamento é vinculado automaticamente à fatura do mês. No relatório de Previsão, as faturas dos meses futuros que ainda não foram criadas aparecem como "Fatura {Cartão} – MM/AAAA" com o badge "Projeção", somando todas as recorrências daquele cartão na janela. Ao pagar a fatura corrente, a próxima ocorrência é materializada e a projeção dá lugar à fatura real.

Salvar como assinatura mensal

Ao criar ou editar um lançamento de despesa, você verá o toggle "Salvar como assinatura mensal". Ao ativá-lo e salvar, o Orbyra cria automaticamente um registro em Cadastros → Assinaturas de Serviço usando os dados do próprio lançamento: nome/descrição, valor, dia de vencimento, cartão ou conta, e categoria.

Isso é útil para serviços recorrentes como streaming, academia ou assinaturas de software: você registra o lançamento do mês normalmente e, com um clique, garante que o serviço fique catalogado na lista de assinaturas para projeção futura no fluxo de caixa.

  • O toggle só aparece quando o tipo de lançamento for Despesa.
  • Lançamentos já vinculados a uma assinatura exibem o badge "Assinatura mensal vinculada" com acesso direto à lista de assinaturas — o toggle não reaparece para evitar duplicatas.
  • Deletar o lançamento não remove a assinatura vinculada (e vice-versa).
Transferência entre contas

Quando você move dinheiro de uma conta para outra (ex: poupança → corrente), use a tela de Transferência. O Orbyra cria um par de lançamentos ligados: uma saída na conta de origem e uma entrada na conta de destino. Os dois ficam com a mesma data e descrição, e o saldo do perfil não muda.

Transferências não têm categoria por padrão e não aparecem como receita/despesa nos relatórios.

Abrir tela de Transferência
Dividir despesa entre pessoas

Na listagem de lançamentos, o botão Dividir Despesa permite repartir um gasto entre membros da família. Selecione as pessoas e o sistema gera novos lançamentos individuais — o valor é dividido igualmente entre os selecionados (mais quem fez a despesa originalmente).

Você pode optar por manter ou não os dados de conta/cartão da despesa original nos lançamentos derivados. Parcelamento e recorrência também são preservados.

Dar baixa (marcar como pago)

Lançamentos podem nascer Pendentes (sem data de pagamento) ou Pagos. Para marcar um pendente como pago a qualquer momento, use o botão Dar baixa na linha do lançamento. Você informa a data do pagamento e, se quiser, uma observação.

Despesas de cartão de crédito não têm botão "Dar baixa" individual — o pagamento é feito pela fatura.

Pagar fatura de cartão

Quando a fatura do cartão fecha, use a tela Pagamento de Fatura. O fluxo é guiado:

  1. Escolha o cartão — o Orbyra carrega automaticamente as faturas em aberto com status (Aberta, Fechada, Vencida) e total já calculado.
  2. Selecione a fatura (mês de competência) — o campo Valor é preenchido automaticamente com o total da fatura.
  3. Confirme a conta de origem (pré-selecionada quando o cartão tem conta vinculada) e a data de pagamento.

Ao salvar, o Orbyra cria uma despesa única na conta de origem, marca a fatura como Paga e os lançamentos daquela fatura passam a ser somente leitura. O lançamento de pagamento é tratado como entrada contábil, não polui os relatórios de despesa por categoria, favorecido ou pessoa.

Você também pode disparar o pagamento direto da tela de Faturas de Cartão, selecionando a fatura desejada.

Abrir tela de Pagamento de Fatura
Listagem e filtros

A tela Lançamentos mostra tudo do mês corrente por padrão, com filtros por descrição, categoria, conta, cartão, fatura do cartão, status e período. Os filtros ficam salvos por usuário (não vazam entre logins) e são restaurados quando você volta à tela.

  • Edição inline: clique em uma linha para editar descrição, favorecido, categoria e subcategoria sem abrir outra tela. Enter salva, Esc cancela. Os selects de categoria/subcategoria carregam dinamicamente.
  • Seleção em lote: use os checkboxes para excluir ou alterar a classificação de vários de uma vez.
  • Rodapé com totais: mostra Receitas, Despesas e Saldo do período filtrado. Se houver pagamentos de fatura no período, aparece também a linha Pagto. Faturas (não soma em Despesas para evitar duplo-cômputo, já que cada item da fatura é contado separadamente). Quando o filtro inclui transferências entre contas, a linha Transferência separa o total que entrou (verde) e saiu (vermelho); o Saldo passa a refletir o líquido quando você filtra por uma conta específica.
  • Legenda dos status: ícone "?" no cabeçalho da coluna Status abre um modal com a explicação de cada estado.
  • Período ampliado: o seletor de mês cobre 12 meses anteriores e 6 meses futuros, e o filtro usa Data de Vencimento — você vê tudo que vence no mês escolhido, mesmo que ainda não esteja pago.
  • Filtro por fatura do cartão: combobox com todas as faturas do perfil, ordenadas da mais recente para a mais antiga (formato "Cartão · mês ano"). Útil para revisar os lançamentos de uma fatura específica sem sair da tela. Lembre-se de ajustar o período se a fatura escolhida pertencer a um mês diferente do selecionado.
Abrir Listagem de Lançamentos
Duplicar lançamento

Use a ação Duplicar (ícone de cópia) na linha de um lançamento — ela está nos botões de ação da listagem (desktop) e dentro do menu "⋮" (mobile). Ao clicar, você é levado à tela Novo Lançamento com todos os campos pré-preenchidos a partir do original (descrição, valor, conta/cartão, categoria/subcategoria, pessoa, evento, favorecido, observação, tipo de recorrência, total de parcelas, etc.) — exceto as datas.

O que não é duplicado:

  • Datas (vencimento, pagamento, fim de recorrência) — você define a nova data de vencimento. Lançamento duplicado nasce sempre como pendente (sem data de pagamento).
  • Identificadores internos (ID e Guid) — o sistema gera novos automaticamente.

Um banner azul no topo do formulário indica que você está duplicando, mostra a descrição do lançamento de origem e lembra de ajustar a data antes de salvar. Você ainda pode mudar qualquer campo pré-preenchido antes de confirmar — é uma cópia de partida, não uma cópia obrigatória.

Quando usar: compras parecidas no mesmo cartão (mesma loja, valor próximo), assinaturas/serviços que se repetem em datas variadas, despesas recorrentes não-mensais (ex: anuidade que muda de mês entre anos). Para despesas idênticas que se repetem todo mês, prefira marcar recorrência mensal (ou Salvar como assinatura mensal) na criação original — duplicar manualmente é para casos que fogem ao padrão da recorrência.

Alterar classificação em lote

Marque dois ou mais lançamentos pelos checkboxes da grade e a barra de seleção em lote vai exibir o botão Alterar classificação. Ele abre uma janela onde você escolhe a nova Categoria e, opcionalmente, uma Subcategoria; ao clicar em Aplicar, todos os lançamentos selecionados recebem a nova classificação de uma só vez, sem precisar abrir cada um para editar.

  • Os lançamentos selecionados precisam ser do mesmo tipo (todos Receita ou todos Despesa). Se a seleção misturar tipos, o botão fica desabilitado e exibe o motivo no tooltip.
  • O combobox de Categoria mostra apenas categorias do tipo dos lançamentos marcados.
  • Subcategoria é opcional: deixar vazio limpa a subcategoria dos lançamentos atualizados.
  • As linhas da grade são atualizadas imediatamente após a confirmação, sem precisar recarregar a página.

Útil principalmente após importar um extrato bancário ou fatura PDF, quando vários lançamentos chegam sem categoria ou com classificação genérica.

Busca global (Command Palette)

Em qualquer tela do Orbyra, abra a busca global pela lupa do header (ou pelo atalho de teclado) e digite para encontrar lançamentos, contas, cartões, categorias, metas, etc. Por padrão a busca olha todos os campos relevantes.

Para refinar, use prefixos:

  • ! — busca apenas pela descrição do lançamento.
    Exemplo: !netflix
  • * — busca apenas pelo favorecido.
    Exemplo: *supermercado

As dicas dos prefixos aparecem no rodapé do palette enquanto você digita.

Excluindo lançamentos
  • Lançamento parcelado: ao excluir, todas as parcelas restantes também são removidas em cascata.
  • Lançamento recorrente / dividido: excluir o lançamento original remove todas as ocorrências geradas a partir dele (recorrências futuras, divisões para outras pessoas).
  • Transferência: ao excluir uma das pernas (saída ou entrada), o par espelho é removido junto — a transferência sempre vive ou morre como par.

A exclusão é lógica: o lançamento some das listagens e relatórios, mas o histórico de auditoria preserva quem e quando excluiu.