Заявки на процессинг по дополнительной карте

Описание

Система предоставляет возможность двойного начисления по одному фискальному чеку: один раз по карте участника программы лояльности и один раз по карте менеджера (дополнительной карте). Данная функциональность называется MultipleProcessing. Это позволяет партнёрам внедрить прозрачную, привязанную к выручке систему мотивации сотрудников без ручного учёта продаж.

Принцип работы

1. В мобильном приложении программы лояльности участник сканирует QR-код с кассового чека.
2. Приложение передаёт в систему ML посредством запроса OData POST Receipt/BindContact реквизиты отсканированного чека (сумма, дата, ФН, ФД, ФПД) и, при наличии, номер дополнительной карты в параметре AdditionalCardNumber.
3. Если у партнёра включена настройка Loyalty.Processing.MultipleProcessing.TurnOn и у контакта определена карта с типом менеджера (согласно настройке Loyalty.Processing.MultipleProcessing.ManagerCardType), система определяет порядок сканирования и действует по одному из двух путей:
4. Путь А — менеджер сканировал первым: создаётся запись ожидания в очереди (state=0). Когда позднее поступает чек участника с совпадающими реквизитами (T/S/Fn/Fp/Fd), система обрабатывает его по карте менеджера напрямую через Receipt_UpdateStatus. Запись в очереди переводится в технический статус -1.
5. Путь Б — участник сканировал первым: система обрабатывает чек участника стандартным образом. Когда позднее поступает скан менеджера с совпадающими реквизитами, система находит чек участника в loyalty.fns_cheque, добавляет событие в loyalty.reprocessing_events и создаёт запись в очереди со статусом «Успешно» (1). Задание SQL Agent «MultipleProcessing» обрабатывает событие и выполняет начисление по карте менеджера.
6. Если в течение установленного периода ожидания (настройка Loyalty.Processing.MultipleProcessing.ManagerCheque.WaitingDay) чек участника так и не поступил, задание SQL Agent «Finish Multiprocessing Queue» переводит запись в статус «Просрочено».

Записи очереди мультипроцессинга доступны в интерфейсе MLO в разделе «Заявки на загрузку чеков» → представление «Заявки на процессинг по дополнительной карте». Представление доступно только для чтения: создание и редактирование записей вручную не предусмотрено.

1. Поля представления

1. Статусы обработки

Поле «Статус» отражает текущее состояние записи в очереди мультипроцессинга:

1. Сценарии обработки
   1. Сценарий 1. Карта менеджера загружает чек первой

1. Контакт с картой менеджера сканирует чек в мобильном приложении.
2. Система определяет, что контакт является менеджером, и создаёт запись в очереди со state=0 (в MLO поле «Статус» отображается пустым).
3. Участник ПЛ сканирует тот же чек позднее.
4. Система находит совпадающую запись в очереди по реквизитам (T/S/Fn/Fp/Fd) со state=0 и переводит её в технический статус -1. Номер карты менеджера из этой записи передаётся в Receipt_UpdateStatus.
5. Receipt_UpdateStatus выполняет обработку чека напрямую по карте менеджера. Запись в очереди остаётся со статусом -1 — в MLO это значение не отображается (OptionSet начинается с 1).
   1. Сценарий 2. Карта участника загружает чек первой
6. Участник ПЛ сканирует чек в мобильном приложении. Чек обрабатывается стандартным образом и привязывается к карте участника.
7. Контакт с картой менеджера сканирует тот же чек позднее.
8. Система находит уже привязанный чек с совпадающими реквизитами, добавляет событие в loyalty.reprocessing_events и создаёт запись в очереди со статусом «Успешно» (1).
9. Задание «MultipleProcessing» обрабатывает событие из reprocessing_events и выполняет начисление по карте менеджера.
   1. Сценарий 3. Только карта менеджера (без карты участника)
10. Контакт с картой менеджера сканирует чек. Система создаёт запись в очереди со state=0 (в MLO поле «Статус» отображается пустым).
11. Чек от участника ПЛ не поступает в течение периода, заданного настройкой Loyalty.Processing.MultipleProcessing.ManagerCheque.WaitingDay.
12. Задание «Finish Multiprocessing Queue» переводит запись в статус «Просрочено» (3) с сообщением «Не загружен. Превышено время ожидания чека участника ПЛ».

1. Системные настройки

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

1. Задания SQL Agent

Обработка очереди мультипроцессинга выполняется двумя заданиями SQL Agent:

1. Коды системных сообщений

1. Связанные объекты