/Sberbank2Excel

конвертация выписки сбербанка по карте из формата PDF в формат Excel

Primary LanguagePythonMIT LicenseMIT

Sberbank2Excel

Расширяемая утилита для конвертации выписки Сбербанка по карте из формата PDF в формат Excel. (С возможностями расширения для выписок других банков).

Sberbank2Excel.PNG

Разработчик: ev2geny собака gmail.com

  • Конвертация одного или многих файлов PDF - выписки за один раз
  • Поддерживает несколько форматов выписки. См. Приложение А. Список поддерживаемых форматов
  • Легко расширяется для поддержки дополнительных форматов (см. CONTRIBUTING.md)
  • Автоматическое определение формата выписки
  • Верификация баланса по транзакциям и по шапке. Утилита вычисляет баланс по всем найденным транзакциям и сравнивает это число с балансом, вычисленным по информации в шапке выписки (к примеру баланс_по_шапке = СУММА ПОПОЛНЕНИЙ - СУММА СПИСАНИЙ - СУММА СПИСАНИЙ БАНКА). Если эти два числа не совпадают, то выписка по умолчанию не создаётся. Это даёт высокую вероятность того, что если Excel файл был создан, то конвертация прошла без ошибок.
  1. Скачать последнюю версию программы
  2. Разархивировать ZIP файл в отдельную директорию и найти sberbankPDF2ExcelGUI.bat

Шаг 1 Запустите sberbankPDF2ExcelGUI.bat

Шаг 2 Выберите один или несколько файлов выписки Сбербанка по карте в формате PDF

Шаг 3 Нажмите "Сконвертировать выбранные файлы"

Результат: утилита создаст файлы с расширением .xlsx

Примечание: опции Не удалять промежуточный текстовый файл и Игнорировать результаты сверки баланса по транзакциям и в шапке выписки используются в основном для отладки, сообщениях о проблемах или для тестирования.

Перед релизом утилита тестируется на конвертацию всех поддерживаемых форматах (см. Приложение А. Список поддерживаемых форматов) на всех доступных автору вариантах выписки. Если на Вашей выписке утилита не работает, либо если есть потребность добавить новый пока не поддерживаемый формат выписки, то существуют следующие варианты. (Варианты отсортированы в порядке возрастания сложности решения для Вас но одновременно в порядке убывания рисков связанных с конфиденциальностью данных для Вас же):

  1. Попросить автора добавить поддержку вашего формата выписки. Для этого нужно выслать автору:
  • pdf-вариант выписки
  1. Попросить автора добавить поддержку вашего формата выписки, выслав автору анонимизированные данные. Для этого потребуется выслать:
  1. Добавить новый формат выписки самостоятельно используюя инструкцию разработчика CONTRIBUTING.md.

Антивирусные программы пытаются определить вирусы по одним им известным алгоритмам. Часто они блокируют всё, что им кажется подозрительным, включая Sberbank2Excel. Одновременно с этим все известные автору производители антивирусных программ позволяют выслать им подозрительный файл для более пристального изучения, после чего разблокируют его в следующем апдейте базы данных вирусов. К примеру для Microsoft Windows Defender файл надо посылать сюда. Для Symantec сюда. Автор как правило "согласовывает" каждый новый релиз как минимум с Microsoft Windows Defender. Таким образом если антивирусная программа, установленная на Вашем компьютере атакует Sberbank2Excel, то возможны следующие варианты действия:

  • Согласовать вопросы с производителем антивируса самостоятельно
  • Попросить это сделать автора. Автору потребуется информация о типе антивирусной программы, атакующей утилиту.

Для сообщения об ошибках или пожеланиях по улучшению лучше всего воспользоваться функционалом системы github

На общие темы начните дискуссию здесь

Либо напишите письмо разработчику: ev2geny собака gmail.com

Банк Название формата (щёлкнуть мышью чтобы увидеть картинку) Описание MasterCard VISA Трансакции в иностранной валюте Известные проблемы
Сбербанк SBER_DEBIT_2005 Выписка по счёту дебетовой карты Сбербанка образца мая 2020 года OK ??? ОК  
Сбербанк SBER_DEBIT_2107 Выписка по счёту дебетовой карты Сбербанка образца июля 2021 года OK ??? ОК  
Сбербанк SBER_CREDIT_2110 Выписка по счёту кредитной карты Сбербанка образца октября 2021 года (точное время запуска формата выписки неизвестно) ??? OK OK? Сбер иногда неправильно считает баланс

Легенда

ОК - поддерживается

??? - неизвестно (не протестировано)

ОК? - точно неизвестно (не протестировано) но вроде должно работать

В случае если происходит ошибка в конвертации выписки, либо есть потребность добавить новый формат, разработчику потребуется доступ к проблемной/новой выписке для исправления программы. Если из соображений конфиденциальности нет возможности переслать разработчику изначальную выписку, можно переслать анонимизированный промежуточный текстовый файл. Для этого надо сделать следующее:

  • При ошибке конвертации конвертер создаст промежуточный текстовый файл с расширением .txt. Этот файл содержит текстовую информацию из pdf-выписки, которая в дальнейшем должна была быть использована для создания Excel - файла. Однако не вся текстовая информация используется для создания Excel файла. Задача состоит в том чтобы удалить неиспользуемую конфиденциальную информацию либо заменить используемую конфиденциальную информацию, но сделать это таким образом чтобы конвертер всё еще распознавал бы структуру файла и смог бы выполнить проверку вычисления сумм транзакций. Инструкция показывает что можно удалять, что можно заменять, а что нужно оставить без изменений.
  •  Используйте текстовый редактор и инструкцию чтобы удалить конфиденциальную информацию из промежуточного текстового файла (номер карты, фамилию, имя и т.д.). Т.к. для конвертер различает символ табуляции и пробелы, то рекомендуется использовать текстовый редактор, который показывает символы табуляции чтобы случайно не удалить их. Рекомендуемый текстовый редактор для этих целей: Notepad++
  •  Старайтесь удалять или менять как можно меньше информации. На выходе должно получиться что-то типа этого: пример анонимизированного промежуточного текстового файла
  • Попытайтесь сконвертировать теперь уже анонимизированный текстовый файл используя всё тот же sberbankPDF2ExcelGUI (для этого на Шаге 2 при выборе файлов надо разрешить выбор любых файлов, а не только .pdf)
  • Убедитесь, что при попытке конвертации анонимизированного текстового файла конвертер выдаёт такое же сообщение об ошибке, как и при попытке конвертации PDF файла.
  • Перешлите анонимизированный текстовый файл разработчику (ev2geny собака gmail.com) вместе с информацией об ошибке.