В данной статье описаны улучшения новой версии системы Loymax.

Основные изменения версии касаются оптимизаций, общих улучшений Системы, а также исправления ошибок:

• перечень оптимизаций в версии Системы;
• изменения в методах API в версии Системы;
• версии пакета обновлений в рамках версии Системы lmxR4 (2022.2) с кратким описанием внесенных изменений.

Общие изменения

Магазины переименованы в Торговые точки

Теперь раздел АРМ Партнёры > Список магазинов переименован в Список торговых точек. 

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

К торговым точкам могут относится:

• продуктовые магазины,
• специализированные магазины,
• бутики,
• аптеки,
• супермаркеты, 
• гипермаркеты,
• кафе и т. д.

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

Увеличен период времени, за который Участник увидит в ЛК дату сгорания бонусов Точное время сгорания бонусов в Личном кабинете (ЛК) Участника ПЛ теперь отображается за шесть недель до сгорания, а не за одну неделю, как было ранее. Например, если Участнику ПЛ 04.05.2022 начислены две суммы бонусов со сроком действия 5 дней и 1 месяц, то в ЛК будут отображаться точные даты сгорания обеих сумм — 09.05.2022 и 04.06.2022, для первой и второй суммы бонусов соответственно.

Возможность для клиентов, не имеющих привязанных карт, управлять своим бонусным счётом  У Участников, зарегистрированных в ПЛ без привязки физической карты и без выпуска виртуальной карты, появилась возможность совершать покупки, накапливать и списывать бонусы и управлять своим бонусным счётом. Для реализации такого кейса, когда при регистрации к Участнику ПЛ не привязываются карты, следует установить определенные значения в настройках конфигурации. При некоторых настройках бонусная карта может быть привязана/выпущена позже, после регистрации. Следует помнить, что в случае, когда в результате регистрации клиента в ПЛ не привязана физическая карта и не выпущена виртуальная карта, то единственной возможностью идентификации клиента на кассе останется номер телефона. Больше не поддерживается работа плагина Эвотор (Evotor) Работа плагина Эвотор для интеграции с КПО больше не поддерживается. Поиск групп товаров осуществляется по неполному совпадению названия При настройке действия Разбиение на наборы в акциях, а также в фильтрах Товар, Наличие товара в чеке, Ограничение на товар (простой и со счётчиком) поиск группы товаров можно осуществить при неполном совпадении введенного в фильтр названия с названием существующей группы товаров. Таким же образом фильтр работает при поиске в разделах АРМ Группы товаров и Персональные товары, а также при поиске любимых товаров через Контакт-центр. Использование любого кассового идентификатора при обращении к методам, обеспечивающим проведение основных операций, связанных с покупками При авторизации через OAuth-приложение в запросе можно передать поля X-Identifier и redirect, которые используются только при обращении к методам публичного API Processing. Округление суммы предоставляемой скидки при расчёте скидки для товара способом расчета Фиксированная цена на единицу товара Округление стоимости при расчёте скидки для товара происходит не по математическим правилам, а в соответствии с законодательством, т. е. в пользу покупателя. Подробнее смотрите здесь. Изменена логика записи информации о кассире в покупке Для сохранения переданной информации о кассире обязательным условием является передача параметра cashier в запросах: через методы для работы с процессингом: расчёт прямой скидки (Calculate) и расчёт бонусов (Bonus); через команды кассового протокола: расчёт прямой скидки (Calculates) и начисление бонусов (Discounts). Удалена функциональность Loymax Lite Функциональность модуля Loymax Lite полностью удалена из Системы. Updated: Увеличение длины названия дополнительного параметра чековой позиции Допустимая длина атрибута Name дополнительного параметра чековой позиции Params увеличена до 50 символов включительно. Улучшения интерфейса Информирование о текущем процессе загрузки Теперь во всех модальных окнах, которые позволяют загружать файлы, при долгой загрузке файла отображается надпись Загрузка, которая исчезает после того, как файл обработан и загружен.   Улучшение формата ввода номера телефона В разделах CRM и Контакт-центр при поиске клиентов изменилось окно ввода номера телефона. Теперь отображается заданный в Системе шаблон для ввода номера и возможность выбора шаблона, если предусмотрено несколько. Добавлена возможность отписать сразу от всех типов подписок В разделах Контакт-центр > Подписки и Карточка клиента > Подписки добавлена кнопка Отключить все, чтобы отписать клиента сразу от всех рассылок или Выбрать все, чтобы подписать на все типы рассылок. Также добавлена возможность добавить/удалить все подписки в рамках конкретных каналов коммуникации. Для этого необходимо поставить/снять галочку в чекбоксе непосредственно под названием соответствующего канала коммуникации. Updated: Добавлена возможность автозаполнения поля Сумма при безналичной оплате При работе с тестовой кассой, если выбран способ оплаты Безналичная оплата, можно устанавливать значение в поле Сумма кликом по гиперссылке в строке Необходимо оплатить. Указанное значение автоматически проставится в поле Сумма. Updated: Добавлены внутренние идентификаторы (Id) для вопросов, групп вопросов, вариантов ответов на вопросы, вариантов статусов Для удобства работы с методами регистрации в разделе АРМ Конструктор анкеты добавлен столбец с указанием внутренних идентификаторов (Id) для вопросов. Внутренний идентификатор отображается также и для групп вопросов (рядом с названием группы). При наличии вариантов ответов на вопросы (для вопросов с типом ответа Выбор строкового значения из нескольких) отображаются внутренние идентификаторы (Id) для каждого варианта ответа. При создании статусной системы отображаются внутренние идентификаторы (Id) для вариантов статусов. Updated: В разделы с историей операций Участников ПЛ добавлены горячие кнопки для фильтрации записей по времени В раздел АРМ CRM > Управление покупками, а также подразделы История покупок и Клиентская история карточек клиента в CRM и Контакт-центре были добавлены горячие кнопки для отображения записей за один из предложенных временных интервалов: За позавчера, Вчера, За сегодня, а также Последний час.   Updated: Расширена функциональность разделов Клиентская история В разделах Клиентская история карточек клиентов в CRM и Контакт-центре теперь отображаются следующие типы подтверждённых операций: Начисление/списание бонусов вручную; Начисление/списание бонусов через акции; Активация/сгорание бонусов; Скидка; Дополнительные бонусы; Оплата денежным сертификатом; Возврат начисленных/списанных бонусов. Также была добавлена кнопка  рядом с операциями, осуществленными в рамках покупок, для просмотра детализированной информации о данной покупке: списка всех операций, товаров, бизнес-активностей и примененных способов оплаты. Данная кнопка доступна пользователям АРМ с правом Пользователь АРМ имеет право просматривать покупки. Удалены плагины Следующие плагины были удалены из Системы: Loymax.SmsTrafficIncomingSmsProcessor, Loymax.Plugins.PurchaseImitator, Loymax.Plugins.SocialNetworks.Devino, Loymax.Plugins.StatusSystem и StatusSystem.ManualChanges, Loymax.Plugins.SftpStatusUpload.

