Введение

В статье описана настройка "избранного" — списка блюд, к которому можно обращаться с кассовой станции. Там же можно из списка добавлять и удалять блюда. При нажатии кнопки Получить избранное — блюда добавляются к текущему заказу.

Для работы схемы понадобятся:

• XML-интерфейс на сервере справочников, доступный с кассы
•  

Настройка XML-интерфейса

Общая схема работы

1. Для работы с xml-интерфейсом и выполнения команд SaveOrder, PayOrder необходимо дополнительно передавать информацию о лицензии LicenseInfo.
2. Лицензия заводится и генерируется на сервере лицензирования, при этом в локальной БД ИНТЕГРАЦИИ в зашифрованном виде должны сохраняться учетные данные необходимые для выполнения запросов к СЛ: токен, id активной лицензии, порядковый номер запроса seqNumber.
3. Для ИНТЕГРАЦИИ нужно использовать один из имеющихся продуктов в СЛ (см. таблицу ниже). ВАЖНО: продукт определяется в в соответствии с типом ИНТЕГРАЦИИ.

Авторизация

Для запросов к системе лицензирования требуется авторизация. Для этого нужны:

• userName - логин интегратора (дилера)
• password - пароль интегратора (дилера)
• token - токен безопасности (токен выдается на Интегратора - на все его интеграции. Для получения токена отправьте письмо с запросом на integrations@ucs.ru)

В заголовке запроса должен быть передан параметр usr. Правило его формирования:

usr : Base64(userName + «;» + lowercase(md5(userName+password)) + «;» + lowercase(md5(token)))

Запрос id лицензии

Для получения id лицензии к СЛ выполняется запрос GetLicenseIdByAnchor

GetLicenseIdByAnchor?anchor=6:<productGUID>#<restCode>/17

Где 

• productGUID - GUID продукта
• restCode - код ресторана

Пример заполнения якоря для продукта "R-Keeper модуль XML-интерфейс для Приложения 12 мес ПО" для объекта 199999993

6:655cee55-7bcd-4826-b6e0-a8ccf2017ef3:199999993/17
ВАЖНО: символы ": # /" в строке должны быть экранированы!! (: - %3A # - %23)
т.е. запрос будет иметь вид:
https://l.ucs.ru/ls5api/api/License/GetLicenseIdByAnchor?anchor=6%3A655cee55-7bcd-4826-b6e0-a8ccf2017ef3%23199999993/17

ВАЖНО: для положительного ответа на объекте должна быть подтверждена заявка на указанное ПО и сгенерирована активная лицензия.

В ответ получим информацию об активной лицензии

{"id":"fe4e4c5a-3037-4f0c-8216-7b98be6d87bb","expirationDate":"2020-03-26T00:00:00","qty":1.0}

Полученный id должен сохраняться в БД ИНТЕГРАЦИИ и передаваться при заполнении LicenseInfo в атрибуте licenseToken. Обновление id нужно выполнять каждый раз при старте ИНТЕГРАЦИИ и при периодических проверках лицензии, например, каждые 30-90 минут либо при ошибках выполнения запроса перед повтором.

Заполнение LicenseInfo

При отправке команд SaveOrder, PayOrder, MakeRetunGoods ИНТЕГРАЦИЯ проверяет наличие в БД информации о лицензии (id лицензии), если id найден в xml запрос добавляется дополнительный элемент LicenseInfo.

<LicenseInfo anchor="6:655cee55-7bcd-4826-b6e0-a8ccf2017ef3:199999993/17" licenseToken="fe4e4c5a-3037-4f0c-8216-7b98be6d87bb"><LicenseInstance guid="instance_guid" seqNumber="0"/></LicenseInfo>

• anchor - якорь лицензии
• licenseToken - id лицензии
• guid - уникальный guid экземпляра приложения (При первом старте интеграции должен быть сгенерирован автоматически, в дальнейшем хранится локально и передается в каждом запросе)
• seqNumber -  порядковый номер запроса. При первом вызове для нового guid должен быть 0, увеличивается при каждом запросе. в ИНТЕГРАЦИИ  должно быть реализовано хранение текущего seqNumber в оперативной памяти или локальной БД. Для получения актуального значения на старте приложения можно использовать команду GetXMLLicenseInstanceSeqNumber, но эту команду нельзя выполнять слишком часто.

XSD схемы запросов можно посмотреть на ftp://tp.ucs.ru/rk7/ForDealers/XMLInterface/XML-Schemes

Введение

В статье описана интеграции r_keeper_7 и аналитическим приложением Grafana. 

Установка Grafana

Grafana доступна для различных систем — Linux, Windows и других. Установка тривиальна и подробно описана на странице скачивания. Для нашем примере будет установка на Windows. 

1. Скачайте установщик со страницы загрузки
2. Запустите установщик
3. Готово!