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

Обновление плагина 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 с нулём.

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

Для работы с дополнительным бонусным счётом:

Сделать копию текущей бонусной валюты MCRM (со всеми настройками).
Для новой валюты в группе «Интерфейс» установить:

Код транзакции — 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 передаются).

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