CRM

Новое в разделе Управление покупками

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

Идентификатор, использовавшийся в покупке, отображается также в Истории покупок клиента в Контакт-центре и в карточке клиента в CRM.

Открытие покупки в отдельной вкладке

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

Новое в разделе Клиенты

Updated: В Истории покупок Участника ПЛ вместе с id, временем покупки, кассой, номером чека, торговой точкой и состоянием отображается Сумма с учётом скидок (итоговая сумма всех позиций в чеке покупки). Сумма с учётом скидок также отображается в карточке Участника ПЛ в Контакт-центре и разделе Управление покупками. 

Updated: Состояние клиента теперь отображается рядом с именем на первой странице раздела Клиенты.

Updated: Новое в разделе Целевые аудитории

Добавлен новый параметр целевых аудиторий — Тип аудитории, который определяется способом их создания. Данный параметр позволяет сделать бизнес-аналитику модуля Loymax BI более точной.

Маркетинг

Новое в разделе Акции

Указание логического имени параметра чековой позиции, определяющего МРЦ товара

В действии Установка минимальной цены доступен новый способ расчёта, который позволяет указывать значение параметра чековой позиции, определяющего МРЦ товара. Теперь нет необходимости загружать МРЦ в каталог, т. к. акция сработает и при передаче значения МРЦ самой кассой.

