Портал поддержки продуктов CSI
Публичный ресурс
SetPrisma | Интеграция с SET Prisma. v. 3.
Протоколы.
web-сервис.
Параметры подключения к Set Prisma
- IP-адрес сервера Set Prisma и порт;
- транспортный протокол: HTTP/HTTPS;
- сертификат самоподписанный.
POST /events
Request body (Content type: application/json)
Response
Code | ||
---|---|---|
200 | ОК | |
200 | ERROR | {"errorCode":-1} |
500 | EXCEPTION | Server error |
Ошибки
errorCode | error |
---|---|
-1 | Отсутствует лицензия |
-2 | Не удалось разобрать пакет |
Структура событий.
Формат.
json
Структура
type | value | required | Назначение | |||||
version | string | 3.0. | да | Версия протокола. При отсутствии атрибута json-документ считается версии 2.0. | ||||
events | array | |||||||
event | object | да | ||||||
prefix | string[3] | dict | да | Тип устройства | ||||
shop | integer | 0..N | да | Номер магазина | ||||
shopName | string | нет | Наименование магазина | |||||
device | integer | 0..255 | да | Номер устройства | ||||
deviceName | string | нет | Наименование устройства | |||||
shiftNumber | integer | 0..N | Номер смены | |||||
tabNumber | string | да | Табельный номер сотрудника | |||||
employee | string | да | ФИО сотрудника | |||||
code | integer | 1..N | да | Номер события | ||||
dateTime | string | да | Время события в формате dd.MM.yyyy HH:mm:ss.SSS или yyyy-MM-dd HH:mm:ss.SSS | |||||
session | object | Информация о пользовательской сессии | ||||||
role | string | dict | Роль | |||||
mode | string | dict | Режим работы | |||||
login | string | Логин пользователя | ||||||
document | object | Информация о документе | ||||||
type | string | dict | да | Тип документа | ||||
number | string | да | Номер | |||||
extraType | string | dict | Тип связанного документа: МЧ, ОЧ, накладная... | |||||
extraDevice | integer | Номер устройства, на котором оформлен связанный документ. | ||||||
extraShiftNumber | integer | Номер смены, в которой оформлен связанный документ. | ||||||
extraNumber | string | Номер связанного документа | ||||||
extraDateTime | string | Дата и время оформления связанного документа в формате dd.MM.yyyy HH:mm:ss.SSS или yyyy-MM-dd HH:mm:ss.SSS | ||||||
amount | number | Сумма документа | ||||||
goods | object | |||||||
pos | string | 1..N | да | Номер позиции/идентификатор строки в документе | ||||
item | string | да | Артикул | |||||
barcode | string | Штриховой код | ||||||
identifier | string | Идентификатор: акцизная или специальная марка, GS1 barcode, | ||||||
category | string | dict | Категория (группа) товара | |||||
name | string | Наименование | ||||||
type | string | dict | Тип товара | |||||
marked | boolean | Признак маркировки | ||||||
ageRestrict | boolean | Признак ограничения по возрасту | ||||||
measure | string | dict | Мерность | |||||
addedBy | string | dict | Способ ввода товара | |||||
basePrice | number | Регулярная цена | ||||||
quantity | number | Количество | ||||||
price | number | Цена продажи | ||||||
amount | number | Стоимость позиции | ||||||
discount | number | Размер скидки на позицию | ||||||
expirationDate | string | Срок годности. Дата в формате dd.MM.yyyy или yyyy-MM-dd | ||||||
rejection | string | dict | Причина отклонения | |||||
card | object | Информация о карте лояльности | ||||||
type | string | dict | Тип | |||||
category | string | dict | Категория | |||||
addedBy | string | dict | Способ ввода номера карты | |||||
number | string | да | Номер | |||||
customer | string | ФИО владельца | ||||||
amount | number | Бонусный, марочный баланс | ||||||
operation | string | dict | Операция с картой | |||||
rejection | string | dict | Причина отклонения | |||||
coupon | object | Информация о купоне | ||||||
type | string | Тип | ||||||
category | string | Категория | ||||||
number | string | да | Номер | |||||
rejection | string | dict | Причина отклонения | |||||
discount | object | Информация о скидке | ||||||
type | string | dict | Тип | |||||
amount | number | Сумма скидки | ||||||
payment | object | Информация об оплате | ||||||
type | string | dict | да | Тип | ||||
code | string | dict | Код | |||||
cardNumber | string | Номер карты | ||||||
cardHash | string | Хэш номера карты | ||||||
amount | number | да | Сумма | |||||
rejection | string | dict | Причина отклонения | |||||
processing | object | инфо по обращению в процессинговый центр (товар, скидка, оплата, документ, ...) | ||||||
type | string | dict | Имя | |||||
request | string | Запрос (операция) | ||||||
result | string | Результат | ||||||
dialog | ||||||||
category | string | dict | Категория | |||||
message | string | Сообщение/вопрос кассиру | ||||||
value | string | Значение введённое/выбранное кассиром. | ||||||
response | string | dict | Реакция/ответ на сообщение | |||||
error | ||||||||
category | string | dict | Категория ошибки | |||||
code | string | Код ошибки | ||||||
text | string | Текст ошибки | ||||||
persons | ||||||||
number | integer | Количество человек | ||||||
info | object | |||||||
sex | string | Пол {male|female} | ||||||
age | number | Возраст | ||||||
emotion | string | Эмоция | ||||||
vehicle | ||||||||
number | string | Государственный номер транспортного средства | ||||||
offline | boolean | Признак offline-события |
Схема.
Пример.
Итоговый документ
При регистрации или аннулирования/отмены кассового документа в Set Prisma отправляется информационный пакет, содержащее весь его состав:
- Заголовок;
- Позиции;
- Карты;
- Купоны;
- Скидки;
- Оплаты.
Структура
type | value | required | Назначение | ||||
version | string | 3.0. | да | Версия протокола. При отсутствии атрибута json-документ считается версии 2.0. | |||
document | object | да | |||||
prefix | string[3] | dict | да | Тип устройства | |||
shop | integer | 0..N | да | Номер магазина | |||
shopName | string | нет | Наименование магазина | ||||
device | integer | 0..255 | да | Номер устройства | |||
deviceName | string | нет | Наименование устройства | ||||
shiftNumber | integer | 0..N | нет | Номер смены | |||
tabNumber | string | да | Табельный номер сотрудника | ||||
employee | string | да | ФИО сотрудника | ||||
dateTime | да | Время документа | |||||
type | string | dict | да | Тип документа | |||
number | string | да | Номер | ||||
amount | number(19,2) | Сумма документа | |||||
status | integer | да | 0 - зарегистрирован/завершён, 1 - аннулирован/отменён, 2 - отложен | ||||
goods | array | ||||||
pos | string | 1..N | да | Номер позиции/идентификатор строки в документе | |||
item | string | да | Артикул | ||||
barcode | string | Штриховой код | |||||
identifier | string | Идентификатор: акцизная или специальная марка, GS1 barcode, | |||||
category | string | dict | Категория (группа) товара | ||||
name | string | Наименование | |||||
type | string | dict | Тип товара | ||||
marked | Boolean | Признак маркировки | |||||
ageRestrict | Boolean | Признак ограничения по возрасту | |||||
measure | string | dict | Мерность | ||||
addedBy | string | dict | Способ ввода товара | ||||
basePrice | number(19,2) | Регулярная цена | |||||
quantity | number(19,3) | Количество | |||||
price | number(19,2) | Цена продажи | |||||
amount | number(19,2) | Стоимость позиции | |||||
discount | number(19,2) | Размер скидки на позицию | |||||
quantityPlan | number(19,2) | Количество по плану | |||||
cards | array | Информация о карте лояльности | |||||
type | string | dict | Тип | ||||
category | string | dict | Категория | ||||
addedBy | string | dict | Способ ввода номера карты | ||||
number | string | да | Номер | ||||
customer | string | ФИО владельца | |||||
amount | number(19,2) | Бонусный, марочный баланс | |||||
coupons | array | Информация о купоне | |||||
type | string | Тип | |||||
category | string | Категория | |||||
number | string | да | Номер | ||||
discounts | array | Информация о скидке | |||||
type | string | dict | Тип | ||||
actionName | string | Наименование акции в CRM | |||||
amount | number(19,2) | Сумма скидки | |||||
pos | integer | Номер позиции, на которую дана скидка. Для скидки на чек не заполняется. | |||||
cardNumber | string | Номер карты. Только для скидки по карте | |||||
couponNumber | string | Номер купона. Только для скидки по купону | |||||
payments | array | Информация об оплате | |||||
type | string | dict | да | Тип | |||
code | string | dict | Код | ||||
cardNumber | string | Номер карты | |||||
amount | number(19,2) | да | Сумма |
Пример
Реестр событий
Код | Название | Описание |
Пользовательские сессии | ||
1 | Начало работы | Авторизация пользователя в приложении при запуске или при выходе из режима ожидания/блокировки. Открывает очередной сеанс работы. |
2 | Отказ в авторизации | Система отклонила логин/пароль пользователя. |
3 | Конец работы | Выход пользователя с блокировкой приложения, при которой для возобновления работы требуется авторизация, завершение работы приложения. |
4 | Вход в режим | Пользователь переключил приложение в один из режимов работы (администратор, кассир, инженер). |
5 | Выход из режима | Завершение работы в отдельном режиме приложения. |
6 | Повышение прав | Авторизация пользователя с расширенными правами, изменение положения ключа с расширением прав, для выполнения операции, на которую у текущего пользователя не достаточно прав. |
7 | Окончание повышения прав | Возврат к правам текущего пользователя. |
Управление документом | ||
11 | Начало документа | Любой документ открывается событием "Начало документа"; |
12 | Конец документа | Любой документ закрывается событием "Конец документа" или "Аннулирование документа"; Если после регистрации чека над ним выполняются действия: например, регистрация в CRM с выдачей карты, купона, по которым также генерируются события, то событие "Конец документа" должно отправляться после всех этих действий. |
13 | Аннулирование документа | |
14 | Запись документа | |
15 | Получение документа | |
16 | Отмена документа | Передаётся в тех случаях, когда кассовое ПО позволяет выполнить удаление товарных позиций и самого чека без вызова операции аннулирования. |
Товарные позиции | ||
20 | Добавление товарной позиции | Фиксирует момент добавления товарной позиции в документ. |
21 | Процессинг товара | Запрос во вне на проверку, регистрацию, активацию, получение дополнительных характеристик товара. |
22 | Отказ в добавлении товара | Система не может добавить товар в чек. Указывается причина. |
23 | Отмена товара | Отмена добавления в документ текущего товара. |
24 | Удаление товара | Удаление позиции из документа, кроме текущей. |
25 | Изменение количества товара | Ручное изменение количества товара в позиции, кроме текущей. |
26 | Изменение цены товара вручную | Ручное изменение цены товара в позиции. |
27 | Сканирование марки | Ввод акцизной или специальной марки для маркированной продукции. |
28 | Запрос информации о товаре | Вывод на экран информации о товаре без добавления в документ. |
29 | Взвешивание товара | Взвешивание товара для определения количества в текущей позиции. |
30 | Ввод товара | Сканирование/выбор товара, который перед добавлением в документ требует дополнительных действий: проверка, взвешивание, ввод марки.... |
31 | Выбор цены | Выбор цены из предустановленного списка: цены в отделах, МРЦ на табак... |
32 | Ввод количества | Указание количества товара в текущей позиции. |
33 | Автоматическое изменение цены товара | Автоматическое увеличение цены товара до значения МРЦ, если цена товара ниже МРЦ. |
34 | Отклонение марки | Для введённой акцизной или специальной марки не пройдена проверка валидности по регулярным выражениям. |
35 | Отказ в изменении количества товара | |
36 | Отмена сканирования марки | Кассир на запрос ввода марки для товара нажимает "Отмена" и товар в чек не добавляется. |
38 | Переход на чековую позицию по ш/к | Сканирование товара в режиме поиска позиции |
39 | Сканирование вне чека | Сканирование штрихового кода, которое не обрабатывается кассовой программой в рамках процесса по добавлению или поиску товара в чеке. |
200 | Взвешивание вне чека | От прикассовых весов получен вес, который не обрабатывается кассовой программой в рамках процесса по взвешиванию товара при добавлении в чек. |
201 | Отказ в отмене товара | Кассир пытается отменить товар в подвале чека, но касса блокирует операцию и товар остаётся в чеке |
202 | Отказ в удалении товара | Кассир пытается удалить товарную позицию из чека, но касса блокирует операцию и товар остаётся в чеке |
Карты | ||
40 | Добавление карты | Добавление в чек карты покупателя. |
41 | Отказ в добавлении карты | Карта не добавлена в чек: неизвестная, с ограничениями... |
42 | Выдача карты | Выдача карты лояльности "новому" покупателю. В том числе, при продаже карты. |
43 | Процессинг карты | Запрос во вне на проверку, активацию, получение дополнительных характеристик карты. |
44 | Операция по карте | При списании бонусов либо назначается скидка, либо проводится оплата, что фиксируется отдельными событиями. Дополнительное событие по списанию облегчает процедуру обработки данных. |
45 | Отмена карты | Удаление карты из чека |
Купоны | ||
50 | Добавление купона | Добавление в чек купона. |
51 | Отказ в добавлении купона | Купон не добавлен в чек: неизвестный, недействующий... |
52 | Выдача купона | Выдача купона покупателю. |
53 | Процессинг купона | Запрос во вне на проверку, активацию, получение дополнительных характеристик купона. |
54 | Отмена купона | Удаление купона из чека |
Скидки | ||
60 | Назначение скидки | Применение скидки на товарную позицию или на чек, в том числе по карте и купонам. |
61 | Отмена скидки | Отмена ранее применённой скидки. |
Оплаты | ||
70 | Добавление оплаты | В документ добавлена оплата |
71 | Отказ в добавлении оплаты | Система не может добавить оплату в чек. Указывается причина. |
72 | Удаление оплаты | Отмена ранее добавленной оплаты |
73 | Ввод оплаты | Выбор оплаты, суммы и платёжного средства в случае, если перед добавлением оплаты в документ требуются дополнительных действий: проверка, запрос баланса, списание... |
74 | Процессинг оплаты | Запрос во внешнюю систему на проверку платёжного средства, получение дополнительных характеристик оплаты, списание. |
75 | Отмена операции на терминале | Вызов с кассы функции отмены выполненной операции на терминале банка. |
Процессинг | ||
80 | Вызов процессинга | Обращение к процессинговому центру |
81 | Ошибка процессинга | Ошибка при обращении или в ответе процессингового центра |
82 | Открытие внешнего приложения на кассе | |
83 | Закрытие внешнего приложения на кассе | |
Чек | ||
90 | Расчёт | Переход режим расчёта с покупателем. Подытог. |
91 | Отмена расчёта | Возврат в режим формирования позиционного состава документа. |
92 | Регистрация чека | Регистрация и печать кассового чека. |
93 | Копия чека | Печать копии чека. |
94 | Печать пречека | Печать предварительного чека |
Касса | ||
100 | Открыт денежный ящик | Событие содержит привязку к документу, если произошло при оформлении кассового чека, внесения или инкассации денежных средств. |
101 | Перезагрузка кассы | |
102 | В кассе большая сумма денег | |
103 | Закрыт денежный ящик | |
105 | Печать X-отчета | |
106 | Печать Z-отчета | |
107 | Начало смены | |
108 | Конец смены | |
109 | Информация о кассе | |
115 | Открыт денежный ящик по кнопке | |
116 | Печать копии Z-отчёта | |
Диалог с оператором. | ||
110 | Сообщение оператору | Информационное сообщение, не блокирующее. |
111 | Запрос оператору | Диалоговое окно, на которое кассир должен выполнить выбор, ввести информацию. |
112 | Ответ оператора | Кассир выполнил требуемое действие, диалоговое окно закрылось. |
SCO | ||
120 | Вызов помощника покупателем | Покупатель вызывает помощника |
121 | Кассу переобучили весу товара | Касса сообщила, что контрольный вес не соответствует товару. Помощник указал, что вес корректный. |
122 | Помощник проигнорировал контрольный вес товара | Касса сообщила, что контрольный вес не соответствует товару. Помощник указал, что товар корректный, вес игнорировать. |
123 | Тарирование контрольных весов | |
124 | Покупатель попал на выборочную проверку | |
125 | Нажата кнопка "Начать" | |
126 | Помощник подтвердил возраст покупателя | |
127 | Помощник не подтвердил возраст покупателя | |
128 | Товар отсканирован, но долго ставится на контрольную платформу | |
129 | Товар отсканирован, но не добавлен в чек | |
130 | Покупатель исправил свою ошибку | |
131 | Товар поставили на контрольные весы в момент оплаты | |
132 | Неотсканированный товар поставили на контрольные весы | |
133 | Товар сняли с контрольных весов | |
134 | Вес товара не соответствует заданному | |
135 | Нестабильный вес на контрольных весах | |
136 | Все ошибки разрешены | |
137 | Отложенный вызов помощника | Сигнал помощнику (фонарь) о необходимости вмешательства без блокировки кассы |
138 | Вызов помощника с блокировкой кассы | Блокировки кассы и сигнал помощнику (фонарь) о необходимости вмешательства |
139 | Блокировка кассы при простое | |
Видеоаналитика | ||
201 | Вход/выход покупателя | Отправляется при входе в магазин или выходе из магазина покупател(я, ей) |
202 | Количество человек в очереди | Отправляется при каждом изменении количества человек в зоне контроля очереди |
203 | Наличие кассира на кассе | Отправляется при появлении сотрудника в кассовой рабочей зоне или при выходе сотрудника из неё. Может быть > 1 |
210 | Въезд автотранспорта | Отправляется при въезде транспортного средства на территорию |
211 | Выезд автотранспорта | Отправляется при выезде транспортного средства с территории |
Другие | ||
999 | Ошибка | |
1000 | Текущее время | Онлайн-событие с текущим временем кассы для синхронизации. |
Справочные значения атрибутов событий
Справочник типов устройств - источников событий фиксированный. События с неизвестным значением не обрабатываются.
Остальные справочники пополняемые.
Значение | Название | Подстановка | |
event.prefix | Тип устройства - источника событий. | ||
ККМ | Касса | ||
SSC | Терминал self-scanning | ||
CAM | Камера | ||
VRS | видеорегистратор/видеосервер | ||
VAS | система видео-анализа | ||
WMS | WMS-система | ||
TSD | Терминал сбора данных | ||
event.session.mode | Режим работы | @event.session.mode@ | |
---|---|---|---|
cashier | Режим кассира | кассира | |
admin | Режим администратора | администратора | |
customization | Режим настроек | настроек | |
event.document.type event.document.extraType | Тип документа | @event.document.type@ | |
Полное наименование | Краткое наименование | ||
sale | Чек продажи | Продажа | чека продажи |
returnSale | Чек возврата | Возврат | чека возврата |
corrSale | Коррекция прихода | Коррекция | коррекции прихода |
corrPurchase | Коррекция расхода | Коррекция | коррекции расхода |
purchase | Покупка (Расход) | Расход | покупки |
returnPurchase | Возврат покупки (Возврат расхода) | Возврат расхода | возврата покупки |
deposit | Внесение наличных в кассу | Внесение | внесения наличных в кассу |
withdrawal | Изъятие наличных из кассы | Изъятие | изъятия наличных из кассы |
x_report | X-отчёт | X-отчёта | |
z_report | Z-отчёт | Z-отчёта | |
acceptance | Приёмка | приёмки | |
shipment | Отгрузка | отгрузки | |
inventory | Инвентаризация | инвентаризации | |
writeOff | Списание | списания | |
returnToSupplier | Возврат поставщику | возврата поставщику | |
event.document.extraType | Дополнительные типы. Не могут указываться в event.document.type | @event.document.extraType@ | |
softCheque | Мягкий чек | МЧ | мягкого чека |
delayedCheque | Отложенный чек | ОЧ | отложенного чека |
qrCheque | QR-чек | QR-чека | |
chequePart | Часть разделённого чека | части разделённого чека | |
fiscalDoc | Фискальный документ. | фискального документа | |
invoice | Накладная | накладной | |
event.goods.type | Тип товара/услуги | ||
food | Пищевая продукция | ||
nonFood | Непищевая продукция | ||
alcohol | Алкоголь | ||
alcoset | Алкогольный промо-набор | ||
tobacco | Табачная продукция | ||
energy | Энергетические напитки | ||
presentCard | Подарочная карта | ||
present | Товар-подарок | ||
discountCard | Дисконтная карта | ||
lotteryTicket | Лотерейный билет | ||
moneyOrder | Денежный перевод | ||
product | Любой товар. Используется, если нет возможности точной типизации. | ||
service | Любая услуга. Используется, если нет возможности точной типизации. | ||
bonusPoint | Зачисление бонусных балансов | ||
licenseKey | Электронный ключ ПО | ||
mobilePay | Мобильная оплата | ||
jewel | Ювелирный товар | ||
clothing | Одежда | ||
event.goods.measure | Мерность товара | ||
piece | штучный | ||
weight | весовой | ||
measured | мерный (кроме весового) | ||
pieceWeight | штучно-весовой | ||
event.goods.addedBy | Способ добавления товара | @event.goods.addedBy@ | |
scanner | сканирование | сканером | |
barcode | по штрихкоду вручную | вручную по ш/к | |
article | по коду вручную | вручную по коду | |
directory | из справочника | из справочника | |
softCheque | мягкий чек | из мягкого чека | |
delayedCheque | отложенный чек | из отложенного чека | |
selfScanning | мягкий чек self-scanning | из self-scanning | |
qrCheque | из QR-кода | из QR-кода | |
picList | плитка | кнопкой экрана | |
price | по цене | по цене | |
event.goods.rejection | Причина отказа, отклонения товара | @event.goods.rejection@ | |
notFound | Товар не найден | Товар не найден | |
saleBan | Запрет продажи | Запрет продажи | |
zeroPrice | Нулевая цена | Нулевая цена | |
dateExpired | Истёк срок годности | Истёк срок годности | |
AgeNotConfirmed | Не подтверждён возраст | Не подтверждён возраст | |
MarkNotValid | Марка не прошла проверку | Марка не прошла проверку | |
MarkDuplicated | Дубль марки | Дубль марки | |
event.card.type | Тип карты | @event.card.type@ | |
discount | Скидочная | скидочной карты | |
bonus | Бонусная | бонусной карты | |
children_spb | Детская карта СПб | детской карты СПб | |
social_msk | Социальная карта москвича | социальной карты москвича | |
event.card.addedBy | Способ ввода карты | @event.card.addedBy@ | |
scanner | Сканирование | сканером | |
cardReader | Ридер | ридером | |
hand | Вручную | вручную | |
terminal | Через терминал банка | через терминал банка | |
event.discount.type | Тип скидки | @event.discount.type@ | |
action | По акции | скидки по акции | |
card | По карте | скидки по карте | |
coupon | По купону | скидки по купону | |
bonus | Бонусы | скидки бонусами | |
hand | Ручная | ручной скидки | |
markdown | Уценка | уценочной скидки | |
round | Округление | скидки на округление | |
event.card.operation | Операция с картой покупателя | @event.card.operation@ | |
balance | Получение баланса | получения баланса | |
activate | Активация | активации | |
writeOff | Списание | списания с | |
accrual | Начисление | начисления для | |
cancelWriteOff | Отмена списания | отмены списания с | |
cancelAccrual | Отмена начисления | отмена начисления для | |
event.payment.type | Тип оплаты | @event.payment.type@ | |
cash | наличные | наличными | |
cashless | безналичный | безналичными | |
prepayment | зачёт аванса (подарочная карта) | подарочной картой | |
bonus | бонусы | бонусами | |
event.payment.code | Код оплаты | @event.payment.code@ | |
"payment":{type":"cash"} | |||
back | сдача | сдача | |
"payment":{"type":"cashless"} | |||
bank | банковская карта | банковской картой | |
children_spb | детская карта СПб | детской картой СПб | |
social_msk | социальная карта москвича | социальной картой москвича | |
alipay | электронный кошелёк AliPay | электронным кошельком AliPay | |
электронный кошелёк WeChat | электронным кошельком WeChat | ||
"payment":{"type":"bonus"} | |||
spasibo | Спасибо от Сбербанка | Спасибо от Сбербанка | |
aeroflot | Мили Аэрофлот | Мили Аэрофлот | |
event.processing.type | Процессинг | ||
utm | УТМ ЕГАИС | ||
setmark | SET Mark | ||
setloy | SET Loyalty | ||
event.dialog.category | |||
ageConfirm | Подтверждение возраста покупателя | ||
event.error.category | |||
sco | Ошибки при работе на кассе самообслуживания SCO | ||
event.error.code | |||
"error":{"category":"sco"} | |||
weighingTimeout | Товар сканирован, но долго ставится на контрольную платформу | ||
weighingDuringPay | Товар поставили на контрольные весы в момент оплаты | ||
weighingWithoutScan | Несканированный товар поставили на контрольные весы | ||
goodsRemovedFromScales | Товар сняли с контрольных весов | ||
unstableWeight | Нестабильный вес | ||
paymentTimeout | Отмена оплаты по таймауту | ||
Примеры событий
Примечание.
В качестве примеров приводится не полный json-документ, а только элементы массива events.
Примеры сценариев
Добавление алкогольного товара в чек.
# | Действие/операция | Код события | Название события |
---|---|---|---|
1 | Кассир сканирует штриховой кода товара | ||
2 | Касса выполняет поиск товара по ш/к и получает его характеристики | 30 | Ввод товара |
3 | Касса запрашивает ввод акцизной марки | ||
4 | Кассир сканирует акцизную марку | 27 | Сканирование марки |
5 | Касса выполняет запрос на проверку марки | ||
6 | Касса получает ответ об успешной проверке | 21 | Процессинг товара |
7 | Касса запрашивает подтверждение достаточного возраста покупателя | 104 | Запрос кассиру |
8 | Кассир подтверждает | 105 | Ответ кассира |
9 | Товар добавляется в чек | 20 | Добавление товарной позиции |
Альтернативные варианты сценария. | |||
2.1. | Касса не находит товар | 22 | Отказ в добавлении товара |
4.1. | Кассир не может сканировать и нажимает отмена | 22 | Отказ в добавлении товара |
6.1. | Проверка не успешна | 21 22 | Процессинг товара Отказ в добавлении товара |
7.1. | Кассир не подтверждает возраст | 105 22 | Ответ кассира Отказ в добавлении товара |
Применение купона.
1 | Кассир сканирует штриховой кода купона. | ||
2 | Касса выполняет запрос в CRM систему для проверки и получения параметров купона. | 53 | Процессинг купона |
3 | Касса получает ответ об успешной проверке | 50 | Добавление купона |
4 | Касса выполняет расчёт и применение скидки по купону | 60 | Назначение скидки |
5 | Оплата, регистрация чека, обращение в CRM, ответ от CRM "выдать купон" | ... | ... |
6 | Касса запрашивает купон для активации и выдачи | 104 | Запрос кассиру |
7 | Кассир сканирует ш/к купона | 105 | Ответ кассира |
8 | Касса выполняет запрос на активацию купона в CRM | ||
9 | Касса получила ответ об успешной операции | 53 | Процессинг купона |
10 | Касса выводит сообщение кассиру о выдаче купона | 52 | Выдача купона |
Альтернативные варианты сценария. | |||
2.1. | Проверка не успешна | 51 | Отказ в добавлении купона |
7.1. | Купон не выдаётся - нет в наличии, покупатель отказался ... | 105 | Ответ кассира |
9.1. | Не удалось активировать купон | 53 | В событии "Процессинг купона" передаётся результат и информация об ошибке. |
Оплата подарочной картой
1 | Кассир выбирает оплату подарочной картой. | ||
2 | Касса запрашивает номер карты. | ||
3 | Кассир вводит номер подарочной карты | 73 | Ввод оплаты |
4 | Касса выполняет запрос на проверку и получение номинала | ||
5 | Касса получает ответ об успешной проверке и номинал | 74 | Процессинг оплаты |
6 | Кассир подтверждает оплату подарочной картой | ||
7 | Касса выполняет запрос на списание средств | ||
8 | Касса получает ответ об успешной операции списания | 74 | Процессинг оплаты |
9 | Оплата добавляется в чек | 70 | Добавление оплаты |
Альтернативные варианты сценария. | |||
5.1. | Проверка не успешна | 71 | Отказ в добавлении оплаты |
8.1. | Не удалось выполнить списание | 71 | Отказ в добавлении оплаты |
© 1994-2023, ООО "Кристалл Сервис Интеграция".
Все права защищены.