База знаний MCRM

Обновление интеграции для r_keeper

Обновление плагина FarCards MCRM для r_keeper

Данные обновления рекомендуются всем клиентам на r_keeper.

Разделы, помеченные значком ⚠️, предназначены к выполнению только профильным специалистом (интегратор r_keeper / MCRM).
Актуальную версию плагина можно скачать на странице инструкции по настройке r_keeper
При обновлении с более ранних версий рекомендуется перезапускать кассовый сервер r_keeper.

3.18.1

Чек намерения: режим «None»
Тип чека намерения = None теперь интерпретируется как отключённый чек намерения. В этом случае транзакции отправляются по факту оплаты заказа — как при классической схеме без ЧН.

3.18.0

Подтверждение менеджера при авторизации карты
Добавлена возможность требовать подтверждение менеджера при авторизации карты гостя.
Новый параметр в mcrm.ini, секция [MCRM]:
RequireManagerApprovement=1
0 — выключено (по умолчанию), 1 — включено.

3.17.1

Чек намерения: транзакция при подтверждении оплаты
При использовании чека намерения транзакция отправляется только при подтверждении оплаты кассиром на кассе.

3.17

Автоопределение режима работы с чеком намерения
DLL автоматически определяет режим работы — новые параметры в mcrm.ini не добавлялись.
Если чек намерения (ЧН) выключен:
  • всё работает по-старому;
  • транзакция уходит при закрытии чека;
  • возврат — при аннулировании или удалении чека.
Если ЧН включён (один чек или кредит):
  • транзакция уходит только когда кассир подтверждает оплату на кассе;
  • возврат выполняется только при аннулировании/удалении уже закрытого чека;
  • коррекции оплаты и состава заказа выполняются без ошибок (может потребоваться переавторизация карты, если в заказе что-то реально изменилось).

3.16.0

Изменение логики SMS-подтверждения

Ранее подтверждение по SMS вызывалось перед оплатой, и после ввода кода сразу отправлялся запрос /cash/order.
Теперь при печати фискального чека до оплаты подтверждение по SMS срабатывает сразу, и плагин отправляет /cash/order с нулём.

⚠️ Настройка валют для доп. счетов и сертификатов

Для работы с дополнительным бонусным счётом:
  1. Сделать копию текущей бонусной валюты MCRM (со всеми настройками).
  2. Для новой валюты в группе «Интерфейс» установить:
  • Код транзакции — 6
  • Субсчет FarCards — 2
Оплата сертификатами как отдельной валютой:
Используется тот же механизм, что и с субсчетами. Для валюты субсчёта код транзакции должен быть 6 (никакой другой).
Валюту для сертификатов настраиваем аналогично субсчетам, но с параметрами:
  • Субсчет FarCards — 3
  • Код транзакции — 8
При чекине баланс отображаться не будет. Проверять нужно в режиме оплаты — подтянулся ли баланс к валюте.

3.15.0

В запросе /cash/order теперь передаются поля:
  • type_pay — формат оплаты: card / cash / combo
  • table_number — номер/название столика (str или null)
Особенности table_number: значение берётся из поля tablename заказа (название столика в r_keeper). Может быть произвольной строкой до пяти символов или отсутствовать (null). Уникальность названий гарантируется только в рамках одного зала, но данные о зале в заказе отсутствуют — например, стол «1» может быть в двух разных залах, но отличить их нельзя.

3.14.0

Доработана передача данных о скидках r_keeper по каждой позиции заказа в запросах:
  • /cash/maxspendbonus
  • /cash/checkpromocode
  • /cash/order
Что изменилось:
  • items.price для подарков по промокоду теперь передаётся как 0
  • в элементы массива items добавлены три новых поля:
  • is_discount (bool) — true, если к товару применены не MCRM-скидки (товар — не подарок, и скидка не передана из MCRM)
  • discount_sum (integer) — сумма всех действующих на товар скидок (удовлетворяющих is_discount) в копейках
  • discount_id (integer или null) — код скидки из r_keeper (первой попавшейся, удовлетворяющей is_discount). null, если скидок на товар нет

3.13.0

Авторизация карты в пустом заказе
В секцию [MCRM] добавлен параметр AllowAuthInEmptyOrder — разрешать авторизацию карты в пустом заказе.
  • 1 — да
  • 0 — нет (по умолчанию)
Пример в mcrm.ini:
AllowAuthInEmptyOrder=1

3.12.0

  • Добавлена поддержка чека намерения
  • Потенциально исправляет ошибку «Персональное ограничение для ...»

3.11.0

Типы транзакций MCRM по категории заказа
В соответствии с конфигурацией для указанных типов заказа при закрытии теперь передаётся тип транзакции MCRM.
Новая секция в mcrm.ini:
[TRANSACTIONTYPES]
; ключ - код категории заказа из r_keeper
; значение - тип транзакции, который будет передан в MCRM
; при отсутствии категории заказа или всей секции поле type не передаётся
1=4
2=3

3.10.1 – 3.10.2

Параметр BonusAsDiscount
Это код скидки, которую нужно применить, если max_spend > 0.
Необходимо настроить для скидки 100% детализацию, затем указать код этой скидки в качестве значения для BonusAsDiscount.
Не будет ошибкой, если указать одну и ту же скидку в оба параметра. Пример:
[DISCOUNTS]
ZeroDiscountCode=5
BonusAsDiscount=5

3.10.0

Передача discount_code в заказе
  • Если в заказе нет скидок — поле discount_code не включается в запрос
  • Если в заказе использована скидка — в запрос /cash/order передаётся поле discount_code с кодом применённой скидки

3.9.0

Управление передачей телефона и email гостя
Добавлена возможность отключить передачу телефона и/или email гостя в свойства заказа при авторизации.
В mcrm.ini, секция [MCRM]:
  • PassGuestPhoneOnAuth — 0 или 1
  • PassGuestEmailOnAuth — 0 или 1
По умолчанию параметры включены (если не указаны — телефон и email передаются).
2026-06-01 19:10 Инструкции