Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Parse Hang Seng eStatements to Beancount/CSV

Project description

Beancount/CSV parser for Hang Seng e-Statement

PyPI version

Parse Hang Seng (Hong Kong) Integrated Account e-Statement PDF, output results as beancount or CSV. Only Savings account is supported at the moment.


  1. Install external dependency pdftotext. This is normally packaged under poppler for most Linux distros. Windows users may try with this.

  2. Install package via pip:

     pip install beancount-hangseng



  1. Add HangSengSavingsImporter to your import config (See for example)
  2. Run bean-extract /path/to/eStatement.pdf > output.beancount


beancount-hangseng-csv -o output.csv /path/to/statement.pdf

If statements are already downloaded in one folder, you may process and verify output in one go:

# cd /path/to/output_dir
# beancount-hangseng-csv -v /path/to/HangSeng_*.pdf

Run beancount-hangseng-csv -h for more options and debug suggestions.


Inspired by @dictcp's Gist.

"Therefore I say unto you, Take no thought for your life, what ye shall eat, or what ye shall drink; nor yet for your body, what ye shall put on. Is not the life more than meat, and the body than raiment?" -- Matthew 6:25

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
beancount_hangseng-0.2.1-py3-none-any.whl (19.0 kB) Copy SHA256 hash SHA256 Wheel py3
beancount-hangseng-0.2.1.tar.gz (5.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page