Интеграция с r_keeper

r_keeper — специализированная система ERP-класса, предназначенная для автоматизации ресторанного бизнеса. Интеграция с r_keeper работает через плагин FarCards. Перед его настройкой создайте на проекте все сущности из этой статьи.

Порядок настройки, ограничения и возможности интеграции указаны по ссылке.

Точка интеграции

Создайте точку интеграции со следующими настройками:

Параметр Значение
Тип Другое
Название Произвольное, например rkeeper

Остальные настройки можно оставить по умолчанию.

rkeeper-integration-endpoint

Статусы заказов

Создайте три статуса заказа:

Название Внешний идентификатор Категория
rkeeper.CheckedOut rkeeper.CheckedOut Оформлена
rkeeper.Cancelled rkeeper.Cancelled Отменена
rkeeper.Paid rkeeper.Paid Оплачена

Внешняя система

Создайте внешнюю систему с произвольным названием и системным именем.

rkeeper-external-system

Балльный счет

Создайте балльный счет. Допустимы любые настройки. Системное имя балльного счета понадобится для конфигурации плагина FarCards.

Внешние идентификаторы заказа

Создайте два дополнительных поля:

  • receiptNumber,
  • rkeeperOfflineId.

Настройки:

  • Сущность — Заказ.
  • Тип поля — Внешний идентификатор.
rkeeper-order-id-receipt-number.png
Дополнительное поле receiptNumber
rkeeper-order-id-offline.png
Дополнительное поле rkeeperOfflineId

Операции

Создайте операции. Во всех операциях укажите точку интеграции, созданную на первом шаге.

rkeeper.changeStatus

Параметр Значение
Системное имя rkeeper.changeStatus
Тип Приоритетная
Запускает транзакционный сценарий Да
Требуется передача секретного ключа Да

Шаги:

  • Действие — Переопределить точку контакта.
  • Заказ — Обновить статус позиций заказа.

rkeeper-op-change-status

rkeeper.AuthorizedPreOrder

Параметр Значение
Системное имя rkeeper.AuthorizedPreOrder
Тип Приоритетная
Запускает транзакционный сценарий Да
Требуется передача секретного ключа Да

Шаги:

  • Клиент — Авторизованный — Получить существующего. Поиск по: ID в Mindbox, дисконтной карте, заказу, мобильному телефону, промокоду.
  • Заказ — Процессинг — Расчет заказа.
  • Действие — Переопределить точку контакта.
  • Клиент — Получить данные по текущему клиенту. Настройки: баланс клиента во всех активных балльных счетах, дисконтные карты клиента, статус обработки, личные данные клиента.

rkeeper-op-authorized-preorder

rkeeper-op-authorized-preorder-steps

rkeeper.AuthorizedCreateOrder

Параметр Значение
Системное имя rkeeper.AuthorizedCreateOrder
Тип Приоритетная
Запускает транзакционный сценарий Да
Требуется передача секретного ключа Да

Шаги:

  • Клиент — Авторизованный — Получить существующего. Поиск по: ID в Mindbox, дисконтной карте, заказу, мобильному телефону, промокоду.
  • Заказ — Процессинг — Создать или обновить заказ.
  • Действие — Переопределить точку контакта.

rkeeper-op-authorized-create-order

rkeeper.GetOrder

Параметр Значение
Системное имя rkeeper.GetOrder
Тип Стандартная
Требуется передача секретного ключа Да

Шаги:

  • Заказ — Получить существующий.
  • Клиент — Авторизованный — Получить существующего. Поиск по: заказу.
  • Клиент — Получить данные по текущему клиенту. Настройки: баланс клиента во всех активных балльных счетах, дисконтные карты клиента, статус обработки, идентификатор клиента, личные данные клиента.
  • Добавить в ответ операции данные — информация о заказе.

rkeeper-op-get-order
rkeeper-op-get-order-steps

rkeeper.SaveOfflineOrder

Параметр Значение
Системное имя rkeeper.SaveOfflineOrder
Тип Стандартная
Требуется передача секретного ключа Да

Шаги:

  • Клиент — Авторизованный — Получить существующего. Поиск по: ID в Mindbox, дисконтной карте, заказу, мобильному телефону, промокоду.
  • Заказ — Процессинг — Сохранение оффлайн заказа.
  • Добавить в ответ операции данные — информация о заказе.

rkeeper-op-save-offline-order

rkeeper.AnonymousPreorder

Параметр Значение
Системное имя rkeeper.AnonymousPreorder
Тип Приоритетная
Запускает транзакционный сценарий Да
Требуется передача секретного ключа Да

Шаги:

  • Заказ — Процессинг — Расчет заказа.
  • Действие — Переопределить точку контакта.

rkeeper-op-anonymous-preorder

rkeeper.AnonymousCreateOrder

Параметр Значение
Системное имя rkeeper.AnonymousCreateOrder
Тип Приоритетная
Запускает транзакционный сценарий Да
Требуется передача секретного ключа Да

Шаги:

  • Заказ — Процессинг — Создать или обновить заказ.
  • Действие — Переопределить точку контакта.

rkeeper-op-anonymous-create-order

Данные для настройки плагина

После создания всех сущностей сохраните или передайте данные для настройки плагина:

  • Системное имя точки интеграции.
  • Системное имя балльного счета.
  • Системное имя внешней системы.
  • Секретный ключ интеграции.

Для передачи секретного ключа необходима пермиссия «Управление секретными данными».

Предыдущая
Segmel
Следующая
Flash Call — авторизация по звонку