Модуль импорта файлов OFX

Ace Jones

Thomas Baumgart

Jack H. Ostroff

Получение модуля

KMyMoney позволяет с лёгкостью импортировать файлы OFX. Но эта функциональность не является частью основной программы — она предоставляется как подключаемый модуль. Чтобы эта функциональность стала доступной, необходимо получить и установить модуль импорта файлов OFX. После этого в меню ФайлИмпорт автоматически появится команда импорта файлов OFX.

Обратите внимание, что исходный код этого подключаемого модуля предоставляется как часть исходного кода KMyMoney и большинство заранее собранных в пакеты версий KMyMoney уже содержат средство импорта OFX (внутри или как отдельный пакет). Если похоже, что в вашей версии не установлено средство импорта OFX, сначала следует проверить наличие этой программы там, откуда был получен базовый пакет KMyMoney. Проверить, установлено ли средство импорта OFX, можно путём вызова приведённого выше вложенного меню или выбора пункта меню НастройкаНастроить KMyMoney... с последующим выбором раздела Модули на левой панели и поиском средства импорта OFX в списке установленных модулей.

Если установка выполнялась из пакета RPM, модуль импорта файлов OFX содержится в пакете kmymoney-ofx. Этот пакет возможно найти в том же хранилище, из которого был получен основной пакет KMyMoney. Если же сборка программы выполняется из исходного кода, следует предварительно установить в системе последнюю версию заголовков библиотеки и самой библиотеки libOFX. Сценарий сборки KMyMoney обнаружит соответствующие файлы и соберёт модуль. На сентябрь 2021 года была доступна версия 0.10.3, хотя минимальной требуемой версией для KMyMoney всё ещё является 0.9.4.

Если в системе установлена подходящая версия libOFX, но при сборке KMyMoney возникли ошибки, воспользуйтесь списком рассылки для связи с разработчиками. Вложите в сообщение копию файлаconfig.log, предварительно сжав её с помощью gzip.

Что такое OFX?

OFX — сокращение от «Open Financial Exchange», хотя в 2019 году консорциум OFX присоединился к организации «Financial Data Exchange (FDX).» . Согласно веб-сайту FDX, «Open Financial Exchange — это открытый предназначенный для клиент-серверных систем и облачных программных интерфейсов стандарт обмена финансовыми данными и выполнения финансовых операций между финансовыми учреждениями и финансовыми приложениями. OFX не является финансовым учреждением.» Стандарт определяет форматы передачи финансовых данных как в виде файлов, так и напрямую.

Этот стандарт является гораздо более полным и гибким по сравнению с QIF, но в нём также имеется некоторая неопределённость; его работа зависит от конкретной реализации финансовым учреждением. Файлы OFX могут иметь разрешение «OFX» или «QFX» (в верхнем или нижнем регистре); это не оказывает влияния на содержимое. Спецификация основана на XML, поэтому файлы возможно прочитать с помощью любого текстового редактора. Так как использование пробелов не влияет на сами данные, в некоторых реализациях пробелы не используются вообще, что делает текст неудобочитаемым.

Ещё один веб-сайт с информацией об этом формате: OFX Home. На этом сайте доступен список финансовых учреждений, которые поддерживают работу с OFX. Этот список может понадобиться в случае возникновения сложностей при настройке непосредственного обмена данными OFX. На сайте есть форум для обсуждения проблем, связанных с OFX. Тем не менее, на сайте размещено сообщение о том, что он будет закрыт в феврале 2022 года, если текущий сопровождающий не найдет себе на замену человека, который возьмёт на себя обеспечение работы сайта.

Импорт файла OFX

Проще всего импортировать файл OFX с помощью соответствующего средства импорта (оно доступно в строке меню программы: ФайлИмпортOFX...). Если вложенное меню «Импорт» не содержит пункта «OFX», это означает, что модуль импорта файлов OFX не был установлен вообще или не был установлен надлежащим образом. Смотрите предыдущий раздел.

Сначала средство импорта предложит указать счёт для импорта операций. Если в файле имеются операции по разным счетам, соответствующий вопрос будет задан несколько раз. Обратите внимание, что при импорте данных для инвестиционного счёта операции в валюте будут импортированы на связанный брокерский счёт, если таковой настроен. Если брокерский счёт не настроен (или имеет отличное от стандартного название), программа предложит указать счёт для использования.

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