Возможность быстрого выбора значения атрибута в фильтре Торговые точки

Доступна подстрока для поиска по названию конкретного атрибута в фильтре Торговые точки (ранее Магазины).

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

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

Updated: Фильтр Купон по маске удален из событий Завершение покупки и Отмена покупки

Фильтр Купон по маске больше недоступен для действий с событиями Завершение покупки и Отмена покупки.

Updated: Действия Включение и Выключение рассылки были удалены из Системы

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

Updated: Тип акции Персональные предложения более не поддерживается

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

Новое в разделе Счётчики

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

Updated: Изменена логика отмены изменений значений простого счётчика

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

• Отмена покупки: предыдущие изменения отменяются.
• Полный возврат покупки: изменения не отменяются.
• Частичный возврат: изменения не отменяются.
• Отмена расчёта скидки: предыдущие изменения счётчика отменяются.

Новое в разделе Статусные системы

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

Updated: Изменилась логика расчёта статусов Изменилась логика обновления статусов клиентов при использовании методов API для работы со статусами клиентов. Теперь при запросе информации о дате смены статуса Участнику ПЛ в Мобильном приложении возвращается более корректная дата следующего изменения статуса. Логика расчёта базируется на том, что дата изменения статуса соответствует дате запуска регулярной задачи.  Новое в разделе Выпуск купонов Updated: Изменилась логика записи временных периодов при создании выпуска купонов Правила записи временных периодов при создании выпуска купонов теперь регулируются параметром конфигурации UseLocalDateForCoupons: При включенной конфигурации запись даты выдачи купона соответствует дате и времени чека в покупке. В АРМ и ЛК дата активации купона также соответствует дате и времени чека в покупке при выдаче купона. Время жизни купона проверяется путём сравнения даты чека в текущей покупке при применении купона с датой сгорания купона. При выключенной конфигурации запись даты выдачи купона происходит в часовом поясе сервера, приведенному к UTC. Время жизни купона автоматически переводится на часовой пояс Участника ПЛ. В АРМ и ЛК даты активации и сгорания купона отображаются с учётом часового пояса Участника ПЛ.

Панель администратора

Новое в разделе Пользователи

Новое в разделе Выпуск карт

Новый раздел Дополнительные атрибуты для сущностей

Новый фильтр Тип кассы во вкладке Список касс

Во вкладке Список касс в разделе Редактирование партнёра добавлен новый фильтр Тип кассы, который осуществляет поиск по типам касс, предусмотренным в Системе.

Новое поле в окне Создание атрибута

В окне Создание атрибута появилось новое поле Порядковый номер, которое задаёт порядковый номер отображения атрибутов в расширенном поиске клиентов.

Updated: Изменена логика объединения для атрибутов клиента для некоторых типов данных

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

Настройки

Новое в разделе Конфигурации

• Добавлены параметры конфигураций, отвечающие за создание сессий для пользователей АРМ. Для настройки данных конфигураций необходимо перейти в раздел Настройка системы > Конфигурации.
• Добавлена конфигурация, отвечающая за обязательность передачи идентификатора клиента в кассовом запросе на Расчёт прямой скидки. Настройка конфигурации происходит в разделе Настройка системы > Конфигурации.
• Добавлена конфигурация, отвечающая за максимально допустимое количество целевых аудиторий, участвующих в расчёте акции.
• Для реализации полноценного сценария авторизации в API Участника ПЛ по одноразовому паролю добавлено еще одно значение для конфигурации IsPasswordRequired. Также добавлена конфигурация SessionForCustomersValidityTimeMinutes, задающая период валидности сессии Участника ПЛ для операций по разблокировке, замене и объединению карт. Если с последнего ввода кода подтверждения прошло больше времени, чем задано в этом параметре, то требуется снова ввести одноразовый пароль. Для остальных методов сессия Участника ПЛ не ограничена по времени.
• Updated: Добавлена конфигурация, которая включает/выключает проверку передаваемого в поле CommonCode значения при загрузке общего каталога.
• Updated: Добавлена конфигурация, которая управляет применимостью фильтров из группы Карта. Для срабатывания этих фильтров для карт Участника ПЛ, независимо от переданного в покупке идентификатора, значение конфигурации необходимо установить на 1.
• Updated: Добавлена конфигурация, которая позволяет регулировать возможность передачи идентификатора клиента в заголовке X-Identifier, чтобы авторизоваться и иметь возможность проводить операции через OAuth-приложение от лица Участника ПЛ.
• Updated: Добавлен параметр конфигурации, который отвечает за формат, в котором передаются атрибуты клиента типа Date.
• Updated: Добавлена конфигурация, которая регулирует правила записи даты выдачи купона и проверки времени жизни купона. При включённой конфигурации:
  • запись даты выдачи купона происходит в соответствии с датой и временем чека в покупке. В АРМ и ЛК отображение даты активации купона отображается без учёта часового пояса Участника ПЛ;
  • время жизни купона проверяется путём сравнения даты чека в текущей покупке с датой сгорания купона;
  • передача даты выдачи купона является обязательной в методе по выдаче купона из эмиссии.

