/alfa_merger

💰 ALFA Bank CSV export files to Firefly III CLI connector

Primary LanguageRubyMIT LicenseMIT

AlfaMerger

CLI утилита, нормализаующая CSV файлы Альфа Банка для последующего экспорта в системы ведения домашней бухгалтерии.

Расчитана на FIREFLY III, но экспортируемый CSV файл можно использовать где угодно

Проблема

При выгрузке CSV файла из альфабанка

  • можно получить список транзакций только по одному счету. Не понятно как учитывать трансфер между счетами
  • список не очень хороший - нет уникального атрибута у тразакции
  • есть "мусорные" внутренние транзакции

Dev Plan

  • импорт транзакций в локальную бд
  • линкование транферов между счетами
  • пропуск транзакций по фильтру
  • пропуск транзакций по REF\SHA
  • история импорта
  • работа с XDG переменными для правильного бекапа/возможности использовать CLI не локально
  • конфигурация
  • безопасная переинициализация базы (бекап при миграции)
  • отображение и поиск тразакций
  • отображение и поиск истории
  • экспорт csv файлов для FIREFLY III
  • команда для генерации FIREFLY III маппинга
  • режим работы для CI\CRON без интерактивного UI
  • тесты (как же лень)
  • команда для исправления кодировки iconv -f windows-1251 -t UTF-8//TRANSLIT 2017-2018.csv -o qwe.csv
  • команда для генерации крон секвенции
  • пример флоу

Installation

Add this line to your application's Gemfile:

gem 'alfa_merger'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install alfa_merger

Usage

alfa_merger init
alfa_merger import some_tr.csv

Notes

Как и зачем?

По сути мы превращяем список тразакции в транзакции с инкам/ауткам счетом, где в случае трансфера оба поля заполнены

! Альфабанк позволяет себе дублировать рефы для определенных внутренних типов транзакций, что рождает "КОСТЫЛИ И ВЕЛОСИПЕДЫ" при попытке нормализовать транзакцию

  • Предоставление транша
  • Погащение ОД
  • Некоторые CASHIN на разных счетах
  • Отмены транзакций в один день
  • Начисления процентов
  • Старое снятие задолжностей с других счетов

Примеры ниже

tmp/movementList_eur.csv:"Счет EUR";"-";"EUR";"25.06.15";"CASHIN200308";"{VO99090}2.7  Внесение средств через устройство Recycling 200308 на счет. -";250;0
tmp/movementList_zp.csv:"Текущий зарплатный счёт";"-";"RUR";"02.11.15";"CASHIN200308";"Внесение средств через устройство Recycling 200308 на счет. -";15000;0

tmp/movementList_eur.csv:"Счет EUR";"-";"EUR";"12.02.14";"AA90X12061300303";"- Перевод средств с доп. счетов для погаш. задолж.. по кредитным догов. Дог. - от 130612";0;4,4
tmp/movementList_seif.csv:"Мой сейф";"-";"RUR";"09.09.13";"AA90X12061300303";"- Перевод средств с доп. счетов для погаш. задолж.. по кредитным догов. Дог. - от 130612";0;248,97
tmp/movementList_seif.csv:"Мой сейф";"-";"RUR";"11.07.13";"AA90X12061300303";"- Перевод средств с доп. счетов для погаш. задолж.. по кредитным догов. Дог. - от 130612";0;295,45

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/bigforcegun/alfa_merger. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

Copyright

Copyright (c) 2020 BigForceGun. See MIT License for further details.