Проводки
В Приложении Process Insight для разделения бюджетов, бюджетных лимитов, фактических операций используются Сценарии. Метод выгрузки проводок позволяет выгружать проводки одного сценария. Для получения проводок, введённых или изменённых начиная с некоторой даты, следует выполнить следующий запрос
https://budgetform.appspot.com/x?auth=AUTH&command=ledger&scenario=XXX&from=YYYY-MM-DD&cursor=CURSOR
- AUTH [обязательный параметр] – ключ авторизации к API (подробнее)
- XXX [обязательный параметр] – ключ сценария (см. ниже)
- YYYY-MM-DD [обязательный параметр] – первая дата изменения проводок, определяющая момент, начиная с которого все изменения и новые проводки, внесённые в базу, должны выводиться в ответе запроса (таким образом, это не дата операции, а дата последних изменений проводки)
- CURSOR [опционально] – курсор, позволяющий продолжить выборку данных (см. ниже)
В результате Process Insight возвращает xml-файл, содержащий список проводок. Приложение возвращает за один запрос не более 100 проводок. В теге <payments> в атрибуте cursor возвращается курсор, который следует использовать для продолжения выборки проводок.
Каждая проводка содержит фиксированные атрибуты и атрибуты, зависящие от клиентских настроек.
Фиксированные атрибуты:
- key – ключ (идентификатор) проводки
- account – расчётный счёт
- date – дата операции (проводки с пустой датой являются P&L-проводками)
- debit – сумма поступления
- credit – сумма списания
- datecreated – дата и время создания проводки
- dateupdated – дата и время последнего изменения проводки
- description – текстовое описание
Атрибуты клиентских настроек представляют собой пары атрибут-значение. При этом и атрибут, и значение являются ключами. Ключ атрибута является ключом справочника, ключ значения является ключом элемента справочника. Значения ключей можно получить из запросов на справочники.
Ключ сценария
Ключ требуемого сценария можно получить двумя способами:
- Выгрузить таблицу сценариев в Excel (для выгрузки записей с их ключами нужно нажать “Выгрузить в Excel” в заголовке таблицы удерживая при этом клавишу Shift). В файле Excel в последнем столбце выводятся ключи всех сценариев.
- В форме управлениями правами сценария нажать “Дополнительно”. На открывшейся странице напротив надписи “Код элемента” будет выведен ключ сценария.
Особенности выгрузки
- Приложение не возвращает информацию об удалённых проводках
- Если проводка была изменена в процессе экспорта (например, между выполнением запросов), то Приложение вернёт её повторно