Новое в разделе Регулярные задачи

Updated: Добавлен Режим перезапуска задач

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

Регулярная задача по очистке расчётов Целевых аудиторий

Данные о всех расчётах ЦА хранятся в базе данных. Для уменьшения объёма хранимой информации и увеличения быстродействия Системы данная регулярная задача при запуске оставляет данные только о последнем расчёте ЦА и удаляет данные о всех предыдущих расчётах. Настройка регулярной задачи не требуется, т. к. она настроена в АРМ по умолчанию в разделе Настройка системы > Регулярные задачи.

Updated: Изменена логика работы регулярной задачи по переводу купонов в состояние Истёкший

Логика работы регулярной задачи по переводу купонов в состояние Истёкший теперь зависит от значения параметра конфигурации UseLocalDateForCoupons. В зависимости от значения конфигурации проверка даты сгорания купона может происходить либо с учётом часового пояса Участника ПЛ, либо с учётом локального времени, которое соответствует дате и времени чека в покупке. Подробнее смотрите здесь. 

Updated: Добавлен дополнительный ключ для настройки регулярной задачи по перерасчёту статуса

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

Updated: Добавлена новая регулярная задача по очистке записей в аудите

Раздел Аудит содержит информацию обо всех действиях, совершённых в Системе пользователями АРМ и Участниками ПЛ. Для уменьшения объёма хранимой информации и удаления неактуальных записей различных типов аудита из истории можно настроить регулярную задачу по очистке записей в аудите. В результате работы регулярной задачи будут удаляться записи с выбранным типом аудита, срок хранения которых превышает период, указанный в настройках регулярной задачи.

Новое в разделе Аудит

Добавлены новые типы аудита для Участника ПЛ:

• Вход в Мобильное приложение или другой клиентский сервис,
• Выход из приложения или клиентского сервиса,
• Успешное формирование QR-кода,
• Ошибка при формировании QR-кода.

Из них 2 доступны и для пользователя АРМ и используются для фиксирования момента авторизации пользователя в АРМ и его выхода из своей учётной записи в АРМ.

Updated: Добавлены типы аудита:

• Изменение любимого товара,
• Изменение любимой категории.

Они фиксируют изменения любимых товаров и категорий Участником ПЛ или пользователем АРМ. В дополнительной информации отображаются детали, включая предыдущее и новое значения любимых товаров/категорий, а также информация о приложении и устройстве, с которого пришёл запрос на изменение. Чтобы изменения любимых товаров/категорий записывались в аудит, необходимо настроить специальные параметры: AttributeFavoriteGoods, AttributeFavoriteCategories.

Новое в разделе Шаблоны уведомлений

Добавлена возможность разделять шаблоны уведомлений для разных каналов коммуникации с клиентом (ЛК, МП, касса, Контакт-центр), указав конкретное OAuth-приложение в поле Источник при создании шаблона уведомлений. Например, в Личном кабинете на сайте клиент получит сообщение: "Ваш код для регистрации на сайте — 123", а в Мобильном приложении: "Ваш код регистрации в мобильном приложении — 123". Если в создании отдельного шаблона для конкретного OAuth-приложения нет необходимости, в качестве источника следует выбрать Все: для любого канала коммуникации сообщение будет одинаковое.

Изменения в методах API

Новые методы API

