Интеграция

Описание различных способов интеграции с системой

Сценарии интеграции с использованием API

Сценарии интеграции

Интеграция с Frontol 5.х/6.х

Состав установочного пакета
Установка
Настройка кассового ПО Frontol
Утилита настройки сценария
Сценарии работы кассира
Релизы библиотеки

Интеграция с 1С:Розница/УНФ Редакция 3

Состав установочного пакета
Установка
Настройка кассового ПО
Сценарии работы кассира
Релизы библиотеки

Интеграция с УТ 11.4.13.209

Ручные скидки

Интеграция с Альфа-авто 6.0.37.13

Синхронизация клиентов сул - альфа авто и наоборот
Как берется склад в чеке на оплату

Интеграция с Битрикс24

Модуль СУЛ для Битрикс24

Сценарии интеграции с использованием API

Рекомендации по прямой интеграции через REST-протокол

Сценарии интеграции с использованием API

Сценарии интеграции

Что здесь описано?

Документ описывает основные сценарии взаимодействия Кассового ПО и Сервиса лояльности. В нем собраны рекомендации о последовательности вызовов методов API сервиса лояльности. Под сценарием понимается рекомендуемая последовательность запросов к сервису И логики работы Кассового ПО, для получения определенного результата(например, продажа, возврат, начисление бонусов при продаже, выдача подарков и т.д.).

Чего здесь нет?

Документ НЕ содержит спецификацию запросов API, для ознакомления со спецификацией можно обратиться сюда:

Общие положения

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

Аутентификация

Перед исполнением защищенных запросов Кассовое ПО выполняет сценарий аутентификации пользователя.

Идентификация участника программы лояльности

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

Идентификация может выполняться по разным фильтрам: - "by_phone" - "by_email" - "by_barcode" - "by_code" - "by_name"

Фильтры применяются к атрибутам карты по полному соответствию

При необходимости получить профиль пользователя по карте, кассовое по выполняет дополнительный запрос
Нужно учитывать, что карт у пользователя может быть несколько

Расчет скидок

Расчет скидок может осуществляться интерактивно или по требованию.
Расчет по требованию позволяет отразить актуальное состояние скидок на момент последнего вызова функции расчета и применения скидок
Интерактивный расчет позволяет синхронизировать состояние кассы с примененными скидками "на лету"

Применение скидок

Процесс применения скидок можно поделить на несколько этапов:

Применение суммовых и процентных скидок

Соответствие между строками в ответе сервиса и корзине документа устанавливается Кассовым ПО путем передачи поля line_number. Таким образом один и тот же товар может передаваться разными строками
Кассовое ПО ищет в ответе строки соответствующие строкам корзины и применяет рассчитанные скидки.

Выдача подарков

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

Оплата баллами

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

Фиксация факта продажи

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

Использование сертификатов

Для использования покупателем сертификат требует предварительной реализации
Гашение сертификата происходит в момент фиксации продажи с указанием оплаты этим сертификатом

Продажа сертификата

Реализация сертификатов выполняется с помощью процесса продажи, как продажа обычного товара
При фиксации продажи передается специальный объект cert_sales, содержащий массив продаваемых сертификатов

Оплата сертификатом

Клиентское приложение должно проверить возможность гашения сертификата введенной пользователем суммой

Использование промокодов

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

Интеграция с Frontol 5.х/6.х

Инструкции и описания процесса интеграции с кассовым ПО Фронтол

Интеграция с Frontol 5.х/6.х

Состав установочного пакета

Структура каталогов библиотеки

components – содержит внешние по отношению к сценариям платформы FRONTOL объекты, необходимые для корректной работы интеграции.
frontol_ui – содержит макеты экранных форм интерфейса кассира, используемые в качестве примера интеграции.
src – содержит код сценариев на языке JScript, реализующих логику работы кассового места.
doc – содержит документацию по библиотеке интеграции.

Active-X компоненты

AXStrDialog.ocx – компонент выполненный по технологии ActiveX, реализующий окно ввода/вывода произвольных значений в пользовательском интерфейсе.

Макеты интерфейса

