Changes
-------
0.9.1 (2023-09-16)
==================
- Make OFX output conform to DTD (#243).
0.9.0 (2023-08-07)
==================
- New `-c` (`--config`) option for `convert` command, allows to specify the
configuration file to use (#235).
- Print the number of transactions in the output (#236).
0.8.0 (2021-09-06)
==================
- Support OFX CURRENCY and ORIGCURRENCY in statement lines. This allows plugins
to add information about transaction currency to generated OFX statements.
- Add `--pretty` flag to `convert` command to produce nicely intented OFX files.
0.7.1 (2020-09-14)
==================
- Include PEP-561 marker into source code distribution
0.7.0 (2020-09-13)
==================
- Drop support for Python 3.4, 3.5, add support for Python 3.8
- Fixed naive end balance validation (#106)
- Modernize development environment (use pipenv, mypy, black)
0.6.5 (2020-06-09)
==================
- Added balance checks and improved generation of unique ids (#100, #104)
0.6.4 (2020-03-04)
==================
- Fix regression introduced in 0.6.3 - `edit-config` command stopped working.
0.6.3 (2020-02-13)
==================
- Fix config editing on Windows
0.6.2 (2020-01-20)
==================
- Better `EDITOR` environment variable handling for `edit-config` command
- Support Python-3.7
- API: type of StatementLine.date_user (date when user initiated transaction)
will not be a string by default.
- API: More unique generated transaction ids (when one is not available from
the statement file)
0.6.1 (2017-05-07)
==================
- Fix installation problem on python-3.5 (#55)
0.6.0 (2016-12-02)
==================
- Support for specifying account information for each parsed satatement
line and translate it to BANKACCTTO aggregate in OFX.
- Command line option to display debugging information (--debug).
- Fix config file location for appdirs >= 1.3.0
0.5.0 (2013-11-03)
==================
- Plugins are now registered via setuptools' entry-points mechanism. This
allows plugins to live in separate eggs and developed independently of
ofxstatement itself. Plugins are registered as 'ofxstatement' entry points
(#11).
- Command line interface changed: ``ofxstatement`` now accepts "action"
parameter and few actions were added:
* ``ofxstatement convert``: perform conversion to OFX
* ``ofxstatement list-plugins``: list available conversion plugins
* ``ofxstatement edit-config``: launch default editor to edit configuration
file
- ``ofxstatement convert`` can be run without any configuration. Plugin name
to use is specified using ``-t TYPE`` parameter in this case (#12).
- ``StatementLine`` supports more attributes, translated to OFX (#13):
* ``refnum`` - translated to ``<REFNUM>`` in OFX.
* ``trntype`` - translated to ``<TRNTYPE>`` in OFX.
OFX Statement
-------------
.. image:: https://github.com/kedder/ofxstatement/actions/workflows/test.yml/badge.svg?branch=master
:target: https://github.com/kedder/ofxstatement/actions/workflows/test.yml
.. image:: https://coveralls.io/repos/kedder/ofxstatement/badge.png?branch=master
:target: https://coveralls.io/r/kedder/ofxstatement?branch=master
.. image:: http://www.mypy-lang.org/static/mypy_badge.svg
:target: http://mypy-lang.org/
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
Ofxstatement is a tool to convert proprietary bank statements to OFX format,
suitable for importing into personal accounting systems like GnuCash. This
package provides a command line tool to run: ``ofxstatement``. Run
``ofxstatement -h`` for more help. ``ofxstatement`` works under Python 3 and
is not compatible with Python 2.
Rationale
=========
Most internet banking systems are capable of exporting account transactions to
some sort of computer readable format, but few support standard data formats,
like `OFX`_. On the other hand, personal accounting systems such as `GnuCash`_
support standard formats only, and will probably never support proprietary
statement formats of online banking systems.
To bridge the gap between them, this ofxstatement tool was created.
.. _GnuCash: http://gnucash.org/
.. _OFX: http://en.wikipedia.org/wiki/Open_Financial_Exchange
Mode of Operation
=================
The ``ofxstatement`` tool is intended to be used in the following workflow:
1. At the end of each month, use your online banking service to export
statements from all of your bank accounts in a format known to
ofxstatement.
2. Run ``ofxstatement`` on each exported file to convert it to OFX.
Shell scripts or a Makefile may help to automate this routine.
3. Import the generated OFX file into your personal accounting system.
Installation and Usage
======================
Before using ``ofxstatement``, you have to install a plugin for your bank (or
write your own!). Plugins are installed as regular python eggs, with
easy_install or pip, for example::
$ pip3 install ofxstatement-lithuanian
Note that ofxstatement itself will be installed automatically this way. After
the installation, the ``ofxstatement`` utility will be available.
Users of *Ubuntu* and *Debian* operating systems can install ofxstatement from
official package repositories::
$ apt install ofxstatement ofxstatement-plugins
You can check that ofxstatement is working by running::
$ ofxstatement list-plugins
You should get a list of your installed plugins.
After installation, the usage is simple::
$ ofxstatement convert -t <plugin> bank_statement.csv statement.ofx
The resulting ``statement.ofx`` is then ready to be imported into a personal
accounting system.
Development / test
==================
``ofxstatemnt`` uses `pipenv`_ to manage the development environment and
dependencies::
$ pip install pipenv
$ git clone https://github.com/<your_account>/ofxstatement.git
$ cd ofxstatement
$ pipenv sync --dev
.. _pipenv: https://github.com/pypa/pipenv
And finally run the test suite::
$ pipenv shell
$ pytest
When satisfied, you may create a pull request.
Known Plugins
=============
There are several user-developed plugins available:
================================= ============================================
Plugin Description
================================= ============================================
`ofxstatement-lithuanian`_ Plugins for several banks, operating in
Lithuania: Swedbank, Danske and common Lithuanian exchange format - LITAS-ESIS.
`ofxstatement-czech`_ Plugin for Poštovní spořitelna
(``maxibps``) and banks using GPC
format (e.g., FIO banka, module
``gpc``).
`ofxstatement-airbankcz`_ Plugin for Air Bank a.s. (Czech Republic)
`ofxstatement-raiffeisencz`_ Plugin for Raiffeisenbank a.s. (Czech Republic)
`ofxstatement-unicreditcz`_ Plugin for UniCredit Bank Czech Republic and Slovakia
`ofxstatement-equabankcz`_ Plugin for Equa Bank a.s. (Czech Republic)
`ofxstatement-cz-komercni`_ Komerční banka (Czech Republic)
`ofxstatement-mbankcz`_ mBank S.A. (Czech Republic)
`ofxstatement-otp`_ Plugin for OTP Bank, operating in Hungary
`ofxstatement-bubbas`_ Set of plugins, developed by @bubbas:
``dkb_cc`` and ``lbbamazon``.
`banking.statements.osuuspankki`_ Finnish Osuuspankki bank
`banking.statements.nordea`_ Nordea bank (at least Finnish branch of it)
`ofxstatement-germany`_ Plugin for several german banks (1822direkt and Postbank at the moment)
`ofxstatement-austrian`_ Plugins for several banks, operating in Austria:
Easybank, ING-Diba, Livebank, Raiffeisenbank.
`ofxstatement-postfinance`_ Swiss PostFinance (E-Finance Java text based bank/credit statements).
`ofxstatement-mbank-sk`_ MBank.sk
`ofxstatement-be-belfius`_ Belfius (Belgium)
`ofxstatement-be-keytrade`_ KeytradeBank (Belgium)
`ofxstatement-be-ing`_ ING (Belgium)
`ofxstatement-be-kbc`_ KBC (Belgium)
`ofxstatement-be-argenta`_ Argenta (Belgium)
`ofxstatement-be-crelan`_ Crelan (Belgium)
`ofxstatement-be-triodos`_ Belgian Triodos Bank CSV statements
`ofxstatement-be-newb`_ Belgian cooperative bank newB
`ofxstatement-betterment`_ Betterment (https://www.betterment.com/)
`ofxstatement-simple`_ Simple (the bank, https://www.simple.com/) JSON financial statement format
`ofxstatement-latvian`_ Latvian banks
`ofxstatement-iso20022`_ Support for generic ISO-20022 format
`ofxstatement-seb`_ SEB (Sweden), it parses Export.xlsx for private accounts
`ofxstatement-ee-seb`_ SEB (Estonia), parses proprietary csv file
`ofxstatement-paypal`_ PayPal, it parses ``*.csv`` for private accounts
`ofxstatement-polish`_ Support for some Polish banks and financial institutions
`ofxstatement-russian`_ Support for several Russian banks: Avangard, AlfaBank, Tinkoff, SberBank (both debit and csv), VTB.
`ofxstatement-dab`_ DAB Bank (Germany)
`ofxstatement-consors`_ Consorsbank (Germany)
`ofxstatement-is-arionbanki`_ Arion bank in Iceland
`ofxstatement-de-triodos`_ German Triodos Bank CSV statements (also works for GLS Bank)
`ofxstatement-lansforsakringar`_ Länsförsäkringar (Sweden), it parses Kontoutdrag.xls for private accounts
`ofxstatement-revolut`_ Revolut Mastercard
`ofxstatement-transferwise`_ Transferwise CSV
`ofxstatement-n26`_ N26 Bank
`ofxstatement-sp-freiburg`_ Sparkasse Freiburg-Nördlicher Breisgau (Germany)
`ofxstatement-al_bank`_ Arbejdernes Landsbank (Denmark)
`ofxstatement-fineco`_ FinecoBank (Italy)
`ofxstatement-intesasp`_ Intesa San Paolo (xlsx balance file)
`ofxstatement-de-ing`_ Ing Diba Bank (Germany)
`ofxstatement-us-first-republic`_ First Republic Bank (USA)
`ofxstatement-cd-tmb`_ Trust Merchant Bank (DRC)
`ofxstatement-zm-stanbic`_ Stanbic Bank (Zambia)
`ofxstatement-dutch`_ Dutch financial institutes like ICSCards and ING
`ofxstatement-french`_ French financial institutes like BanquePopulaire
`ofxstatement-mt940`_ All financial institutes providing Swift MT940 statements
`ofxstatement-it-banks`_ Widiba and Webank italian banks
`ofxstatement-chebanca`_ CheBanca! Italian bank (xlsx format)
================================= ============================================
.. _ofxstatement-lithuanian: https://github.com/kedder/ofxstatement-lithuanian
.. _ofxstatement-czech: https://gitlab.com/mcepl/ofxstatement-czech
.. _ofxstatement-airbankcz: https://github.com/milankni/ofxstatement-airbankcz
.. _ofxstatement-raiffeisencz: https://github.com/milankni/ofxstatement-raiffeisencz
.. _ofxstatement-unicreditcz: https://github.com/milankni/ofxstatement-unicreditcz
.. _ofxstatement-equabankcz: https://github.com/kosciCZ/ofxstatement-equabankcz
.. _ofxstatement-mbankcz: https://github.com/SinyaWeo/ofxstatement-mbankcz
.. _ofxstatement-otp: https://github.com/abesto/ofxstatement-otp
.. _ofxstatement-bubbas: https://github.com/bubbas/ofxstatement-bubbas
.. _banking.statements.osuuspankki: https://github.com/koodaamo/banking.statements.osuuspankki
.. _banking.statements.nordea: https://github.com/koodaamo/banking.statements.nordea
.. _ofxstatement-germany: https://github.com/MirkoDziadzka/ofxstatement-germany
.. _ofxstatement-austrian: https://github.com/nblock/ofxstatement-austrian
.. _ofxstatement-postfinance: https://pypi.python.org/pypi/ofxstatement-postfinance
.. _ofxstatement-mbank-sk: https://github.com/epitheton/ofxstatement-mbank-sk
.. _ofxstatement-be-belfius: https://github.com/renardeau/ofxstatement-be-belfius
.. _ofxstatement-be-keytrade: https://github.com/Scotchy49/ofxstatement-be-keytrade
.. _ofxstatement-be-ing: https://github.com/jbbandos/ofxstatement-be-ing
.. _ofxstatement-be-kbc: https://github.com/plenaerts/ofxstatement-be-kbc
.. _ofxstatement-be-argenta: https://github.com/woutbr/ofxstatement-be-argenta
.. _ofxstatement-be-crelan: https://gitlab.com/MagnificentMoustache/ofxstatement-be.crelan
.. _ofxstatement-be-newb: https://github.com/SDaron/ofxstatement-be-newb
.. _ofxstatement-betterment: https://github.com/cmayes/ofxstatement-betterment
.. _ofxstatement-simple: https://github.com/cmayes/ofxstatement-simple
.. _ofxstatement-latvian: https://github.com/gintsmurans/ofxstatement-latvian
.. _ofxstatement-iso20022: https://github.com/kedder/ofxstatement-iso20022
.. _ofxstatement-seb: https://github.com/gerasiov/ofxstatement-seb
.. _ofxstatement-paypal: https://github.com/gerasiov/ofxstatement-paypal
.. _ofxstatement-polish: https://github.com/yay6/ofxstatement-polish
.. _ofxstatement-russian: https://github.com/gerasiov/ofxstatement-russian
.. _ofxstatement-dab: https://github.com/JohannesKlug/ofxstatement-dab
.. _ofxstatement-consors: https://github.com/JohannesKlug/ofxstatement-consors
.. _ofxstatement-is-arionbanki: https://github.com/Dagur/ofxstatement-is-arionbanki
.. _ofxstatement-be-triodos: https://github.com/renardeau/ofxstatement-be-triodos
.. _ofxstatement-de-triodos: https://github.com/pianoslum/ofxstatement-de-triodos
.. _ofxstatement-lansforsakringar: https://github.com/lbschenkel/ofxstatement-lansforsakringar
.. _ofxstatement-revolut: https://github.com/mlaitinen/ofxstatement-revolut
.. _ofxstatement-transferwise: https://github.com/kedder/ofxstatement-transferwise
.. _ofxstatement-n26: https://github.com/3v1n0/ofxstatement-n26
.. _ofxstatement-sp-freiburg: https://github.com/omarkohl/ofxstatement-sparkasse-freiburg
.. _ofxstatement-al_bank: https://github.com/lbschenkel/ofxstatement-al_bank
.. _ofxstatement-fineco: https://github.com/frankIT/ofxstatement-fineco
.. _ofxstatement-intesasp: https://github.com/Jacotsu/ofxstatement-intesasp
.. _ofxstatement-de-ing: https://github.com/fabolhak/ofxstatement-de-ing
.. _ofxstatement-germany: https://github.com/MirkoDziadzka/ofxstatement-germany
.. _ofxstatement-us-first-republic: https://github.com/medovina/ofxstatement-us-first-republic
.. _ofxstatement-cz-komercni: https://github.com/medovina/ofxstatement-cz-komercni
.. _ofxstatement-cd-tmb: https://github.com/BIZ4Africa/ofxstatement-cd-tmb
.. _ofxstatement-zm-stanbic: https://github.com/BIZ4Africa/ofxstatement-zm-stanbic
.. _ofxstatement-dutch: https://github.com/gpaulissen/ofxstatement-dutch
.. _ofxstatement-french: https://github.com/gpaulissen/ofxstatement-french
.. _ofxstatement-mt940: https://github.com/gpaulissen/ofxstatement-mt940
.. _ofxstatement-it-banks: https://github.com/ecorini/ofxstatement-it-banks
.. _ofxstatement-ee-seb: https://github.com/rsi2m/ofxstatement-ee-seb
.. _ofxstatement-chebanca: https://github.com/3v1n0/ofxstatement-chebanca
Advanced Configuration
======================
While ofxstatement can be used without any configuration, some plugins may
accept additional configuration parameters. These parameters can be specified
in a configuration file. The configuration file can be edited using the ``edit-config``
command that opens your favorite editor (defined by environment variable
EDITOR or else the default for your platform) with the configuration file::
$ ofxstatement edit-config
The configuration file format is in the standard .ini format. The
configuration is divided into sections that correspond to the ``--type``
command line parameter. Each section must provide a ``plugin`` option that
points to one of the registered conversion plugins. Other parameters are
plugin specific.
A sample configuration file::
[swedbank]
plugin = swedbank
[danske:usd]
plugin = litas-esis
charset = cp1257
currency = USD
account = LT123456789012345678
Such a configuration will let ofxstatement know about two statement file
formats handled by the plugins ``swedbank`` and ``litas-esis``. The ``litas-esis``
plugin will load statements using the ``cp1257`` charset and set a custom currency
and account number. This way, GnuCash will automatically associate the
generated .ofx file with a particular GnuCash account.
To convert the proprietary CSV file ``danske.csv`` into the OFX file ``danske.ofx``, run::
$ ofxstatement -t danske:usd danske.csv danske.ofx
Note that configuration parameters are plugin specific. See the plugin
documentation for more info.
To use a custom configuration file, pass the ``-c`` / ``--config`` option::
$ ofxstatement convert -t pluginname -c /path/to/myconfig.ini input.csv output.ofx
Writing your own Plugin
=======================
If the plugin for your bank has not been developed yet (see `Known plugins`_
section above) you can easily write your own, provided you have some knowledge
about the Python programming language. There is an `ofxstatement-sample`_
plugin project available that provides sample boilerplate and describes the
plugin development process in detail.
.. _ofxstatement-sample: https://github.com/kedder/ofxstatement-sample
Raw data
{
"_id": null,
"home_page": "https://github.com/kedder/ofxstatement",
"name": "ofxstatement",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "ofx,banking,statement",
"author": "Andrey Lebedev",
"author_email": "andrey@lebedev.lt",
"download_url": "https://files.pythonhosted.org/packages/2f/17/63e90b65cecca1e93708a4d43716dad5b5cede1487801241417ceef819cb/ofxstatement-0.9.1.tar.gz",
"platform": null,
"description": "Changes\n-------\n\n0.9.1 (2023-09-16)\n==================\n\n- Make OFX output conform to DTD (#243).\n\n\n0.9.0 (2023-08-07)\n==================\n\n- New `-c` (`--config`) option for `convert` command, allows to specify the \n configuration file to use (#235).\n- Print the number of transactions in the output (#236).\n\n\n0.8.0 (2021-09-06)\n==================\n\n- Support OFX CURRENCY and ORIGCURRENCY in statement lines. This allows plugins\n to add information about transaction currency to generated OFX statements.\n- Add `--pretty` flag to `convert` command to produce nicely intented OFX files.\n\n0.7.1 (2020-09-14)\n==================\n\n- Include PEP-561 marker into source code distribution\n\n\n0.7.0 (2020-09-13)\n==================\n\n- Drop support for Python 3.4, 3.5, add support for Python 3.8\n- Fixed naive end balance validation (#106)\n- Modernize development environment (use pipenv, mypy, black)\n\n0.6.5 (2020-06-09)\n==================\n\n- Added balance checks and improved generation of unique ids (#100, #104)\n\n\n0.6.4 (2020-03-04)\n==================\n\n- Fix regression introduced in 0.6.3 - `edit-config` command stopped working.\n\n\n0.6.3 (2020-02-13)\n==================\n\n- Fix config editing on Windows\n\n0.6.2 (2020-01-20)\n==================\n\n- Better `EDITOR` environment variable handling for `edit-config` command\n- Support Python-3.7\n- API: type of StatementLine.date_user (date when user initiated transaction)\n will not be a string by default.\n- API: More unique generated transaction ids (when one is not available from\n the statement file)\n\n0.6.1 (2017-05-07)\n==================\n\n- Fix installation problem on python-3.5 (#55)\n\n\n0.6.0 (2016-12-02)\n==================\n\n- Support for specifying account information for each parsed satatement\n line and translate it to BANKACCTTO aggregate in OFX.\n\n- Command line option to display debugging information (--debug).\n\n- Fix config file location for appdirs >= 1.3.0\n\n0.5.0 (2013-11-03)\n==================\n\n- Plugins are now registered via setuptools' entry-points mechanism. This\n allows plugins to live in separate eggs and developed independently of\n ofxstatement itself. Plugins are registered as 'ofxstatement' entry points\n (#11).\n\n\n- Command line interface changed: ``ofxstatement`` now accepts \"action\"\n parameter and few actions were added:\n\n * ``ofxstatement convert``: perform conversion to OFX\n * ``ofxstatement list-plugins``: list available conversion plugins\n * ``ofxstatement edit-config``: launch default editor to edit configuration\n file\n\n- ``ofxstatement convert`` can be run without any configuration. Plugin name\n to use is specified using ``-t TYPE`` parameter in this case (#12).\n\n- ``StatementLine`` supports more attributes, translated to OFX (#13):\n\n * ``refnum`` - translated to ``<REFNUM>`` in OFX.\n * ``trntype`` - translated to ``<TRNTYPE>`` in OFX.\n\n\nOFX Statement\n-------------\n\n.. image:: https://github.com/kedder/ofxstatement/actions/workflows/test.yml/badge.svg?branch=master\n :target: https://github.com/kedder/ofxstatement/actions/workflows/test.yml\n.. image:: https://coveralls.io/repos/kedder/ofxstatement/badge.png?branch=master\n :target: https://coveralls.io/r/kedder/ofxstatement?branch=master\n.. image:: http://www.mypy-lang.org/static/mypy_badge.svg\n :target: http://mypy-lang.org/\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\nOfxstatement is a tool to convert proprietary bank statements to OFX format,\nsuitable for importing into personal accounting systems like GnuCash. This\npackage provides a command line tool to run: ``ofxstatement``. Run\n``ofxstatement -h`` for more help. ``ofxstatement`` works under Python 3 and\nis not compatible with Python 2.\n\n\nRationale\n=========\n\nMost internet banking systems are capable of exporting account transactions to\nsome sort of computer readable format, but few support standard data formats,\nlike `OFX`_. On the other hand, personal accounting systems such as `GnuCash`_\nsupport standard formats only, and will probably never support proprietary\nstatement formats of online banking systems.\n\nTo bridge the gap between them, this ofxstatement tool was created.\n\n.. _GnuCash: http://gnucash.org/\n.. _OFX: http://en.wikipedia.org/wiki/Open_Financial_Exchange\n\nMode of Operation\n=================\n\nThe ``ofxstatement`` tool is intended to be used in the following workflow:\n\n1. At the end of each month, use your online banking service to export\n statements from all of your bank accounts in a format known to\n ofxstatement.\n\n2. Run ``ofxstatement`` on each exported file to convert it to OFX.\n Shell scripts or a Makefile may help to automate this routine.\n\n3. Import the generated OFX file into your personal accounting system.\n\nInstallation and Usage\n======================\n\nBefore using ``ofxstatement``, you have to install a plugin for your bank (or\nwrite your own!). Plugins are installed as regular python eggs, with\neasy_install or pip, for example::\n\n $ pip3 install ofxstatement-lithuanian\n\nNote that ofxstatement itself will be installed automatically this way. After\nthe installation, the ``ofxstatement`` utility will be available.\n\nUsers of *Ubuntu* and *Debian* operating systems can install ofxstatement from \nofficial package repositories::\n\n $ apt install ofxstatement ofxstatement-plugins \n\nYou can check that ofxstatement is working by running::\n\n $ ofxstatement list-plugins\n\nYou should get a list of your installed plugins.\n\nAfter installation, the usage is simple::\n\n $ ofxstatement convert -t <plugin> bank_statement.csv statement.ofx\n\nThe resulting ``statement.ofx`` is then ready to be imported into a personal\naccounting system.\n\n\nDevelopment / test\n==================\n\n``ofxstatemnt`` uses `pipenv`_ to manage the development environment and\ndependencies::\n\n $ pip install pipenv\n $ git clone https://github.com/<your_account>/ofxstatement.git\n $ cd ofxstatement\n $ pipenv sync --dev\n\n.. _pipenv: https://github.com/pypa/pipenv\n\nAnd finally run the test suite::\n\n $ pipenv shell\n $ pytest\n\nWhen satisfied, you may create a pull request.\n\nKnown Plugins\n=============\n\nThere are several user-developed plugins available:\n\n================================= ============================================\nPlugin Description\n================================= ============================================\n`ofxstatement-lithuanian`_ Plugins for several banks, operating in\n Lithuania: Swedbank, Danske and common Lithuanian exchange format - LITAS-ESIS.\n\n`ofxstatement-czech`_ Plugin for Po\u0161tovn\u00ed spo\u0159itelna\n (``maxibps``) and banks using GPC\n format (e.g., FIO banka, module\n ``gpc``).\n\n`ofxstatement-airbankcz`_ Plugin for Air Bank a.s. (Czech Republic)\n`ofxstatement-raiffeisencz`_ Plugin for Raiffeisenbank a.s. (Czech Republic)\n`ofxstatement-unicreditcz`_ Plugin for UniCredit Bank Czech Republic and Slovakia\n`ofxstatement-equabankcz`_ Plugin for Equa Bank a.s. (Czech Republic)\n`ofxstatement-cz-komercni`_ Komer\u010dn\u00ed banka (Czech Republic)\n`ofxstatement-mbankcz`_ mBank S.A. (Czech Republic)\n`ofxstatement-otp`_ Plugin for OTP Bank, operating in Hungary\n`ofxstatement-bubbas`_ Set of plugins, developed by @bubbas:\n ``dkb_cc`` and ``lbbamazon``.\n\n`banking.statements.osuuspankki`_ Finnish Osuuspankki bank\n`banking.statements.nordea`_ Nordea bank (at least Finnish branch of it)\n`ofxstatement-germany`_ Plugin for several german banks (1822direkt and Postbank at the moment)\n`ofxstatement-austrian`_ Plugins for several banks, operating in Austria:\n Easybank, ING-Diba, Livebank, Raiffeisenbank.\n`ofxstatement-postfinance`_ Swiss PostFinance (E-Finance Java text based bank/credit statements).\n`ofxstatement-mbank-sk`_ MBank.sk\n`ofxstatement-be-belfius`_ Belfius (Belgium)\n`ofxstatement-be-keytrade`_ KeytradeBank (Belgium)\n`ofxstatement-be-ing`_ ING (Belgium)\n`ofxstatement-be-kbc`_ KBC (Belgium)\n`ofxstatement-be-argenta`_ Argenta (Belgium)\n`ofxstatement-be-crelan`_ Crelan (Belgium)\n`ofxstatement-be-triodos`_ Belgian Triodos Bank CSV statements\n`ofxstatement-be-newb`_ Belgian cooperative bank newB\n`ofxstatement-betterment`_ Betterment (https://www.betterment.com/)\n`ofxstatement-simple`_ Simple (the bank, https://www.simple.com/) JSON financial statement format\n`ofxstatement-latvian`_ Latvian banks\n`ofxstatement-iso20022`_ Support for generic ISO-20022 format\n`ofxstatement-seb`_ SEB (Sweden), it parses Export.xlsx for private accounts\n`ofxstatement-ee-seb`_ SEB (Estonia), parses proprietary csv file\n`ofxstatement-paypal`_ PayPal, it parses ``*.csv`` for private accounts\n`ofxstatement-polish`_ Support for some Polish banks and financial institutions\n`ofxstatement-russian`_ Support for several Russian banks: Avangard, AlfaBank, Tinkoff, SberBank (both debit and csv), VTB.\n`ofxstatement-dab`_ DAB Bank (Germany)\n`ofxstatement-consors`_ Consorsbank (Germany)\n`ofxstatement-is-arionbanki`_ Arion bank in Iceland\n`ofxstatement-de-triodos`_ German Triodos Bank CSV statements (also works for GLS Bank)\n`ofxstatement-lansforsakringar`_ L\u00e4nsf\u00f6rs\u00e4kringar (Sweden), it parses Kontoutdrag.xls for private accounts\n`ofxstatement-revolut`_ Revolut Mastercard\n`ofxstatement-transferwise`_ Transferwise CSV\n`ofxstatement-n26`_ N26 Bank\n`ofxstatement-sp-freiburg`_ Sparkasse Freiburg-N\u00f6rdlicher Breisgau (Germany)\n`ofxstatement-al_bank`_ Arbejdernes Landsbank (Denmark)\n`ofxstatement-fineco`_ FinecoBank (Italy)\n`ofxstatement-intesasp`_ Intesa San Paolo (xlsx balance file)\n`ofxstatement-de-ing`_ Ing Diba Bank (Germany)\n`ofxstatement-us-first-republic`_ First Republic Bank (USA)\n`ofxstatement-cd-tmb`_ Trust Merchant Bank (DRC)\n`ofxstatement-zm-stanbic`_ Stanbic Bank (Zambia)\n`ofxstatement-dutch`_ Dutch financial institutes like ICSCards and ING\n`ofxstatement-french`_ French financial institutes like BanquePopulaire\n`ofxstatement-mt940`_ All financial institutes providing Swift MT940 statements\n`ofxstatement-it-banks`_ Widiba and Webank italian banks\n`ofxstatement-chebanca`_ CheBanca! Italian bank (xlsx format)\n================================= ============================================\n\n\n.. _ofxstatement-lithuanian: https://github.com/kedder/ofxstatement-lithuanian\n.. _ofxstatement-czech: https://gitlab.com/mcepl/ofxstatement-czech\n.. _ofxstatement-airbankcz: https://github.com/milankni/ofxstatement-airbankcz\n.. _ofxstatement-raiffeisencz: https://github.com/milankni/ofxstatement-raiffeisencz\n.. _ofxstatement-unicreditcz: https://github.com/milankni/ofxstatement-unicreditcz\n.. _ofxstatement-equabankcz: https://github.com/kosciCZ/ofxstatement-equabankcz\n.. _ofxstatement-mbankcz: https://github.com/SinyaWeo/ofxstatement-mbankcz\n.. _ofxstatement-otp: https://github.com/abesto/ofxstatement-otp\n.. _ofxstatement-bubbas: https://github.com/bubbas/ofxstatement-bubbas\n.. _banking.statements.osuuspankki: https://github.com/koodaamo/banking.statements.osuuspankki\n.. _banking.statements.nordea: https://github.com/koodaamo/banking.statements.nordea\n.. _ofxstatement-germany: https://github.com/MirkoDziadzka/ofxstatement-germany\n.. _ofxstatement-austrian: https://github.com/nblock/ofxstatement-austrian\n.. _ofxstatement-postfinance: https://pypi.python.org/pypi/ofxstatement-postfinance\n.. _ofxstatement-mbank-sk: https://github.com/epitheton/ofxstatement-mbank-sk\n.. _ofxstatement-be-belfius: https://github.com/renardeau/ofxstatement-be-belfius\n.. _ofxstatement-be-keytrade: https://github.com/Scotchy49/ofxstatement-be-keytrade\n.. _ofxstatement-be-ing: https://github.com/jbbandos/ofxstatement-be-ing\n.. _ofxstatement-be-kbc: https://github.com/plenaerts/ofxstatement-be-kbc\n.. _ofxstatement-be-argenta: https://github.com/woutbr/ofxstatement-be-argenta\n.. _ofxstatement-be-crelan: https://gitlab.com/MagnificentMoustache/ofxstatement-be.crelan\n.. _ofxstatement-be-newb: https://github.com/SDaron/ofxstatement-be-newb\n.. _ofxstatement-betterment: https://github.com/cmayes/ofxstatement-betterment\n.. _ofxstatement-simple: https://github.com/cmayes/ofxstatement-simple\n.. _ofxstatement-latvian: https://github.com/gintsmurans/ofxstatement-latvian\n.. _ofxstatement-iso20022: https://github.com/kedder/ofxstatement-iso20022\n.. _ofxstatement-seb: https://github.com/gerasiov/ofxstatement-seb\n.. _ofxstatement-paypal: https://github.com/gerasiov/ofxstatement-paypal\n.. _ofxstatement-polish: https://github.com/yay6/ofxstatement-polish\n.. _ofxstatement-russian: https://github.com/gerasiov/ofxstatement-russian\n.. _ofxstatement-dab: https://github.com/JohannesKlug/ofxstatement-dab\n.. _ofxstatement-consors: https://github.com/JohannesKlug/ofxstatement-consors\n.. _ofxstatement-is-arionbanki: https://github.com/Dagur/ofxstatement-is-arionbanki\n.. _ofxstatement-be-triodos: https://github.com/renardeau/ofxstatement-be-triodos\n.. _ofxstatement-de-triodos: https://github.com/pianoslum/ofxstatement-de-triodos\n.. _ofxstatement-lansforsakringar: https://github.com/lbschenkel/ofxstatement-lansforsakringar\n.. _ofxstatement-revolut: https://github.com/mlaitinen/ofxstatement-revolut\n.. _ofxstatement-transferwise: https://github.com/kedder/ofxstatement-transferwise\n.. _ofxstatement-n26: https://github.com/3v1n0/ofxstatement-n26\n.. _ofxstatement-sp-freiburg: https://github.com/omarkohl/ofxstatement-sparkasse-freiburg\n.. _ofxstatement-al_bank: https://github.com/lbschenkel/ofxstatement-al_bank\n.. _ofxstatement-fineco: https://github.com/frankIT/ofxstatement-fineco\n.. _ofxstatement-intesasp: https://github.com/Jacotsu/ofxstatement-intesasp\n.. _ofxstatement-de-ing: https://github.com/fabolhak/ofxstatement-de-ing\n.. _ofxstatement-germany: https://github.com/MirkoDziadzka/ofxstatement-germany\n.. _ofxstatement-us-first-republic: https://github.com/medovina/ofxstatement-us-first-republic\n.. _ofxstatement-cz-komercni: https://github.com/medovina/ofxstatement-cz-komercni\n.. _ofxstatement-cd-tmb: https://github.com/BIZ4Africa/ofxstatement-cd-tmb\n.. _ofxstatement-zm-stanbic: https://github.com/BIZ4Africa/ofxstatement-zm-stanbic\n.. _ofxstatement-dutch: https://github.com/gpaulissen/ofxstatement-dutch\n.. _ofxstatement-french: https://github.com/gpaulissen/ofxstatement-french\n.. _ofxstatement-mt940: https://github.com/gpaulissen/ofxstatement-mt940\n.. _ofxstatement-it-banks: https://github.com/ecorini/ofxstatement-it-banks\n.. _ofxstatement-ee-seb: https://github.com/rsi2m/ofxstatement-ee-seb\n.. _ofxstatement-chebanca: https://github.com/3v1n0/ofxstatement-chebanca\nAdvanced Configuration\n======================\n\nWhile ofxstatement can be used without any configuration, some plugins may\naccept additional configuration parameters. These parameters can be specified\nin a configuration file. The configuration file can be edited using the ``edit-config``\ncommand that opens your favorite editor (defined by environment variable\nEDITOR or else the default for your platform) with the configuration file::\n\n $ ofxstatement edit-config\n\nThe configuration file format is in the standard .ini format. The\nconfiguration is divided into sections that correspond to the ``--type``\ncommand line parameter. Each section must provide a ``plugin`` option that\npoints to one of the registered conversion plugins. Other parameters are\nplugin specific.\n\nA sample configuration file::\n\n [swedbank]\n plugin = swedbank\n\n [danske:usd]\n plugin = litas-esis\n charset = cp1257\n currency = USD\n account = LT123456789012345678\n\n\nSuch a configuration will let ofxstatement know about two statement file\nformats handled by the plugins ``swedbank`` and ``litas-esis``. The ``litas-esis``\nplugin will load statements using the ``cp1257`` charset and set a custom currency\nand account number. This way, GnuCash will automatically associate the\ngenerated .ofx file with a particular GnuCash account.\n\nTo convert the proprietary CSV file ``danske.csv`` into the OFX file ``danske.ofx``, run::\n\n $ ofxstatement -t danske:usd danske.csv danske.ofx\n\nNote that configuration parameters are plugin specific. See the plugin\ndocumentation for more info.\n\nTo use a custom configuration file, pass the ``-c`` / ``--config`` option::\n\n $ ofxstatement convert -t pluginname -c /path/to/myconfig.ini input.csv output.ofx\n\nWriting your own Plugin\n=======================\n\nIf the plugin for your bank has not been developed yet (see `Known plugins`_\nsection above) you can easily write your own, provided you have some knowledge\nabout the Python programming language. There is an `ofxstatement-sample`_\nplugin project available that provides sample boilerplate and describes the\nplugin development process in detail.\n\n.. _ofxstatement-sample: https://github.com/kedder/ofxstatement-sample\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Tool to convert proprietary bank statement to OFX format, suitable for importing to GnuCash",
"version": "0.9.1",
"project_urls": {
"Homepage": "https://github.com/kedder/ofxstatement"
},
"split_keywords": [
"ofx",
"banking",
"statement"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6072ee727885ee1b8716c5daee36557083baaa379a153abd97a74cb95f8971d0",
"md5": "d67529f4e8c2adb5f267b56c213f6eee",
"sha256": "e8c57537c9a4a9a5e5edf8dd51bd62bb5054b237ef17a19230b48432d5479416"
},
"downloads": -1,
"filename": "ofxstatement-0.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d67529f4e8c2adb5f267b56c213f6eee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 40541,
"upload_time": "2023-09-16T18:41:51",
"upload_time_iso_8601": "2023-09-16T18:41:51.370112Z",
"url": "https://files.pythonhosted.org/packages/60/72/ee727885ee1b8716c5daee36557083baaa379a153abd97a74cb95f8971d0/ofxstatement-0.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2f1763e90b65cecca1e93708a4d43716dad5b5cede1487801241417ceef819cb",
"md5": "c0eba67ebd2bc5df33b070f37d7945ad",
"sha256": "2276c7e697f3f668f9ad6c40156b732b6d7a2dbd4117d61042ca4085f2f26b6f"
},
"downloads": -1,
"filename": "ofxstatement-0.9.1.tar.gz",
"has_sig": false,
"md5_digest": "c0eba67ebd2bc5df33b070f37d7945ad",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 41996,
"upload_time": "2023-09-16T18:41:53",
"upload_time_iso_8601": "2023-09-16T18:41:53.437042Z",
"url": "https://files.pythonhosted.org/packages/2f/17/63e90b65cecca1e93708a4d43716dad5b5cede1487801241417ceef819cb/ofxstatement-0.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-16 18:41:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kedder",
"github_project": "ofxstatement",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ofxstatement"
}
JSON
