46 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			46 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # How to use account aliases
 | |
| 
 | |
| Here's an example of using [account aliases](manual.html#account-aliases).
 | |
| 
 | |
| Say a sole proprietor has a `personal.journal`:
 | |
| 
 | |
|     2014/1/2
 | |
|         expenses:food  $1
 | |
|         assets:cash
 | |
| 
 | |
| and a `business.journal`:
 | |
| 
 | |
|     2014/1/1
 | |
|         expenses:office supplies  $1
 | |
|         assets:business checking
 | |
| 
 | |
| So each entity (the business owner, and the business) has their own file with its own simple chart of accounts.
 | |
| However, at tax reporting time we need to view these as a single entity (at least in the US).
 | |
| In `unified.journal`, we include both files, and rewrite the personal
 | |
| account names to fit into the business chart of accounts,
 | |
| 
 | |
|     alias ^expenses    = equity:draw:personal
 | |
|     alias ^assets:cash = assets:personal cash
 | |
|     include personal.journal
 | |
|     end aliases
 | |
| 
 | |
|     include business.journal
 | |
| 
 | |
| Now we can see the data from both files at once, and the personal account names have changed:
 | |
| 
 | |
|     $ hledger -f unified.journal print
 | |
|     2014/01/01                                    # from business.journal - no aliases applied
 | |
|         expenses:office supplies            $1
 | |
|         assets:business checking           $-1
 | |
| 
 | |
|     2014/01/02                                    # from personal.journal
 | |
|         equity:draw:personal:food            $1   # <- was expenses:food
 | |
|         assets:personal cash                $-1   # <- was assets:cash
 | |
| 
 | |
| You can also specify aliases on the command line. This could be useful to
 | |
| quickly rewrite account names when sharing a report with someone else, such as
 | |
| your accountant:
 | |
| 
 | |
|     $ hledger --alias 'my earning=income:business' ...
 | |
| 
 |