Russian banks plugins for ofxstatement

ofxstatement_ is a tool to convert proprietary bank statement to OFX format, suitable for importing to GnuCash. Plugin for ofxstatement parses a particular proprietary bank statement format and produces common data structure, that is then formatted into an OFX file.

ofxstatement-russian_ provides some Russian banks plugins for ofxstatement.

.. _ofxstatement: https://github.com/kedder/ofxstatement .. _ofxstatement-russian: https://github.com/gerasiov/ofxstatement-russian

Supported banks:

• Avangard Bank (http://avangard.ru) plugin 'avangard'
• Tinkoff Bank (http://tinkoff.ru) plugin 'tinkoff'
• SberBank (http://sbrf.ru) plugins 'sberbank_csv', 'sberbank_txt'
• AlfaBank (https://www.alfabank.ru) plugin 'alfabank'
• VTB (https://www.vtb.ru) plugin 'vtb'

Avangard

CSV statements for credit, debit or current account.

Tinkoff

CSV statement for credit, debit and saving account.

SberBankCSV

CSV statement (available via "request statement by e-mail as Excel sheet" function).

SberBankTxt

Legacy TXT statement (available via "request statement by e-mail" function) for debit card.

AlfaBank

CSV statement for current account.

VTB

CSV statement for debit card.

Plugin configuration parameters

avangard

bank Bank id (default is 'Avangard')

account Account id

currency Currency (default is 'RUB')

tinkoff

bank Bank id (default is 'Tinkoff')

account Account id

currency Currency (if not set, will be extracted from the first record)

sberbank_txt

bank Bank id (default is 'SberBank')

account Account id (if not set, will be extracted from the statement)

currency Currency (if not set, will be extracted from the statement)

alfabank

bank Bank id (default is 'Alfabank')

account Account id (if not set, will be extracted from the statement)

currency Currency (if not set, will be extracted from the statement)

user_date if 'true' then transaction date will be set to the date when transaction is created (so called user date) rather then record date. User date is extracted in description if it is present there

file_encoding cp1251 by default. No need to change in regular usage (download statement, then convert), but could be handy in case of some file processing that involves encoding change

vtb

bank Bank id (default is 'VTB')

user_date if 'true' then transaction date will be set to the date when transaction is created (so called user date) rather then record date.

Development

Project is targeting python 3 (3.6 for sure as current widespread version) and pytest is used for testing.

Development setup is simple:

1. Create virtual environment and activate it .. code-block:: bash

   virtualenv .venv

   activate it according to your OS specifics

2. Install dependencies. It will download everything you need to develop and write tests .. code-block:: bash

   pip install -r requirements.txt

   python setup.py develop

3. Run tests using pytest .. code-block:: bash

   pytest

Authors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.