Обратите внимание, что в этом разделе приводится описание «внутреннего» модуля импорта файлов OFX. Импорт файлов OFX также возможно выполнить с помощью модуля импорта AqBanking (если он установлен). Следует учитывать, что поведение этих двух модулей немного отличается, так как они написаны и поддерживаются разными разработчиками.

Импорт инвестиций

Обратите внимание, что при импорте файла, содержащего инвестиционные операции, эти записи уже должны иметься в файле KMyMoney. Для сопоставления операций используется тикер, поэтому используемый в KMyMoney символ должен быть точно таким же, что и символ в импортируемом файле.

Интернет-соединение (Web Connect)

Проще всего импортировать файл OFX с помощью функции интернет-соединения (Web Connect). Перейдите на веб-сайт банка и нажмите ссылку для загрузки файла OFX. В браузере появится запрос на выбор программы, которую следует использовать для открытия файла: выберите KMyMoney. После этого загруженный файл OFX будет импортирован в текущий или последний открытый в программе KMyMoney файл. Также возможно изменить привязки файлов рабочей среды, чтобы файлы OFX автоматически открывались с помощью KMyMoney.

Если требуется импортировать файл OFX в какой-либо другой файл KMyMoney, сначала загрузите этот файл в KMyMoney, а затем посетите веб-сайт банка.

Прямое подключение (Direct Connect)

Теперь KMyMoney поддерживает OFX Direct Connect. Это позволяет KMyMoney напрямую обращаться к банку для получения операции. Чтобы включить эту возможность, необходимо собрать KMyMoney с переключателем --enable-ofxbanking. Теперь это стандарт; эта возможность включена в версии, предоставляемой большинством дистрибутивов Linux (если не всеми), а также в версиях, предоставляемых на веб-сайте KMyMoney.

Обратите внимание: некоторые банки требуют подписки, отличной от основного доступа к веб-банкингу, выдают отдельный пароль или PIN-код, а также могут взимать отдельную плату за соответствующую услугу. Ни один банк не предоставляет непосредственную поддержку работы с KMyMoney. Будет необходимо сообщить сотрудникам банка о том, что непосредственное подключение планируется установить с помощью MS Money или Quicken.

Первый шаг заключается в настройке каждого из счетов, для которых требуется загрузить выписки. Перейдите в представление «Счета», щёлкните правой кнопкой мыши по счёту, который следует настроить, и выберите в контекстном меню пункт Привязать счёт.... Если в системе установлено несколько модулей для работы с банками по сети, будет предложено выбрать нужный. Чтобы использовать встроенный модуль OFX, выберите OFX KMyMoney. Список банков будет получен из Интернета. После этого с помощью мастера выберите банк, укажите имя пользователя и пароль, а также счёт. Если нужный банк отсутствует в списке, возможно указать его параметры вручную. Необходимые данные возможно получить у сотрудников банка (также возможно попробовать найти их самостоятельно).

Примечание

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

Как только счёт будет настроен для сетевой работы с банком, откройте его в представлении книги учёта. Затем выберите пункт меню СчётОбновить счёт.... После этого программа установит соединение с банком и выполнит загрузку доступных операций. В диалоге Редактирование счёта (вкладка Параметры онлайн-банка, вложенная вкладка Подробности импорта) возможно указать параметры загрузки операций (с момента последнего обновления, за указанное количество дней или с указанной даты).

Примечание

В версиях KMyMoney, предшествующих 4.6, источником данных о названии контрагента всегда служило поле PAYEEID. Начиная с версии 4.6, в качестве источника данных о названии контрагента возможно использовать поле PAYEEID, NAME или MEMO операции OFX. Эту возможность и некоторые другие параметры прямого подключения OFX возможно настроить в упомянутом ранее диалоге Редактирование счёта.

Экспорт файла OFX

В текущей версии программы не поддерживается экспорт данных в файл OFX. Чтобы помочь в создании такого средства экспорта, свяжитесь с командой разработки libofx.