Adicione diretivas de link na barra lateral com datas ao Fava padrão, depois salve uma consulta que encontra saldos finais negativos após somar todos os lançamentos. Os exemplos foram executados com Beancount 3.2.3, beanquery 0.2.0 e Fava 1.30.16. Use a configuração local fixada.
Essas URLs direcionam para um servidor Fava local padrão. O painel hospedado do Beancount.io tem caminhos de relatório diferentes e é abordado separadamente abaixo.
Por que Personalizar o Fava?
Atalhos na barra lateral preservam uma visualização filtrada útil. Uma consulta salva pode então responder a uma pergunta contábil específica sem precisar digitar BQL repetidamente.
Problemas que isso resolve:
- Selecionar repetidamente o mês atual ou anterior.
- Reabrir um relatório salvo.
- Distinguir uma saída de uma conta que na verdade termina abaixo de zero.
✨ Links Personalizados na Barra Lateral
Adicione estas diretivas ao razão completo sidebar-demo.beancount na próxima seção. Inicie-o com fava sidebar-demo.beancount e abra seu relatório Journal antes de clicar em um atalho.
2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="O que Eles Fazem:
/jump retorna para a página no cabeçalho Referer do navegador e substitui os parâmetros de consulta fornecidos. Ele não abre sempre o relatório Journal. No balanço patrimonial, ele permanece no balanço patrimonial. Esse comportamento é implementado pelo manipulador de redirecionamento padrão do Fava.
- Mês Atual: Define
time=monthno relatório atual. - Mês Anterior: Define
time=month-1no relatório atual. - Limpar Tudo: Remove
account,timeefilter. Outros parâmetros, como conversão e intervalo, permanecem.
O fixture de 2021 não terá transações no mês atual; use Limpar Tudo antes de reproduzir os resultados de sua consulta. Uma URL /jump requer um referenciador. Para um favorito aberto diretamente, copie uma URL de relatório completa e funcional.
Na raiz do host, /jump?time=month foi testado a partir de /sidebar-demo/journal/?time=2021&account=Assets: retornou HTTP 302 para o mesmo journal com account=Assets&time=month. O relatório de destino retornou 200.
Se um administrador montar o aplicativo Fava inteiro em /books, todo atalho relativo à raiz deve incluir esse prefixo. Esta é uma configuração alternativa, não outra diretiva a adicionar junto ao Mês Atual acima:
2021-01-01 custom "fava-sidebar-link" "Current Month" "/books/jump?time=month"Um teste local de montagem WSGI verificou que /books/jump redireciona de volta para /books/sidebar-demo/journal/ com o novo filtro. O /jump simples está fora dessa montagem e retornou 404. Os links personalizados do Fava preservam a URL fornecida; um / inicial significa a raiz do host, não a raiz do razão.
Escopo hospedado, verificado em 2026-09-07: o código-fonte do painel do Beancount.io usa caminhos como /ledger/OWNER/LEDGER/income-statement e /ledger/OWNER/LEDGER/query. Sua barra lateral constrói seu próprio menu de relatórios. O código-fonte inspecionado não tem rota /jump nem consumidor de fava-sidebar-link. Esta receita padrão, portanto, não está estabelecida para esse painel. No produto hospedado, abra o relatório desejado e salve seu endereço funcional nos favoritos. O snapshot do código-fonte não prova qual revisão uma implantação ativa executa.
🔍 Consultas SQL Personalizadas
Salve este fixture completo como sidebar-demo.beancount. Ele inclui deliberadamente tanto lançamentos positivos quanto negativos em cada conta de ativo:
option "title" "Sidebar Demo"
option "operating_currency" "USD"
2021-01-01 open Assets:BCM:Positive USD
2021-01-01 open Assets:BCM:Negative USD
2021-01-01 open Equity:Opening-Balances USD
2021-12-01 * "Opening balances"
Assets:BCM:Positive 100.00 USD
Assets:BCM:Negative 20.00 USD
Equity:Opening-Balances -120.00 USD
2021-12-10 * "Outflows"
Assets:BCM:Positive -30.00 USD
Assets:BCM:Negative -50.00 USD
Equity:Opening-Balances 80.00 USD
2022-01-05 * "Refund"
Assets:BCM:Negative 10.00 USD
Equity:Opening-Balances -10.00 USD
2022-01-09 balance Assets:BCM:Positive 70.00 USD
2022-01-09 balance Assets:BCM:Negative -20.00 USDbea --file sidebar-demo.beancount check passa. No início de 9 de janeiro, Positive contém 100 - 30 = 70 USD; Negative contém 20 - 50 + 10 = -20 USD.
Execute esta consulta na página Query do Fava padrão com os filtros globais limpos:
SELECT account, currency, SUM(number) AS ending_balance
FROM postings
WHERE account ~ ':BCM:'
AND date < 2022-01-09
GROUP BY account, currency
HAVING SUM(number) < 0
ORDER BY account, currency;| Conta | Moeda | Saldo final |
|---|---|---|
| Assets:BCM:Negative | USD | -20.00 |
Explicação:
WHERE seleciona os lançamentos a agregar. Não há limite inferior de data: um saldo final precisa de todo o histórico anterior, incluindo os saldos iniciais de 1º de dezembro. O limite superior exclusivo inclui 8 de janeiro e exclui as transações de 9 de janeiro.
GROUP BY account, currency mantém commodities distintas separadas. HAVING SUM(number) < 0 filtra após somar as quantidades positivas e negativas de cada grupo. Este é um saldo final de unidades por moeda, não um valor de mercado convertido em uma única moeda. Ele reporta cada conta exata, não as contas pai consolidadas.
Para comparação, esta consulta executável responde a uma pergunta diferente: quanto foi lançado negativamente durante a janela de revisão?
SELECT account, currency, SUM(number) AS negative_postings
FROM postings
WHERE account ~ ':BCM:'
AND number < 0
AND date >= 2021-12-09 AND date < 2022-01-09
GROUP BY account, currency
ORDER BY account, currency;| Conta | Moeda | Lançamentos negativos |
|---|---|---|
| Assets:BCM:Negative | USD | -50.00 |
| Assets:BCM:Positive | USD | -30.00 |
A segunda consulta omite o estorno e os saldos iniciais. Sua linha -30.00 USD não significa que Positive está com saldo negativo. Adicionar um limite inferior de data à primeira consulta produziria, em vez disso, movimento líquido durante um período, não um saldo final. Consulte a referência BQL para mais sintaxe de consulta.
Casos de uso:
- Verificar contas de ativos em busca de quantidades negativas inesperadas.
- Revisar lançamentos negativos separadamente ao investigar saídas ou estornos.
- Reconciliar o saldo reportado com o histórico inicial e a atividade subsequente antes de tratá-lo como anomalia. Um saldo negativo de passivo ou receita pode ser normal.
🛠 Dica Pro: Combine Links + Consultas
O Fava suporta links para consultas. Adicione esta consulta salva e atalho ao sidebar-demo.beancount:
2021-01-01 query "negative-balances" "SELECT account, currency, SUM(number) AS ending_balance FROM postings WHERE account ~ ':BCM:' AND date < 2022-01-09 GROUP BY account, currency HAVING SUM(number) < 0 ORDER BY account, currency"
2021-01-01 custom "fava-sidebar-link" "Negative Balances" "/sidebar-demo/query/?query_string=.run+%22negative-balances%22"A diretiva de consulta também aparece na barra lateral de consultas salvas do Fava, sujeita a sidebar-show-queries (padrão 5). O atalho explícito aponta para o slug sidebar-demo do fixture e executa a consulta nomeada. A página de consulta padrão lê query_string da URL; sua API de consulta retornou a mesma única linha -20.00 USD no teste local. Veja o componente Query versionado.
Use o slug real do seu razão em um livro diferente. Sob a montagem /books, o atalho torna-se /books/sidebar-demo/query/?query_string=.run+%22negative-balances%22. Mantenha os filtros globais limpos para um saldo final de histórico completo; um filtro de data pode remover o histórico inicial antes que a consulta salva seja executada.
Considerações Finais
Use os atalhos de mês para navegar pelos relatórios e use a consulta salva para verificar um saldo final reproduzível. Ao revisar seu orçamento, distinga saídas, movimento do período e saldos de fechamento antes de interpretar um número negativo. Para relatórios adicionais, veja a documentação de extensões do Fava e o guia da interface.