Разделы и статьи

Интеграция R_Keeper 7 и Shelter CLOUD

В инструкции описывается процесс интеграции системы автоматизации ресторана R_Keeper 7 с гостиничной системой Shelter CLOUD. Цель интеграции — автоматический перенос гостевых расходов из ресторана на номер в PMS Shelter.

Необходимые инструменты и условия

Перед началом настройки убедитесь в наличии следующих компонентов:

  • Программное обеспечение R_Keeper 7:

    • R_Keeper 7 Manager (Менеджерская станция);

    • R_Keeper 7 Cash (Кассовая станция);

  • Доступ к Shelter Cloud:

    • Токен отеля в системе Shelter CLOUD. Для получения токена обратитесь в техническую поддержку Shelter;

  • Программный мост:

Закрытие на фолио работает только при наличии денежного депозита на счете клиента в Shelter Cloud.

Настройка R_Keeper 7 Manager

Создание PDS interface

  1. Запустите R_Keeper 7 Manager;

  2. Перейдите в раздел Сервис → Станции и устройства;

  3. Выберите нужный кассовый сервер из списка;

  4. В разделе Устройства кликните правой кнопкой и добавьте PDS interface;

    Запомните имя интерфейса — оно понадобится для настройки Farcards в параметре NetServerName=

Создание нового интерфейса

  1. Перейдите в раздел Сервис → Интерфейсы;

  2. Создайте новый интерфейс;

  3. Заполните параметры:

    • Название;

    • В разделе Файлы библиотек DLL выберите ранее созданный PDS interface для кассы.

Создание валюты для закрытия на номер       

  1. Перейдите в раздел Деньги → Валюты;

  2. Выберите раздел, например, Платежные карты;

  3. Кликните правой кнопкой мыши по свободной области и создайте новую валюту.

  4. После создания валюты откроется окно свойств. Обязательно заполните следующие параметры и сохраните изменения:

    • Блок «Основное»:

      • Статья ДДС;

      • Учитывать в отчетах;

    • Блок «Ограничения»:

      • Без сдачи;

    • Блок «Интерфейс»:

      • Доп. инфо;

      • Автозаполнение;

      • Интерфейс;

      • Процент бонуса.

      Для корректной работы интеграции в свойствах валюты необходимо установить параметру Тип фискальности значение Суммарно с вычитанием. Этот параметр можно изменить только под дилерской учётной записью R_Keeper. Если у вас нет соответствующих прав, обратитесь для настройки в организацию, обслуживающую вашу систему R_Keeper 7.

Создание скидки

  1. Перейдите в раздел Деньги → Скидки и наценки;

  2. Создайте новую скидку в нужном разделе:

    • Перейдите в разделе Свойства, и активируйте следующие опции:

    • Блок «Основное»:

      • Комбинировать с любой скидкой;

      • Тип — Процент;

    • Блок «Ограничения»:

      • На заказ;

    • Блок «Главное»:

      • Статус — Неактивен;

    • Перейдите на вкладку Детализация, чтобы создать детализацию скидки:

    • Блок «Основное»:

      • Укажите процент скидки и процент бонуса;

    • Вернитесь на вкладку Свойства и только после создания детализации скидки переведите статус в Активен, чтобы активировать скидку.

  3. Сохраните настройки.

Создание MCR алгоритма

  1. Перейдите в раздел Сервис → Обработка сигналов устройства → MCR алгоритмы;

  2. В рабочей области кликните правой мышкой и выберите Новый MCR алгоритм;

  3. Создайте алгоритм со следующими параметрами:

    • Тип алгоритма — Скрипт вер. 7.0;

    • Тип устройств — Клавиатура;

    • Объект — 11 FD24;

    • Область — Интерфейс;

    • Скрипт — нажмите на три точки и вставьте следующий код:

      function MCR1002154(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;

      begin

         if ('R'=Copy(Parameter, 1, 1)) or ('r'=Copy(Parameter, 1, 1)) or ('К'=Copy(Parameter, 1, 1)) or ('к'=Copy(Parameter, 1, 1)) then

         begin

           //delete(Parameter,1,1);

           Result:=True;

         end

       else

         begin

           Result:=False;

         end;

      end;

  4. Сохраните изменения.

Настройка параметров станции

  1. Перейдите в раздел Настройки → Параметры работы станции → Редактирование заказа → Расчет/Оплата заказа;

  2. Для параметра Оплата платежной картой установите значение Спрашивать.

Настройки в Shelter Cloud

  • В системе Shelter CLOUD должен быть предварительно создан и активирован Тип оплаты, соответствующий валюте, созданной в R_Keeper. Связка происходит по коду.

  • Убедитесь, что токен отеля корректно введен в конфигурации Farcards.

Действия с бронированием

Закрытие на номер

  1. В R_Keeper 7 при оплате заказа выберите созданную валюту, например, Закрытие на номер в Shelter;

  2. Введите номер бронирования;

  3. Подтвердите оплату.

Результат: В соответствующем бронировании в Shelter CLOUD появятся начисления за покупки.

Возврат

  1. В R_Keeper 7 перейдите в раздел Операции → Закрытые чеки;

  2. Выберите чек, который необходимо отменить;

  3. Нажмите Удалить и подтвердите действие, указав, нужно ли списывать продукцию с кухни.

Результат: Чек будет аннулирован, а соответствующие начисления в бронировании Shelter CLOUD — автоматически удалены.

Возможные проблемы и их решение

Проблема: Ошибка при закрытии на номер.

Описание ошибки:

  • На кассе: Некорректный код Карты ПДС;

  • В логе Farcards: |Error| Init: After parsing a value an unexpected character was encountered: ". Path 'AllowedPaymentCode', line 7, position 2.

Решение:

  1. Проверьте файл appsettings.json на наличие ошибок:

    • Убедитесь, что значение параметра AllowedPaymentCode в точности совпадает с кодом валюты в R_Keeper, созданной для закрытия на номер;

    • Проверьте синтаксис JSON-файла (наличие всех кавычек, запятых, отсутствие лишних символов). Частая ошибка — пропущена запятая после значения параметра.

         
Содержание