Макет рассчета.lt – макет используемый кассиром при вводе оплаты чека от покупателя.
Макет регистрации продаж.lt – макет основного экрана оформления документов.

Сценарии

main.js – основной сценарий, загружаемый при начале работы кассира.
print.js – сценарий, содержащий функцию вывода информации о бонусных баллах в чек. Не используется как самостоятельный сценарий.

Документация

Инструкция по интеграции.docx – инструкция по интеграции библиотеки.

Утилита настройки

dist\settings.exe - утилита настройки сценария кассового места.

Интеграция с Frontol 5.х/6.х

Установка

Установка с помощью инсталлятора

Установка компонент библиотеки выполняется путем запуска инсталлятора нужной версии.

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

При установке пакета регистрируются ActiveX компоненты Windows, поэтому установку нужно выполнять от имени Администратора системы

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

Также возможно установить ActiveX компонент отдельно. Для этого необходимо расположить файл(ocx в каталоге установки) в любом каталоге и выполнить команду операционной системы от имени администратора:

regsvr32 <ПутьКФайлуКомпонента>

После чего компонент становится доступен по имени AXStrDialog.RTestX

Интеграция с Frontol 5.х/6.х

Настройка кассового ПО Frontol

Загрузка основного сценария

Код основанного сценария работы кассового места содержится в файле main.js. Для загрузки сценария и установки его как основного необходимо запустить утилиту «Frontol Администратор», открыть базу, для которой предполагается установить сценарий. Далее перейти в раздел «Скидки и сценарии», создать новый сценарий, открыть файл main.js с диска или скопировать содержимое файла в открытый сценарий:

Для корректной работы сценария, необходимо установить значения переменных в заголовке файла установить значения переменным в начале в заголовке файла:

Имя переменной	Описание
bsServer	Адрес процессингового сервера. Доступные сервера: https://demo.bonus.rarus-online.com:88/ - Тестовый сервер; https://bonus.rarus-online.com:88/ - Боевой сервер;
bsUser	Имя пользователя сервиса, полученное при регистрации
bsPassword	Пароль пользователя сервиса, полученный при регистрации. Для безопасности пароль не вводится в открытом виде, нужно ввести шестнадцатеричное значение хеш-функции от значения пароля. Вычислить такое значение можно, например, на сайте http://www.sha1-online.com/
bsShopID	Уникальный идентификатор магазина, используется для аналитики продаж
bsKKTID	Уникальный идентификатор кассы
bsKKTName	Наименование кассы
bsCodeCertificatePosition	Код товара, который используется при продаже сертификатов
bsCodeCertificatePayment	Код вида оплаты, который используется при оплате чека сертификатом
bsClientNameInputType	Тип ввода имени клиента. Доступны значения: OneInput – одно поле для Фамилии, Имени и Отчества. ThreeInputs – для указания Фамилии, Имени и Отчества используются разные поля. var bsLogLevel = 'off';
bsLogLevel	Уровень журналирования. Доступны значения `error`, `info`, `debug`, `off`. Каждый последующий уровень журналирования включает в себя предыдущий. Например, при указании уровня `debug` в файлы журналов будут выводиться сообщения с уровнями `error` и `info`. `off` - полностью отключает журналирование
bsLogRootPath	Корневой каталог, в который будут сохраняться файлы журнала. В этом каталоге автоматически создаются отдельные подкаталоги с файлами журнала. Каждый файл содержит информацию за один час работы системы. В качестве разделителя пути к каталогу необходимо использовать двойной обратный слэш(\\) в конце пути также необходимо наличие \\
bsPendingDocQueue	Корневой каталог, в который будут сохраняться файлы с информацией о документах, которые не удалось отправить на обработку в сервис по причине плохого соединения с сервисом. Такие документы будут повторно отправляться при старте системы. В качестве разделителя пути к каталогу необходимо использовать двойной обратный слэш(\\) в конце пути также необходимо наличие \\
bsBarcodeInputSequence	Последовательность клавиш вызова окна ввода штрихкода карты. Если значение не указано, после поиска карты по штрихкоду/телефону не будет выполняться подстановка штрихкода карты в документ. Значение должно совпадать с назначенной в системе для этого действия комбинацией клавиш
bsCardTypeCodes	Коды видов карт бонусного сервиса. Проверка наличия карт в сервисе будет выполняться только для карт подходящих под условия указанных видов.

