Adicione sua primeira transação no app Beancount.io

Este guia apresenta como adicionar sua primeira transação usando as interfaces web e mobile do Beancount.io. Seja no desktop ou no mobile, você aprenderá a registrar rapidamente suas despesas e receitas.

Aplicativo Web​

Como Adicionar uma Transação​

1. Clique no botão "+" na seção do editor para adicionar um novo lançamento.
2. Selecione Transação nas abas no topo.
3. Informe a data da transação usando o seletor de calendário.
4. Preencha o favorecido (por exemplo, "UberEats") e a descrição (por exemplo, "Refeição – Almoço").
5. Informe as contas afetadas. Um almoço pago com cartão de crédito é uma despesa (um débito, inserido como valor positivo) financiada pelo aumento da dívida do cartão (um crédito, inserido como valor negativo):
   • Lado do débito: Expenses:Misc — valor positivo, ex.: 12.95 USD (a despesa aumenta)
   • Lado do crédito: Liabilities:CreditCard — valor negativo, ex.: -12.95 USD (o que você deve aumenta)
6. Clique em Salvar para registrar a transação. Os dois valores somam zero, o que torna o lançamento válido.

Qualquer que seja a interface usada, o lançamento salvo pela interface é uma transação Beancount comum cujos dois valores somam zero:

2025-01-02 * "UberEats" "Lunch Meal"
  Expenses:Misc              12.95 USD   ; debit: the expense increases
  Liabilities:CreditCard    -12.95 USD   ; credit: the balance you owe increases

Aplicativo Mobile​

Como Adicionar uma Transação​

1. Toque no botão Adição Rápida na tela inicial.
2. Informe o valor da transação (por exemplo, $12,95).
3. Escolha as duas contas entre as quais o dinheiro se move. Na convenção de sinais do Beancount, um débito é um valor positivo e um crédito é um valor negativo:
   • Para uma despesa no cartão: a categoria (ex.: Expenses:Misc) é debitada (positivo) e Liabilities:CreditCard é creditada (negativo)
   • Para renda: a categoria Income é creditada (negativo) e a conta Assets receptora é debitada (positivo)
4. Use o teclado numérico para confirmar o valor e toque em Avançar.
5. Informe o favorecido (por exemplo, "UberEats").
6. Adicione uma descrição (por exemplo, "Refeição – Almoço").
7. Toque em Concluir para salvar sua transação.

Dicas para o Sucesso​

• Categorize as transações de forma consistente para relatórios mais claros.
• Use descrições específicas para facilitar buscas e relatórios.
• Revise sua renda líquida regularmente para acompanhar padrões de gastos.
• Explore recursos avançados, como relatórios personalizados e orçamentos, à medida que se sentir confortável.
• Digitar um mês inteiro de histórico manualmente é lento — use o conversor de CSV para Beancount para converter uma exportação de extrato e cole o resultado no editor.

Se você tiver dúvidas ou quiser aprender mais, consulte o Guia de Introdução completo ou a Referência de Sintaxe.