Это старая версия документа!
Установка и настройка модуля
Актуальный дистрибутив: https://disk.yandex.ru/d/EV6ZnP9vBqb0AQ
Установка стыковочного модуля
Распаковываем архив в папку:
aggregator_delivery.exe - создаём ярлык и запускаем службой/десктопом (ПКМ→Свойства→Ярлык и задаём ключ /install или /desktop)
вся информация хранится в файле dbase.db
После запуска службы сервис будет доступен по адресу 127.0.0.1:5000
Лицензирование
Модуль способен работать без лицензии в режиме «заполнение меню». Все предварительные операции - настройка, подготовка меню - можно делать без лицензирования. Лицензии необходимы на этапе приёма заказов.
Для работы модуля требуется одновременно две лицензии:
- лицензия на стыковочный модуль от «Карбис»
- лицензия на xml_save_order от UCS (поддержана как lifetime, так и saas-версия лицензии)
Для получения лицензии на модуль от «Карбис» нужно написать заявку на адрес info@carbis.ru Для получения лицензии на xml_save_order от UCS нужно сделать заявку в UCS в стандартном порядке (или обратиться к дилеру, если вы представитель ресторана). Далее по тексту предполагается, что лицензия на модуль от UCS уже активирована и не закончилась.
Пример письма, которое нужно написать: Тема:
Заявка на подключение модуля "интеграция с агрегаторами доставки".
Письмо:
Я, {имя}, представитель компании {Компания} прошу подключить интеграцию для ресторана {Название ресторана, предварительно заведённого в lic.carbis.ru}. Внешний белый IP-адрес ресторана: {IP-адрес} Порт, проброшенный для модуля интеграции: {порт, по умолчанию 5000} API-токен для внешней системы {API-токен}. API-токен скопирован мною из этой секции настроек: Адрес: фактический адрес данного конкретного ресторане (город, улица и т. д.)
Для инженеров ГК "Карбис". Описание настройки на стороне сервера.
В системе лицензирования lic.carbis.ru создаётся мастер лицензия для модуля Aggregator_Delivery. Эту операцию выполняют сотрудники «Карбис» после подтверждения заявки на установку.
Запускаем приложение с ключом /license
Откроется окно, где авторизуемся под дилерской учёткой lic.carbis.ru Затем выбираем ранее созданную мастер лицензию
Также модуль поддерживает XML SaaS. Подробнее об использовании XML лицензий по ссылке
Запуск службы и первичная настройка
Создание заказов происходит через XML-интерфейс. Для этого в R_keeper создаётся учётка с полными правами на кассовые операции.
После запуска службы aggregator_delivery, веб-интерфейс приложения будет доступен по адресу 127.0.0.1:5000 (127.0.0.1 - если запускать настройку локально на том же ПК, где устанавливаем модуль интеграции)
Заходим в Параметры и задаём следующие свойства:
- API токен - при первом запуске модуля токен генерируется автоматически;
- Адрес и порт кассового сервера;
- Логин/пароль учётки с полными правами для создания заказов через XML;
- Стол, на который будут приходить заказы из Яндекс.Еды:
- для платформы Яндекс
- для платформы Маркет деливери
- Кассовая станция;
- Выбираем классификацию меню (создаём при начальных настройках RK);
- Категорию заказа.
Опционально: Функция передачи оплаты указанной валютой
При включении чекбокса «Добавлять предоплаты в заказы интеграции» станет доступен выбор Валюты и Причины внесения
Приложение имеет функцию Автоматического принятия заказов, которая работает в трёх режимах:
- Отключено;
- Сохранить в r_keeper (создаст стол и сразу отправит сервис-печать);
- Сохранить с уточнением (сохранит как черновик, с необходимостью редактирования и подтверждения заказа до отправки сервис-печати).
Далее переходим во вкладку «Меню» и заполняем карточки блюд, которые выгрузились в интерфейс из ранее привязанной классификации.
На скриншоте показано, как должно быть всё заполнено.
Внимание!!! Названия блюд здесь берутся из расширенного свойства yaedaname.