После настройки можно сохранить сценарий и выбрать его в качестве основного в поле «В начале сеанса запускать».

Более простым способом настройки будет использование утилиты настройки. Она запускается по-умолчанию после установки новой версии скрипта.

Настройка бонусных скидок и оплаты бонусными баллами

Для корректного применения рассчитанных процессингом скидок и оплаты бонусными баллами необходимо настроить маркетинговую акцию. Для этого нужно перейти в раздел «Скидки и сценарии» -> «Маркетинговые акции» и создать новую скидку:

Для скидки устанавливается признак «Срабатывает всегда».

После, нужно указать два мероприятия «Оплата» и «Скидка», которые отражают логику применения оплаты бонусными баллами и скидок соответственно к документу:

Каждое мероприятие должно иметь тип «Автоматическая скидка из сценария», не иметь модуля условий(т.е. быть безусловными). На каждую скидку назначается функция расчета из загруженного ранее скрипта.

Для мероприятия «Скидка», указываются следующие настройки и функция

 ApplySumDiscountToPosition('rarusBonus')

Для мероприятия «Оплата», указываются следующие настройки и функция

 ApplyBonusPaymentToPosition()

Идентификация карт

Считывание бонусных карт выполняется типовой командой платформы FRONTOL. Для корректной интеграции необходимо определиться с префиксами штрихкодов бонусных карт и в разделе «Скидки и наценки» -> «Виды карт» создать один или несколько видов карт соответствующий диапазонам:

Такие карты НЕ будут регистрироваться в системе FRONTOL определение будет выполняться на процессинге, поэтому необходимо установить признак «Использовать для незарегистрированных карт»

Обязательно в сценарии настроить значение кодов видов карт в переменной bsCardTypeCodes. Коды не внесенные в массив будут работать по логике Frontol и не будут проверяться на сервисе управления лояльностью.

Дополнительные функции и значения

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

Состав команд:

Регистрация нового пользователя бонусного сервиса
Привязка новой карты к пользователю бонусного сервиса
Расчет скидок на процессинге с применением к текущему документу
Ввод оплаты бонусными баллами
Отмена рассчитанных скидок и оплаты баллами
Поиск карты пользователя бонусного сервиса по номеру телефона
Сброс дисконтной карты пользователя
Поиск промо-кода бонусного сервиса
Очистка промо-кода бонусного сервиса
Продажа подарочного сертификата бонусного сервиса
Отмена продажи подарочного сертификата бонусного сервиса
Оплата документа подарочным сертификатом бонусного сервиса

Команды реализованы в виде функций глобальном контексте основного сценария:

function RegisterNewCustomer()
function AttachCard()
function CalculateDiscounts(interactive)
function EnterBonusPayment()
function ClearAllDiscounts(interactive)
function SearchCardByPhone()
function ClearCard(interactive)
function SearchCoupon()
function ClearCoupon(interactive)
function AddCertificate()
function DeleteCertificate()
function EnterCertificatePayment()

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

Для функций у которых есть параметр interactive необходимо при назначении функции на кнопку/горячую клавишу в параметрах передавать true, без этого параметра не будут выводится сообщения о возникающих ошибках.

Настройка производится в разделе «Настройки» -> «Макеты экрана» и «Настройки» -> «Раскладки».

Для назначения функции на кнопку интерфейса пользователя необходимо в макете экрана выбрать элемент типа кнопка и указать в качестве действия значение Специальные/Сценарий и в качестве параметра указать имя функции.

Для назначения функции на горячую клавишу необходимо проделать аналогичные действия:

Также основной сценарий предоставляет набор переменных, значение которых можно отобразить в интерфейсе пользователя.

Состав доступных переменных:

rarusBonusPayment – Количество бонусных баллов, которыми оплачен документ.
rarusBarcode – Штрихкод считанной и идентифицированной процессингом карты.
rarusUserName – Имя пользователя сервиса, связанного с картой.
rarusCardEntered – признак того, что введена карта клиента..

Настройка вывода этих значений выполняется в конструкторе макета экранной формы «Настройки» -> «Макеты экрана». Для вывода используется элемент с типом «Информация», в качестве текста необходимо выбрать «Текущий документ \ Пользовательская переменная», в качестве значения имя переменной. Например:

Подарочные сертификаты

Для корректной продажи подарочных сертификатов бонусного сервиса необходимо настроить товар. Для этого нужно перейти в раздел «Справочники» -> «Товары» и создать новый товар:

Необходимо указать уникальный код товара и установить признак предмета расчета в значение «Аванс, предоплата». Указанный код товара необходимо ввести в сценарии в переменную bsCodeCertificatePosition.

Для того чтобы была возможность продавать данный товар необходимо в карточке товара на вкладке «Разрезы/цены/остатки» необходимо ввести остатки и цены на товар. Остатки можно указать нулевыми, цена должна быть не нулевой.

На вкладке «Контроль» необходимо снять галки у следующих опций «Списание остатков»,

Для того чтобы отрабатывали опции заданные в карточке товара необходимо в разделе «Справочники» -> «Глобальный контроль» установить у опций «Списание остатков», «Запрос цены», «Скидки» и «Редактирование цены» значение «Товар».

Для возможности оплаты подарочным сертификатом необходимо в разделе «Системные справочники» -> группа «Оплаты» -> «Виды» создать новый вид оплаты.

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

Возврат оплаты подарочными сертификатами возможен только наличными поэтому необходимо установить опцию «Разрешить возврат наличными»

Вывод дополнительных свойств пользователя в интерфейсе кассы

Решение позволяет выводить значения дополнительных свойств пользователя, созданных в личном кабинете системы управления лояльностью, в интерфейсе кассового ПО Фронтол.

Для того чтобы настроить вывод необходимо в редакторе макета экрана добавить поле с типом "Информация" и установить значение из пользовательской переменной документа.

Подробно о редактировании макетов экрана можно узнать из руководства администратора, поставляемого с кассовым ПО Фронтол

В качестве имени переменной нужно использовать следующий шаблон user_prop_<Идентификатор свойства>. Идентификатор свойства можно получить и указать в личном кабинете системы управления лояльностью.

Интеграция с Frontol 5.х/6.х

Утилита настройки сценария

ВНИМАНИЕ! Утилита не поддерживает работу под ОС Windows 8.1 и ниже. Если вы используете более младшие версии Windows, редактировать файл конфигурации придется вручную

Утилита поставляется в установочном пакете, начиная с версии 1.0.12х. Она будет автоматически запускаться после окончания установки дистрибутива. Так же, ее можно открыть вручную, она располагается в установленном дистрибутиве в каталоге dist/settings.exe.

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

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

Для первоначальной настройки утилиты необходимо подключиться к базе кассы Frontol. Для этого нужно указать файл базы, задать логин и пароль базы. В качестве логина и пароля по-умолчанию используются значения sysdba и masterkey, соответственно.

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

Также, после подключения к базе кассы возможно автоматическое обновление сценария внутри базы из файла main.js входящего в поставку.

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

Для обновления, нужно выбрать файл из которого будет получено тело нового сценария и нажать на кнопку "Обновить сценарий из файла".

По-умолчанию выбран файл из поставки, установленный в директорию по-умолчанию.

Настройка кассы

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

Утилита позволяет выбрать значения из базы Frontol или указать вручную некоторые значения настроек, после чего сохранить указанные настройки в файл, который в свою очередь будет прочитан кассой. Все значения указанные в конфигурационном файле, будут заменены перед началом работы кассы, если какая-то из настроек не указана в файле, будет использоваться значение из сценария.

Файл сценария по-умолчанию располагается в каталоге C:\ProgramData\1CRarus\Frontol\config.js.json. Имена настроек в файле совпадают с именами переменных в сценарии.

Файл создается при сохранении текущего состояния настроек в этой утилите. Для того чтобы касса применила настройки, необходим перезапуск сеанса работы кассы.