• Появился метод, позволяющий переводить созданные купоны в состояние В очереди на выдачу, а также позволяет получить список номеров купонов, у которых изменились состояния;
• В группе методов для работы с атрибутами сущностей появились следующие методы:
  • Метод, который отправляет в архив атрибут сущности;
  • Метод, который восстанавливает атрибут сущности из архива;
  • Метод для обновления названия атрибута сущности;
• Появилась новая группа методов для работы с атрибутами клиентов через OAuth-приложение;
• Появился новый метод, предназначенный для пакетной привязки купонов Участникам ПЛ (клиентских и купонов для раздачи), находящихся в состоянии В очереди на выдачу. Это даёт возможность выдавать клиентам купон из заданного выпуска без привязки к покупке. Размер пакета купонов регулируется отдельным параметром.
• Появился новый метод, возвращающий информацию о пакетном объединении клиентов, которое завершилось с ошибками, в виде CSV-файла.
• В группе методов для работы с Контакт-центром появился новый метод, позволяющий отменить начатую регистрацию клиента. Если процесс регистрации был начат, но еще не завершен, оператор Контакт-центра может отменить регистрацию через карточку клиента, используя кнопку Отмена регистрации.
• Updated: В группе методов для работы с покупками появился новый метод, который передает сумму чека покупки с учётом скидки.
• Updated: В группе методов для работы с историей покупок появился новый метод, который возвращает список подтверждённых операций Участника ПЛ.

Изменения в существующих методах API

• В методах для работы с клиентами произошли следующие изменения:
  • Появился новый метод, который возвращает список значений атрибутов по номеру карты или телефона клиента;
  • Появился новый метод, который возвращает значение атрибута по номеру карты или телефона клиента;
  • Появился новый метод, который проверяет код подтверждения номера телефона;
• Изменились модели ответов в методах, возвращающих информацию о статусах клиентов;
• В методах для работы с атрибутами сущностей произошли следующие изменения:
  • В методе для создания атрибута для выбранного типа сущности изменилась модель запроса. Теперь в запросе передаются еще название атрибута, его описание и состояние;
  • В методе, который возвращает все атрибуты типа сущности, расширен список передаваемых параметров;
  • В методе, который возвращает все значения атрибутов типа сущности, расширен список передаваемых параметров;
  • В методе для обновления значения атрибута сущности появилась модель запроса, в которой передается JSON-модель с новым значением атрибута;
• В методе для выгрузки файла со списком кодов товаров, содержащихся в группе товаров, теперь можно использовать как внутренний, так и внешний идентификаторы группы товаров.
• Метод который блокирует/разблокирует карту разделен на 2 отдельных метода.
• Для методов, перечисленных ниже, при аутентификации по одноразовому паролю операция выполняется без ввода пароля от Личного кабинета, если с момента последнего ввода одноразового пароля прошло меньше времени, чем задано в параметре, ограничивающем сессию Участника ПЛ. Если время сессии вышло, то операция недоступна до момента повторного ввода одноразового пароля.
  • Разблокирует карту,
  • Оформляет замену карты,
  • Запускает объединение карт.

Метод блокировки карты доступен без валидации сессии.

• Updated: В методе, который оформляет выдачу купона из указанного выпуска, добавлен параметр issueDate. Обязательность передачи параметра зависит от значения конфигурации UseLocalDateForCoupons. При включенной конфигурации передача данного параметра является обязательной.
• Updated: В методе, который возвращает информацию о том, куплен ли каждый из товаров, внесены следующие изменения:
  • обновилась модель запроса: добавлены параметры фильтрации по датам fromDate и toDate. Если параметр fromDate не указан, то его значение выставляется равным за 3 месяца до текущего времени; если toDate не указан, то его значение выставляется равным текущему времени.
  • в ответе на запрос теперь возвращается подробная информация о торговой точке, в которой были куплены товары.
• Updated: Часть методов для работы с Контакт-центром стала доступна для вызова из OAuth-приложения: это методы для блокирования и разблокирования карты и счёта, методы для удаления, восстановления и замены карты.
• Updated: Теперь метод пакетного импорта паролей клиентов возвращает список ошибок, возникших при загрузке. Если операция загрузки прошла успешно, в ответе вернется пустой список.