Меркурий-ИИ

Дисконтная программа

Касса и прайс

Чтобы касса Mercury-POS могла работать с дисконтной программой, ей нужны специальные параметры: идентификатор магазина и секрет API. Меркурий добавляет их в прайс автоматически при выгрузке, поэтому вручную заполнять поля дисконта в карточке кассы не требуется. В этой инструкции разберём, откуда берутся параметры, как они попадают на кассу и что нужно сделать после включения программы.

Важно понимать общую схему: настройки дисконтной программы хранятся в Меркурии, а касса получает необходимые данные вместе с прайсом. Поэтому включить программу в ERP недостаточно — после изменения настроек нужно заново отправить прайс на кассы.

Как настройки попадают на кассу

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

Весь процесс состоит из трёх основных этапов:

  1. Включите дисконтную программу в Меркурии. Откройте настройки программы, задайте необходимые параметры и сохраните изменения. Если программа уже включена, повторно выполнять этот шаг не нужно.
  2. Отправьте прайс на кассы. При формировании прайса Меркурий автоматически добавит в него параметры дисконтной программы. Они будут включены для каждого склада.
  3. Используйте дисконт на кассе. После получения прайса Mercury-POS сможет работать с дисконтной программой: распознавать покупателя по QR-коду или карте бота, получать информацию о бонусном балансе и выполнять предусмотренные операции начисления и списания.

Таким образом, если вы включили программу или изменили её настройки, не забудьте повторно отправить прайс. Иначе касса может продолжить работать с ранее полученными параметрами.

Подробная инструкция по включению и настройке программы: «Включение дисконтной программы».

Что посмотреть на вкладке «Программа»

Откройте Розница → Дисконтная программа → Программа. На этой вкладке находятся основные параметры программы, в том числе данные, которые затем передаются в кассовый прайс.

Код магазина

В шапке вкладки отображается «Код магазина». Это числовой идентификатор магазина в системе дисконтной программы.

При выгрузке прайса значение передаётся в параметр skidkabot_vendorid. Касса использует его для идентификации магазина при обращении к API дисконтной программы.

Секрет API

В нижней части блока программы находится «Секрет API». Это служебное значение, необходимое для взаимодействия кассы с API Меркурия.

При выгрузке прайса секрет передаётся в параметр skidkabot_vendorsecret. Не публикуйте его и не передавайте посторонним: это не обычная настройка для покупателя, а данные для программного взаимодействия.

Программа действует на все склады

Дисконтная программа не привязывается к одному выбранному складу. Отдельно выбирать склад в её настройках не требуется.

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

Не ищите поля дисконта в карточке склада или кассы. Источник настроек — вкладка «Программа». Кассы получают эти данные вместе с прайсом.

Какие параметры добавляются в прайс

При включённой дисконтной программе в файл прайса дополнительно записываются служебные параметры. Они находятся в базе прайса SQLite, в таблице bd_params.

Передаются три значения:

Эти параметры добавляются автоматически. Пользователю не нужно вручную создавать записи в bd_params, редактировать SQLite-файл или переносить значения из настроек программы в прайс.

Полное описание формирования и отправки кассового прайса находится в разделе «Выгрузка прайса → Дисконтная программа на кассе».

Как отправить прайс на Mercury-POS

Отправка выполняется в форме «Кассы Mercury-POS». Откройте список касс и найдите нужное устройство.

Отправка на одну кассу

Если требуется обновить только одну кассу, воспользуйтесь действием отправки прайса для соответствующей кассы. Меркурий сформирует прайс с актуальными параметрами и передаст его выбранному устройству.

Отправка на все кассы

Если нужно обновить несколько касс, можно воспользоваться действием «Отправить всем прайс» на панели инструментов, если оно доступно в вашей форме.

Это удобно после включения дисконтной программы или изменения её общих настроек: не придётся отдельно открывать каждую кассу и запускать отправку.

Нужно ли заполнять настройки дисконта в карточке кассы?

Нет. Поля дисконтной программы в карточке кассы вручную не заполняются. Код магазина, секрет API и базовый адрес API Меркурия добавляются в прайс автоматически.

Ваша задача — убедиться, что программа включена и сохранена, а затем отправить актуальный прайс на нужные кассы.

Подробная инструкция по работе с формой: «Кассы Mercury-POS».

Если вы не используете Mercury-POS

Для работы с дисконтной программой не обязательно устанавливать Mercury-POS. Если продавец использует телефон, можно воспользоваться веб-кассой.

Веб-касса открывается на телефоне продавца и позволяет работать с покупателями и бонусами без отдельного кассового приложения Mercury-POS.

Инструкция: «Веб-касса».

Если касса не получила настройки дисконта

Если дисконтная программа включена в Меркурии, но касса не может с ней работать, проверьте последовательность действий.

  1. Убедитесь, что программа включена. Откройте вкладку «Программа» и проверьте состояние дисконтной программы.
  2. Сохраните настройки. Если вы только что включили программу или изменили её параметры, убедитесь, что изменения сохранены.
  3. Повторно отправьте прайс. Именно при выгрузке в прайс добавляются параметры дисконтной программы. Старый прайс может не содержать актуальных значений.
  4. Проверьте, на какую кассу отправлен прайс. Если устройств несколько, убедитесь, что обновление отправлено на нужную кассу. При необходимости воспользуйтесь командой «Отправить всем прайс».
  5. Проверьте подключение кассы. Устройство должно получить новую версию прайса, а не продолжать работать с прежними данными.

Если после повторной отправки прайса проблема сохраняется, проверьте сообщение об ошибке на кассе и состояние её подключения. Не пытайтесь исправлять параметры вручную в файле прайса: сначала убедитесь, что выгрузка выполнена из актуальных настроек Меркурия.