Changeset - bd07154fbbb8
[Not reviewed]
0 1 0
Ben Sturmfels (bsturmfels) - 2 months ago 2024-07-19 05:52:57
ben@sturm.com.au
statement_reconciler: Fix example usage docs
1 file changed with 1 insertions and 1 deletions:
0 comments (0 inline, 0 general)
conservancy_beancount/reconcile/statement_reconciler.py
Show inline comments
...
 
@@ -4,33 +4,33 @@ This tool takes an AMEX or First Republic CSV statement file and compares it
 
line-by-line with the Beancount books to make sure that everything matches. This
 
is designed for situations where transactions are entered into the books
 
directly, rather than being imported from a statement after the fact.
 

	
 
The reconciler will attempt to match transactions based on date, amount, check
 
number and payee, but is forgiving to differences in dates, the absensce of
 
check number and inexact matches on payee. Matches are ranked, so where there is
 
only one decent match for an amount/date this is accepted, but if there are
 
multiple similar candidates it will refuse to guess.
 

	
 
The reconciler will also attempt to identify where a single statement entry has
 
been split out into multiple Beancount postings, such as a single bank transfer
 
representing health insurance for multiple employees.
 

	
 
Run it like this:
 

	
 
$ statement_reconciler \
 
$ statement-reconciler \
 
  --beancount-file 2021.beancount \
 
  --account Liabilities:CreditCard:AMEX \
 
  --csv-statement ~/svn/2021-09-10_AMEX_activity.csv \
 
  --bank-statement ~/svn/2021-09-10_AMEX_activity.pdf
 

	
 
Background:
 

	
 
Regular Beancount users often write automated importers to create bookkeeping
 
entries direct from a bank statement or similar. That combines data entry and
 
reconciliation in one step. Conservancy uses a different approach; they manually
 
entering transactions and reconciling them later on. This workflow is helpful in
 
cases like writing checks (see below). This is the workflow implented by this
 
tool.
 

	
 
That said, this tool *is* still somewhat like an importer in that it needs to
 
extract transaction details from a third-party statement. Instead of creating
0 comments (0 inline, 0 general)