Linux

hledger

Configuración básica de hledger para las finanzas personales.

Motivación

La configuración y uso ledger presenta una simpleza, rapidez y monitoreo notables al ser un estándar.

En particular, la implementación en hledger ofrece una cantidad de programas compatibles de importancia, tales como reportes e interfaz web.

Estructura

Empleamos el archivo ~/.hledger.journal para re-direccionar hledger para el archivo principal en la carpeta destinada a las finanzas cuentas/. 


; File ~/.hledger.journal

include ~/cuentas/main.ledger

Empleamos 2 archivos de configuración y una carpeta book/ para las transacciones. 


cuentas/
├── book/
│   └── 2000/
│       └── 01.ledger
├── header.ledger
└── main.ledger

Configuración

main
Lista los archivos ledger a emplear. Ademas de configurar el año.
header
Define las cuentas y monedas. 

; File main.ledger

include header.ledger

; Transacciones

Y2000
include book/2000/*.ledger

;Y2001
;include book/2001/*.ledger



; File header.ledger

;==============================================================================
;                                   Assets
;==============================================================================
account assets:banco
account assets:cash
;==============================================================================
;                                 Liabilities
;==============================================================================
account debts:tarjeta
;==============================================================================
;                                   Income
;==============================================================================
account income:trabajo
;==============================================================================
;                                  Expenses
;==============================================================================
account expenses:transporte
account expenses:comida
account expenses:alquiler

Tipos de cuentas.

Assets
Recursos disponibles como cuentas de banco y/o efectivo.
Liabilities
Deudas y/o obligaciones.
Income
Ingresos.
Expenses
Gastos.
Equity
Valor real de las propiedades, como acciones, muebles o inmuebles. También se emplea para la apertura y cierre de balances.

Transacciones

Los clasificamos por carpetas para los años y archivos (01.ledger) para los meses. Ademas se requiere un archivo para la apertura del balance que indica el dinero inicial disponible. 


; File book/2001/inicial.ledger

include header.ledger

01/01	*	'apertura del balance'
	assets:banco					1000.00	USD
	assets:cash					100.00	USD
	equity:apertura

Las transacciones emplean el principio de suma 0. De preferencia primero se declara la cuenta o cuentas a abonar/destino y al final las fuentes. Si la fuente es una, automáticamente se suma las cuentas destino, de lo contrario, es necesario declarar las cantidades individualmente.

También es necesario declarar el estado de la transacción.

Símbolo Estado Descripción
' ' Sin estado. Registrado pero no conciliado.
'!' Pendiente Intento de conciliación.
'*' Conciliado Completado, transacción correcta. 

; File book/2001/01.ledger

01/02	!	'alquiler'
	expenses:alquiler				300.00	USD
	assets:banco

01/03	*	'almuerzo'
	expenses:comida					30.00	USD
	assets:cash

01/03	 	'pasaje'
	expenses:transporte				5.00	USD
	assets:cash

Reportes

Balance básico. 


$ hledger bs

Balance Sheet 2000-01-03

              || 2000-01-03
==============++============
 Assets       ||
--------------++------------
 assets:banco || 700.00 USD
 assets:cash  ||  65.00 USD
--------------++------------
              || 765.00 USD
==============++============
 Liabilities  ||
--------------++------------
--------------++------------
              ||          0
==============++============
 Net:         || 765.00 USD

Balance por mes. 


$ hledger bs -M -V

Monthly Balance Sheet 2000-01-31, valued at period ends

              || 2000-01-31
==============++============
 Assets       ||
--------------++------------
 assets:banco || 700.00 USD
 assets:cash  ||  65.00 USD
--------------++------------
              || 765.00 USD
==============++============
 Liabilities  ||
--------------++------------
--------------++------------
              ||          0
==============++============
 Net:         || 765.00 USD

Reporte de ingresos y egresos. 


$ hledger is
Income Statement 2000-01-01..2000-01-03

                     || 2000-01-01..2000-01-03
=====================++========================
 Revenues            ||
---------------------++------------------------
---------------------++------------------------
                     ||                      0
=====================++========================
 Expenses            ||
---------------------++------------------------
 expenses:transporte ||               5.00 USD
 expenses:comida     ||              30.00 USD
 expenses:alquiler   ||             300.00 USD
---------------------++------------------------
                     ||             335.00 USD
=====================++========================
 Net:                ||            -335.00 USD

Reporte de ingresos y egresos por mes. 


$ hledger is -M -S
Monthly Income Statement 2000-01

                     ||         Jan
=====================++=============
 Revenues            ||
---------------------++-------------
---------------------++-------------
                     ||           0
=====================++=============
 Expenses            ||
---------------------++-------------
 expenses:alquiler   ||  300.00 USD
 expenses:comida     ||   30.00 USD
 expenses:transporte ||    5.00 USD
---------------------++-------------
                     ||  335.00 USD
=====================++=============
 Net:                || -335.00 USD

Enlaces externos