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.

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

Copyright (c) 2013 Andrey Lebedev <andrey@lebedev.lt>

Copyright (c) 2016-2017 Alexander Gerasiov <gq@cs.msu.su>

Copyright (c) 2017 Dmitry Pavlov <zeldigas@gmail.com>

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.