Интеграция с Frontol 5.х/6.х

Сценарии работы кассира

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

Подробно процесс назначения команд описан в руководстве интегратора системы FRONTOL

Регистрация покупателя на процессинге

Функция регистрации нового покупателя доступна в любой момент из интерфейса кассира:

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

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

Считывание карты

Для считывания карты пользователя необходимо воспользоваться стандартной командной ввода карты(по-умолчанию CTRL+F7) и ввести штрихкод карты вручную или считать с помощью устройства ввода.

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

Расчет скидок на процессинге

Библиотека интеграции предоставляет возможность выполнять пред расчёт скидок в ручном режиме, до перехода к оплате чека, автоматически рассчитывает скидки при переходе в режим оплаты

Предварительный расчет

Предварительный расчет скидок может понадобиться для оценки сработавших скидок и озвучивания суммы скидки покупателю. Для предварительного расчета можно воспользоваться командой «Рассчитать»:

После выполнения команды сумма документа изменится на значение рассчитанное по правилам настроенным в личном кабинете.

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

Для корректной работы считывания необходимо настроить специальный вид карт

Автоматический расчет

Автоматический расчет выполняется при переходе в режим ввода оплаты документа. Никаких дополнительных настроек для выполнения автоматического расчета выполнять не нужно. Механизм расчета полностью аналогичен предварительному расчету.

Оплата бонусными баллами

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

Команда оплаты бонусными баллами применяется к документу с уже рассчитанными ручными и автоматическими скидками. Вызов команды можно осуществить как из экрана редактирования документа:

Также использовать бонусные баллы можно в режиме оплаты:

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

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

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

Оплата бонусными баллами применяется к документу как автоматическая скидка и суммируется с уже примененными к документу скидками.

Отмена оплаты и скидок выполняется специальной командой «Очистить». При выполнении команды система удаляет всю информацию о примененных скидках(в т. ч. оплату бонусными баллами).

Возврат товара

Возврат товара осуществляется стандартной командой оформления документа возврата на основании документа продажи. При оформлении возврата в документе автоматически устанавливается карта использованная при продаже.

Бонусные баллы, использованные в качестве оплаты чека продажи и начисленные на карту по правилам начисления(настраивается в личном кабинете), будут возвращены и списаны с карты соответственно. В случае частичного возврата, система пересчитывает возвращаемые/списываемые баллы пропорционально сумме возврата относительно суммы продажи-основания.

Интеграция с Frontol 5.х/6.х

Релизы библиотеки

Версия 1.1.152

Исправлена ошибка добавления нескольких сертификатов

Версия 1.1.145

Исправлена ошибка, при которой сертификаты не передавались на сервер в составе таблицы товаров
Исправлена ошибка в работе параметров автоматического понижения и повышения уровней
Добавлена возможность указания настроек во внешнем файле, без изменения сценария

Версия 1.1.96

Добавлены настройки включающие и выключающие автоматическое повышение/понижение уровня карт при продаже

Версия 1.1.93

Добавлена возможность вывода значений дополнительных свойств в интерфейсе кассира

Версия 1.1.83

Исправлена ошибка, при которой карта не подставляется в документ, в случае таймаута при перерасчете скидок
Исправлена ошибка, при которой документ отправлялся на сервис только отложено
Исправлена ошибка, при которой выводится пустое сообщение, в случае потери соединения с сервисом

Версия 1.1.79

Исправлена ошибка подбора временно заблокированной карты по номеру телефона, если она единственная у пользователя

Версия 1.1.76

Добавлена возможность работы с несколькими Видами карт. Теперь можно явно указать какие виды карт относятся к бонусной программе системы управления лояльности, а какие будут обрабатываться стандартными механизмами платформы Frontol. Система не будет пытаться искать такие карты в сервисе
Добавлены сообщения клиенту при подборе временно заблокированных и ограниченных для списания или начисления карт
Обновлен формат документации, входящей в поставку

В этой версии добавлена новая переменная bsCardTypeCodes в заголовке сценария, обязательно её заполнение!

