Для дилеров R-Keeper
Инструкция по интеграции с Delever: через XML или WhiteServer
Цель: Обеспечить корректную и быструю интеграцию между R-Keeper и Delever — операционной системой для управления онлайн-продажами ресторанов.
Delever поддерживает оба типа подключения:
через WhiteServer API
через XML-интеграцию
Эта инструкция поможет специалистам R-Keeper подготовить необходимые настройки и данные в зависимости от выбранного метода подключения.
Вариант 1: Интеграция через XML
Список лицензий из которого 1 из 3ех лицензий должна быть на объекте для работы с XML:
R-Keeper модуль XML-интерфейс для Приложения 1 мес ПО
R-Keeper модуль XML-интерфейс для Приложения 12 мес ПО
R-Keeper модуль XML сохранение заказов ПО
Дилеру RK нужно предоставить информацию специалистам Delever о том какая лицензия используется объектом.
Что нужно предоставить:
Параметр
Пример
Комментарий
Логин/Пароль
HTTPUSER/HTTPUSER
Логин и пароль пользователя созданного в менеджерской станции RK с правом “HTTP-ограничение” на подключение к нужным кассовым серверам.
Код кассира
4
Сотрудник в R-Keeper, Имя которого будет отображаться на чеках и от которого будут создаваться все заказы в RK.
Код станции
2
Станция R-Keeper, куда будут направляться заказы
Код категории заказа
2
Например, "Доставка"
Код столов
1 - собой 2 - узум 3 - яндекс 4 - ТгБот
Стол с именем агрегатора или пути продаж.
Для каждого филиала свои столы создаются. Могут иметь одно название и код
Коды типов заказов
2
Доставка, самовывоз и т.д.
Коды валют
3 – Нал, 4 – Карта
Должны быть созданы в R-Keeper
Системное имя расширенных свойств товаров(Описание, ИКПУ, Коды Упаковок)
description0419, IKPU, CodePackage
Используются для отправки этих данных агрегаторам и фискализации.
GUID товара “Стоимость доставки”
{87680C92-608A-4A37-AB90-449CE40A0F68}
Товар который будет добавляться в счет и в который Delever автоматически назначает сумму доставки.
userName / password аккаунта в l.ucs.ru. У которого есть доступ к карточке объекта который приобрёл XML лицензию по подписке. Также у аккаунта должно быть право на просмотр лицензий на этом объекте в l.ucs.ru
почта и пароль
Только при XML лицензии по подписке.
Токен лицензии
a38eb907-b727-46e1-8edc-68f51ded2d9a
Только при XML лицензии по подписке. Способ получения: “Чтобы получить token, необходимо отправить письмо с запросом на электронный адрес integrations@rkeeper.ru. Используйте ту электронную почту, на которую будет зарегистрирована учетная запись и токен”
Код ресторана в l.ucs.ru
514950001
Только при XML лицензии по подписке. Идентификатор ресторана.
IP(статичный, от провайдера) и Порт(HTTP data port до кассового сервера) проброшенный до компьютера на котором установлен Кассовый сервер RK.
Ip Port
Адрес для подключения к Кассовому серверу для отправки заказов.
Для каждого филиала нужен свой адрес.
Код макета чека
83
СКРИНЫ настроек. описание того что необходимо сделать - ниже.
Скрин 1.
Скрин 2.
Скрин 3.
Скрин 4.
Что нужно настроить:
В свойствах кассового сервера выставить HTTP Ограничения как на “Cкрин 1". Убрать галочку Use Free Listen Port. выставить нужный порт в HTTP Data Port.
Открыть свойства роли XML-Editing и выдать на “Кассовые ограничения” - “Операции” все права. Так же в “Менеджерские ограничения” - “привилегии на объекты” выставить галочку HTTP Access. пример “Cкрин 2”. Далее создать в этой роли работника имя и пароль которого будут использоваться для отправки запросов на кассу по XML.
Создать кассира, назначить нужные права, подписать имя как Delever.
Создать типы заказов и категорий.
Создать стол с именем агрегатора или пути продажи(ТгБот, Самовынос, Яндекс, Узум)
Создать валюты на которые будет происходить закрытие заказов делевером.
Нужно создать макет пречека для доставки и отредактировав его добавив в нужное место мемо с содержанием как на "Cкрине 4". заменить обычный пречек новым в схемах печати если заведение работает в формате фастфуд или столовая. либо если это ресторан то просто добавить созданный пречек в схему печати и сказать техникам делевер о том что нужно отправлять код макета пречека для доставки чтобы печатался только необходимый пречек.
Создать в меню товар “Стоимость доставки”. выставить нужную статичную цену ему и также поставить галочку “Открытая цена”.
Далее необходимо добавить дополнительное поле в товары с «ИКПУ» и «Код упаковки», для этого переходим в меню в «Настройки -> Настройка -> Расширенные свойства». Далее становимся на «Свойства для справочников» и добавляем туда поле с «ИКПУ», «Описание» и «Код упаковки», со свойствами:
Системное имя = IKPU
Название = ИКПУ
Список Типов = Class Info: Элемент меню
Системное имя = CodePackage
Название = Код упаковки
Список Типов = Class Info: Элемент меню
Системное имя = description0419
Название = Описание
Список Типов = Class Info: Элемент меню
Результат действий из пункта 9 должен выглядеть таким же как и на скрине 3.
Вариант 2: Интеграция через WhiteServer(WS):
Необходимые лицензии которые должны быть в карточке объекта:
WSServer (1)Интерфейс White Server (1)R-Keeper модуль XML-интерфейс для WSA ПО (1)R-Keeper модуль Интерфейс подключения к WS Delever 12 мес. ПО (611980001 Агрегатор DELEVER) (1)
Из всех лицензий оплачивается только лицензия номер 4. остальные предоставляются бесплатно запросом на почту integrations@rkeeper.ru, либо через менеджера от ucs через которого дилер запрашивает информацию.
Подробности про лицензии WS можно прочесть тут
Что нужно настроить:
Установить WhiteServer Agent и настроить связь с Кассовым сервером и Сервером справочников.
Зайти в админ панель WS под дилерским логином. Найти карточку объекта. Перейти в “Параметры создания заказа” и выставить “Обязательные параметры”.
Из “Что нужно настроить:” для XML сделать пункты 7, 8 и 9.
Что нужно предоставить:
Параметр
Пример
Комментарий
Код станции
2
Станция от которой будет печататься пречек.
Коды стола
1 - собой 2 - узум 3 - яндекс 4 - ТгБот
Стол с именем агрегатора или пути продаж.
Для каждого филиала свои столы создаются. Могут иметь одно название и код
Типы оплат
3 – Нал, 4 – Карта
Должны быть созданы в R-Keeper
Код кассира
4
Сотрудник в R-Keeper, Имя которого будет отображаться на чеках и от которого будут создаваться все заказы в RK.
ObjectId
289520007
ObjectId — это идентификатор филиал, который находится в Rkeeper-WS.
Last updated