Как заполнить реквизиты доступа в Меркурий в программе ВСД Мобайл (v.3.1)

Как заполнить реквизиты доступа в Меркурий в программе ВСД Мобайл (v.3.1)

Первое, с чем придется столкнуться в начале работы с приложением - заполнение профиля Ветис.API

Если Вы имеете доступ в систему Меркурий только через ее веб-интерфейс, могу Вас огорчить: почти ничего из этого не подойдет для прямого подключения. К сожалению, для получения такого доступа нужно оформлять отдельную заявку. Подробно этот процесс описан здесь.

После того, как Вы отправите заявку и дождетесь ее одобрения, в полученном письме будут реквизиты доступа к Ветис.API. Вот они-то нам и нужны!

В версии программы "ВСД Мобайл" 3.1.х процедура заполнения реквизитов доступа несколько отличается от того, что было в предыдущей версии.

Чтобы занести реквизиты доступа в профиль пользователя "ВСД Мобайл" откройте приложение на своем смартфоне или планшете, затем откройте главное меню, нажав кнопку в меню слева вверху или проведя пальцем слева направо от края экрана. Нужно выбрать пункт "Профили Ветис.API". Откроется список, который, скорее всего у Вас пуст.

В версии 3.1.х появилась возможность создавать профили доступа и привязывать к ним площадки в специальном веб-приложении "Веб-помощник", описание работы с ним можно посмотреть здесь. Если у Вас уже есть заполненные профили и площадки в веб-помощнике, то обновить их в мобильном приложении можно нажав кнопку в меню формы. Работать с веб-помощником более удобно, нежели вводить реквизиты с клавиатуры смартфона, но, в любом случае, данные из веб-интерфейса помощника будут скопированы в поля профиля мобильного приложения. Поэтому, рекомендуем Вам ознакомиться со стандартной процедурой заполнения реквизитов.

В открывшейся форме "Профили Ветис.API" Нажимаем "+", Вам будет предложено выбрать тип профиля.

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

Назначение полей формы. Допустим, Вы решили заполнить реквизиты для доступа в продуктивный контур. Вот описание полей формы:

Хозяйствующий субъект - поле только для чтения. Если тестирование профиля пройдет успешно, здесь будет название хозяйствующего субъекта. Пока оно пустое.

API Key - это специальный ключ, который нужен Меркурию для идентификации клиентской программы. Он содержится в присланном письме и представляет собой длинную символьную строку. Ввести строку такой длины на смартфоне нереально, поэтому, для того, чтобы ее можно было хоть как-то считать, рядом с полем находится кнопка вызова сканера штрих-кода. Скопируйте API Key в любой редактор QR кодов, например, вот этот, и сгенерируйте соответствующий код. Наведите камеру Вашего смартфона на QR код и сканер считает строку в выбранное поле.

Инициатор - это конкретное лицо, от имени которого будут выполняться действия в системе. Этот реквизит соответствует логину, который Вы получили для входа в веб-интерфейс системы меркурий. Если Вы еще не получили такой доступ, то получать его все равно придется, т.к. он дается при регистрации реальной площадки в системе Меркурий. Подробнее смотрите здесь.

Issuer ID - еще один параметр, который требуется исключительно для корректной работы API. По сути, он представляет собой GUID хозяйствующего субъекта, зарегистрированного в Меркурии. Этот параметр содержится в письме с реквизитами доступа к Ветис.API. Чтобы не вводить 36-значную строку, можно так же воспользоваться генератором QR кодов и просканировать код сканером.

Логин и пароль - эти реквизиты нужно брать из подключения к Ветис.API, реквизиты доступа к веб-интерфейсу не подойдут! Будьте внимательны!

 

После того, как Вы ввели реквизиты, можно протестировать профиль выполнив команду из меню вверху формы. Можно так же сохранить профиль для того, чтобы вернуться к проверке позже. Если Вы не проверите профиль, то нет гарантии того, что программа будет корректно работы с Меркурием. Если проверка прошла успешно, в поле "Хозяйствующий субъект" появится название организации, который выданы реквизиты доступа к серверу Меркурия.

При проверке профиля будет последовательно выполнено его сохранение и попытка выполнить простой запрос поиска хозяйствующего субъекта к Ветис.API. На этом этапе можно будет проверить только правильность ввода логина и пароля, так как остальные реквизиты используются для обработки заявок, и проверить их можно будет позже. 

После тестирования и сохранения реквизитов, можно будет выбрать профиль из списка и добавить площадки для работы.

Ветис.API имеет ограниченные возможности поиска площадок, для удобства поиска мы сделали промежуточное хранение данных. Хранилище обновляется периодически, и новые площадки попадают в него по прошествии некоторого времени. Поэтому, поиск площадки хозяйствующего субъекта можно выполнить двумя способами:

  • среди проиндексированного массива площадок, которые соотнесены с хозяйствующим субъектом в профиле
  • непосредственно в системе Меркурий, по GUID площадки

 После того, как предприятие будет найдено, можно сделать его текущим и начать работу.

Надеемся, у Вас все получилось!