Версия 1.1.60

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

Версия 1.0.45

Исправлен некорректный расчет локального времени кассы

Версия 1.0.44

Теперь документ удаляется из очереди неотправленных документов, если сервер не принял его
Изменена функция расчета doc_id, используется новая hash-функция
Команда сборки пакета добавлена в доступные npm команды
Добавлена автосборка и развертывание
Добавлены проверки блокировки карты перед пробитием и проброс исключения HTTP
Добавлена группировка типов оплаты
Исправлена ошибка передачи некорректного магазина

Интеграция с 1С:Розница/УНФ Редакция 3

Состав установочного пакета

Файл расширения 1Cv8.cfe находится в подкаталоге tmplts\Rarus\Loyalty\Retail\1_0_Х_Х\ каталога установки 1С:Предприятия 8.

Интеграция с 1С:Розница/УНФ Редакция 3

Установка

Интеграция с 1С:Розница/УНФ Редакция 3

Настройка кассового ПО

Интеграция с 1С:Розница/УНФ Редакция 3

Сценарии работы кассира

Интеграция с 1С:Розница/УНФ Редакция 3

Релизы библиотеки

Интеграция с УТ 11.4.13.209

Ручные скидки

Сами ручные скидки задаются в УЛК на страничке со скидкой. У типов скидки "Применить абсолютную скидку" и "Применить относительную скидку" есть флажок "Ручная скидка". Если он включен, то скидка становится ручной.

Ручная скидка не будет назначена при расчете автоматических скидок. Ее можно будет применить, воспользовавшись специальной кнопкой на форме рмк. За применение ручных скидок отвечает кнопка "Применение ручных скидок СУЛ", а за отмену "Отмена ручных скидок СУЛ".

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

Для переноса выбранных скидок необходимо нажать на кнопку "Перенести выбранные скидки в документ". После произойдет расчет скидок.

Для отмены примененных скидок нужно нажать "Отмена ручных скидок СУЛ". Откроется форма, аналогичная форме подбора скидок, только на ней выбираются примененные к чеку скидки, которые необходимо отменить.

Для удаления выбранных скидок из чека нужно нажать "Удалить выбранные скидки из документа". Форма закроется и скидки будут пересчитаны.

Интеграция с Альфа-авто 6.0.37.13

Синхронизация клиентов сул - альфа авто и наоборот

1. Отправка клиента из альфа авто в сул:

- Необходимо перейти "Автосервис" - Контрагенты и контракты, а затем открыть существующего или создать нового контрагента (в данном случае рассмотрен пример создания нового).

Рисунок 1

- Для контрагента с типом "Частное лицо" появилась возможность отправки в сул. Для этого необходимо поставить флажок "Клиент дал согласие на участие в бонусной программе СУЛ"

Рисунок 2

- В СУЛ есть настройка "Логин клиента". В зависимости от этой настройки будет устанавлен логин в сул для пользователя при отправке.

Рисунок 3

- Для этого на вкладке контактная информация необходимо заполнить Телефон/Почту. В случае если она не будет заполнена выпадет ошибка при записи. Элемент записан не будет.

Рисунок 4

Рисунок 5

Рисунок 6

- В случае если все заполнено корректно контрагент будет отправлен в сул.

Рисунок 7

Рисунок 8

2. Создание контрагента в альфа авто из сул:

При поиске карты находится пользователь сул. По полю, по которому его искали в сул (почта или телефон) он будет искаться в альфе (по нашим служебным полям). Если клиента в альфе нету, то он будет создан.

Рисунок 9

Рисунок 10

Рисунок 11

Интеграция с Альфа-авто 6.0.37.13

Как берется склад в чеке на оплату

При пробитии чека на оплату склад берется из кассы ккм (фото 1).

Рисунок 1

Если у кассы ккм не заполнен склад, то при формировании чека на оплату будет выведено сообщение (рисунок 2)

Рисунок 2

Интеграция с Битрикс24

Модуль СУЛ для Битрикс24

https://drive.google.com/drive/folders/1hlsDNX3_-ZP8m2zlKKLETIBRDGF52qa-