재정을 관리할 준비가 되셨나요? 이 가이드는 몇 분 안에 Beancount를 사용할 수 있도록 도와드립니다. 첫 원장을 만들고, 필수 계정을 설정하고, 첫 거래를 기록하는 방법을 배우게 됩니다.

초기 설정
첫 번째 원장 만들기
; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
2024-01-02 * "Initial Deposit"
Assets:Checking 100.00 USD
Equity:Opening-Balances필수 설정
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"파일 구성
권장 구조
; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
; 2. Account Declarations
2024-01-01 open Assets:Checking USD
2024-01-01 open Assets:Savings USD
2024-01-01 open Expenses:Food USD
2024-01-01 open Equity:Opening-Balances
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
Expenses:Food 50.00 USD
Assets:Checking섹션 구성
-
영구 계정
2024-01-01 open Liabilities:Payables USD 2024-01-01 open Assets:Receivables USD -
은행 계정
2024-01-01 open Assets:Bank:Checking USD 2024-01-01 open Assets:Bank:Savings USD 2024-01-01 open Income:Bank:Interest USD -
투자 계정
2024-01-01 open Assets:Investment:Cash USD 2024-01-01 open Assets:Investment:Stocks VTSAX 2024-01-01 open Income:Investment:Dividend USD
검증 및 보고
기본 검증
# Check for errors (exits 0 when clean)
bea --file ledger.beancount check
# Browse balances, reports, and charts in the web interface
fava ledger.beancountbea check는 검증기입니다: 원장이 깨끗하면 0으로 종료되고, 오류가 있으면 모든 오류를 나열하고 0이 아닌 값으로 종료됩니다. CLI 빠른 시작으로 설치하세요. Fava는 웹 인터페이스입니다 - 실행하고 출력된 http://localhost:5000 주소를 열어 대차대조표, 손익계산서 및 계정 저널을 확인하세요.
일반적인 보고서
Beancount 3는 Fava의 웹 인터페이스, 원커맨드 bea report, 또는 Beancount 쿼리 언어를 실행하는 임시 쿼리 bea query를 통해 보고서를 생성합니다. Beancount 3는 이전의 보고서 및 웹 명령을 제거했습니다; bea report와 Fava가 이를 대체합니다.
# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
# Income statement, in one command
bea --file ledger.beancount report income-statement
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
# Income-statement numbers: totals by income and expense account
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"초기 잔액 관리
패딩 예제
2024-01-01 open Assets:Checking USD
2024-01-01 open Equity:Opening-Balances
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USDbalance 단언은 해당 날짜의 시작 시점에 계정을 확인하므로, 포함해야 하는 pad(또는 모든 거래) 이후 날짜로 지정해야 합니다. pad와 balance를 같은 날짜로 지정하면 pad가 사용되지 않고 단언이 부족해집니다 - Beancount는 Unused Pad entry 및 Balance failed 오류를 보고합니다. Equity:Opening-Balances 계정은 pad 대상이 되기 전에 먼저 개설되어야 합니다.
계정 폐쇄
2024-01-01 open Assets:OldBank:Checking USD
2024-06-30 close Assets:OldBank:Checking ; Account closed거래 중복 제거
이체 처리
; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
Assets:Checking -500.00 USD
Liabilities:CreditCard 500.00 USD
; Flag for pending match
2024-01-15 * "Pending CC Payment"
! Assets:Checking -500.00 USD
Liabilities:CreditCard 500.00 USD잔액 단언
; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking 2150.25 USD
2024-01-31 balance Liabilities:CreditCard -350.00 USD모범 사례
-
파일 구성
- 처음에는 하나의 메인 파일 유지
- 명확한 섹션 헤더 사용
- 관련 계정을 함께 그룹화
-
계정 이름
- 일관된 명명 규칙 사용
- 국가/기관 접두사 포함
- 논리적 계층 구조 유지
-
- 정기적인 잔액 단언
- 계정을 적절히 패딩
- 계정 폐쇄 추적
-
통화 처리
- 운영 통화 선언
- 일관된 상품 코드 사용
- 통화 제약 조건 지정
다음 단계
이제 기본 원장이 설정되었습니다:
- 정기 거래 기록: 일일 지출 및 수입부터 시작하세요
- 은행 계정 가져오기 설정: CSV 가져오기 또는 은행 연결을 사용하여 데이터 입력을 자동화하세요. 명세서 내보내기를 CSV to Beancount 변환기에 붙여넣어 브라우저에서 균형 잡힌 항목을 얻거나, OFX & QIF to Beancount를 사용하여
.ofx,.qfx및.qif다운로드를 처리하세요. - 검증된 레이아웃 복사: 작동 중인 원장 예제의 일상 개인 재무, 봉투 예산, 또는 프리랜서 섹션에서 실행 가능한 시작 파일을 다운로드한 다음, 같은 갤러리에서 자산 및 투자 패턴을 적용하세요
- 고급 구문 학습: 더 복잡한 시나리오는 구문 참조를 살펴보세요
- 첫 보고서 생성: UI 기능을 사용하여 재무 보고서를 만들고 지출을 분석하세요
- 터미널에서 작업: CLI 빠른 시작으로
bea명령줄을 설치한 다음, bea로 보내는 첫 달에서 전체 월말을 처음부터 끝까지 마감하세요
빠른 참조
일반적인 계정 유형:
Assets:Bank:Checking- 당신의 당좌 예금 계정Expenses:Food:Groceries- 식료품 지출Income:Salary:Company- 고용 소득Liabilities:CreditCard:Visa- 신용카드 부채
필수 명령:
bea --file ledger.beancount check- 원장 검증 (오류 시 0이 아닌 값으로 종료)bea --file ledger.beancount report balance-sheet- 대차대조표 출력bea --file ledger.beancount query "SELECT ..."- 잔액 및 거래 쿼리fava ledger.beancount- 보고서 및 차트를 위한 웹 인터페이스 실행
이 지침은 Beancount로 개인 재무를 관리하기 위한 견고한 기반을 마련합니다. 첫 거래를 추가할 준비가 되셨나요? UI 거래 가이드를 확인하세요.