Завдання на реалізацію обміну даних між Касовою системою та АВМ Loyalty

Суть завдання - організувати регулярний автоматичний (без участі людини) обмін даними між касовою системою Клієнта та системою лояльності АВМ Loyalty.

Загальна інформація:

В систему АВМ Loyalty передаютьсявсі транзакції, як ідентифіковані, і неідентифіковані.

Обмін даними між касовою системою та системою АВМ Loyalty повинен бути реалізований в двох режимах:

Онлайн- взаємодія каси та системи АВМ Loyalty відбувається в режимі реального часу)
Офлайн-у разі неможливості взаємодії каси та системи АВМ Loyalty в онлайн режимі (наприклад відсутність інтернет з'єднання) каса повинна записувати транзакції в чергу з номерами карток (перевіряючи їх по масці) і при відновленні з'єднання з АВМ Loyalty передавати їх. Якщо при надсиланні транзакції з черги до системи лояльності система лояльності повертає помилку, що карту не знайдено, запит надсилається повторно, як неідентифікована покупка.

Дані передаються методами RESTful API по протоколу https.

Для взаємодії каси та Лояльності використовуються методи API:

POST /partner/operation/user/registration –реєструє нового учасника програми лояльності;

POST /partner/card/card-update -використовується зміни статусу карти на касі;

POST /partner/operation/pre-check -розрахунок за чеком;

POST /partner/operation/check-confirm -запит на підтвердження продажу;

POST /~~партнер/операція/чек-повернення~~partner/operation/check-return –запит на повернення;

~~ПУБЛІКУВАТИ~~POST /~~партнер/реферал/посилання~~partner/referral/link -для створення зв'язки реферал-реферер (по роботі реферальної програми)

Операції з продажу:

Перелік операцій продажу на касі:

Режим онлайн - коли є безперервний доступ до мережі Internet
1. Купівля товару
2. Повернення товару (повне, часткове, повторне)
Режим офлайн - немає доступу до мережі Internet - дані продажу не можуть відправитися в CRM Лояльності безпосередньо під час продажу.

Порядок виконання операцій продажу:

Карт-юзер-інф

Отримати відповідь передрахунку POST /v2/partner/operation/pre-check.
Вивести повідомлення скільки можна списати бонусів за цей чек, якщо можна списати бонуси - значення з параметра "receipt_bonus_amount": З питанням чи списати бонуси (Відповідь Так, і Відповідь Ні).
Якщо відповідь Так. Вивести поле для введення кількості до списання, при цьому відображати максимальну допустиму кількість до списання. Якщо користувач ввів суму бонусів більше, ніж допустима – видавати відповідне повідомлення та не надсилати дані. Додати кнопку після введення - Надіслати (виконати другий передрахунок POST /v2/partner/operation/pre-check) та Скасувати - не списувати бонуси (вивести суму до оплати на чек та кількість нарахованих бонусів попозиційно та загальну кількість на чек) При натисканні відправити вивести суму до оплати на чек та кількість нарахованих та списаних бонусів (попозиційно та загальна кількість на чек).
Якщо Відповідь Ні вивести суму до оплати на чек та кількість нарахованих бонусів попозиційно та загальну кількість.
Після введення суми до оплати - підтвердження операції продажу POST /v2/partner/operation/check-confirm

За будь-яких змін у продажу - надсилати запит POST /v2/partner/operation/pre-check

Опис методів також доступний за посиланням:

канал API: https://api.sandbox.abmloyalty.app

ключ (токен):

версія: v2

тип авторизації: Базова автентифікація(можна використовувати поле імені користувача як токен (ключ) доступу та пропустити пароль)

ключ:

!! доступ до тестової бази. Потім потрібно буде перейти на продуктову систему

Опис усіх методів доступний за посиланням:

https://documenter.getpostman.com/view/10073265/TzJuAdf5

Реєстрація нового учасника програми лояльності (ПЛ) на касі

Запит на реєстрацію нового учасника програми лояльності (без верифікації по смс)

POST /partner/operation/user/registration

Створює новий рахунок у системі, заповнює анкету нового учасника програми.
У параметрах потрібно передати анкетні дані клієнта.
Обов'язковими параметрами є поля анкети, які встановлені як обов'язкові до заповнення (у даному прикладі 5 параметрів).
Метод повертає телефон та guid нового, створеного у системі учасника програми лояльності.

Назва	Тип даних	Опис
phone	~~рядок~~string	Номер мобільного телефону у форматі 380#########
first_name	~~ціле число~~integer	Ім'я учасника ПЛ
middle_name	~~рядок~~string	По батькові учасника програми лояльності
last_name	~~рядок~~string	Прізвище учасника програми лояльності
birth_day	~~рядок~~string	Дата народження учасника програми лояльності у форматі 1989-03-17
id_region	~~ціле число~~integer	Глобальний довідник регіону проживання
id_city	~~ціле число~~integer	Глобальний довідник міста проживання пов'язаний з регіоном.
gender	~~ціле число~~integer	Стать:1 - чоловік2- жінка
sms_notify	~~ціле число~~integer	Підписатися на смс розсилку:1-Згідний0-Не згоден
email_notify	~~ціле число~~integer	Підписатися на email розсилку:1-Згідний0-Не згоден
email	~~рядок~~string	Електронна пошта у форматі abm@abmcloud.com
address	~~рядок~~string	Адреса учасника ПЛ
channel_reg	~~ціле число~~integer	Канал реєстрації.Для каси: 5.

Приклад відповіді при успішному запиті:

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 201,

"~~даних"~~data": {

"~~телефон"~~phone": "380931000013",

"guid":« "68c147a2-edbd-4df5-a8b2-~~dadfb3a70ebc»~~dadfb3a70ebc",

}

Реєстрація учасника програми лояльності (з верифікацією по смс)

- - Реєстрація з смс за наявності картки
    - Перевірка номера картки

Метод перевіряє, чи є така карта в програмі лояльності, якщо карта є в параметрі availability повертається 1, якщо не карти немає-0.

~~ОТРИМАТИ~~GET /client/card/{number}/availability

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
number	~~рядок~~string	Номер картки учасника ПЛ

- - - Запит списку обов'язкових полів

GET /client/profile-params– повертає список полів основної анкети та їх обов'язковість до заповнення.

- - - Запит списку додаткових полів

GET /system/profile-fields- повертає список додаткових полів анкети та їхню обов'язковість до заповнення.

- - - Запит списку регіонів

~~ОТРИМАЙТЕ~~GET /v2/client/geo/{country}/regions -повертає всі регіони та їх ID

{country} - ID країни

- - - Запит списку міст

~~ОТРИМАЙТЕ~~GET /v2/client/geo/{country}/{city}/search-city - пошук у частині назви міста, повертає міста (регіони, країни) заданої country, max = 10шт

{country} - ID країни

{city} - частина назви міста

{country} - ID країни прописати в запиті за промовчанням і не виводити в інтерфейс користувача для вибору.

Наприклад, ID країни Казахстан = 81

- - - Перевірка номера телефону користувача

POST /v2/client/check-phone–метод перевіряє чи є цей номер телефону вже в програмі лояльності, якщо є, то параметр is_exist у відповідь приходить true, якщо ні-false.

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
phone	~~рядок~~string	Номер мобільного телефону у форматі 380#########

- - - Реєстрація по смс

POST /v2.1/client/registration – метод реєструє номер телефону та відправляє на номер смс із кодом підтвердження

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
phone	~~рядок~~string	Номер мобільного телефону у форматі 380#########
password	~~рядок~~string	Постійний пароль можна вносити стандартний 111111

- - - Підтвердження реєстрації паролем із смс

POST /v2.1/client/registration-confirm -метод відправляє код із смс і підтверджує реєстрацію

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
~~код~~code	~~рядок~~string	Код з смс
sms_id	~~ціле число~~integer	Id sms, отриманий у попередньому запиті

- - - Присвоєння картки користувачеві

POST /v2/client/card/set-card – метод надає зазначений номер картки учаснику (по токену)

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
~~code~~number	~~рядок~~string	Номер картки учасника ПЛ

- - - Генерація віртуальної картки(якщо немає пластикової картки)

GET /v2/client/card/generate-card– метод генерує віртуальну карту учаснику програми лояльності (за токеном)

- - - Надсилання анкетних даних

~~PUT~~PUT/v2/client /~~v2/клієнт /профіль~~profile–метод надає зазначені дані учаснику (по токену)

Назва	Тип даних	Опис
first_name	~~цsле число~~integer	Ім'я учасника ПЛ
middle_name	~~рядок~~string	По батькові учасника програми лояльності
last_name	~~рядок~~string	Прізвище учасника програми лояльності
birth_day	~~рядок~~string	Дата народження учасника програми лояльності у форматі 1989-03-17
id_region	~~ціле число~~integer	Глобальний довідник регіону проживання
id_city	~~ціле число~~integer	Глобальний довідник міста проживання пов'язаний з регіоном.
gender	~~ціле число~~integer	Стать:1 - чоловік2- жінка
email	string	Електронна почта в форматі abm@abmcloud.com
sms_subscribe	~~ціле число~~integer	Підписатися на смс розсилку:1-Згідний0-Не згоден
email_subscribe	~~ціле число~~integer	Підписатися на email розсилку:1-Згідний0-Не згоден
children	~~ціле число~~integer	Кількість дітей:0-дітей немає;1-1;2-2;3-3;4- ще 3;
channel_reg	~~ціле число~~integer	Канал реєстрації.Для каси: 5.
family_stat	~~ціле число~~integer	Сімейний стан:0- не визначено;1- одружений;2 - одномісні,
has_auto	~~ціле число~~integer	Наявність автомобіля:0 - не визначено;1 - ненемає ~~сам;~~авто;2 - легковий автомобіль;3 - мікроавтобус;4 - вантажний ~~вагон;~~;5 - інший автомобіль,
work_status	~~ціле число~~integer	Вид зайнятості:0 - не визначено;1 - бізнесмен;2 - урядовець;3 - службовець;4 - учень;5 - пенсіонер;6 - домогосподарка;7 - інше,

Інформація про учасника програми лояльності

Рекомендація:

Якщо у відповіді набули статусу карти"2":"Заблоковано",то проводити продаж як неідентифікованому покупцеві (у річці не передавати номер картки)

Запит інформації про учасника програми лояльності за номером телефону

GET /partner/operation/user/{type}/{token}/user-info

{type} - карта або телефон

{token} - якщо {type} - card, то заповнювати значенням номеру картки, якщо {type} - phone, то заповнювати значенням номера телефону учасника ПЛ

Приклад відповіді при успішному запиті:

{

"~~успіх"~~success":~~правда,~~ true,

"~~статус"~~status": 200,

"~~дані"~~data": {

"~~токен"~~token": "63", //Номер ~~картки~~карти

"~~дані_користувача"~~user_data": {

"~~гід"~~guid":« "533a7a29-6928-4aad-a1b3-~~051bb1717af4»~~051bb1717af4",

"~~мобільний"~~mobile": "380631024903", // номер ~~телефону~~телефона

"~~електронна~~email": ~~пошта":~~"Alyonahavrylenko@gmail.com", // email-адреса

"~~ім'я"~~first_name": "~~Хелен"~~Helen", //~~ім'я~~Імʼя

"поmiddle_name": ~~батькові":~~"", //По По-батькові

"~~прізвище"~~last_name": "~~Вчитель"~~Guru", //Прізвище

"~~створений"~~created": 1578488728, // дата реєстрації;

"~~день_народження"~~birth_day": "1999-08-08",//Дата народження

"~~Стать"~~gender": 2, //~~Пол~~Стать

"sms_notify": 1, // згода на sms-розсилку (0 - не згоден; 1 - згоден);

"email_notify": 1, // згода на ~~email-~~мейл-розсилку (0 - не згоден; 1 - згоден);

"id_region": 86, //id ~~регіону~~регіона

"id_city": 1116, //id міста

"~~адреса"~~address": "Peremogy Avenu 12",// Адреса

"~~заблоковано"~~blocked":0/ 0 //Кількість блокувань ~~учасника~~участника

"~~статус_користувача"~~user_status": [],// статус учасника;

"~~профіль"~~profile": {// додаткові поля анкети;

"work_status": 3, // статус зайнятості;

"children": 0,// наявність дітей

"has_auto": 1,// наявність авто

"family_stat": 2 // сімейний статус

"accounts_data": [

{

"~~робочий_статус"~~account":3,

~~"діти":0,~~

2620020401,

~~"has_auto":1,~~

~~"сімейна_статистика":2~~

~~"accounts_data":[~~

{

~~"рахунок":2620020401,~~// номер гаманця;

"~~валюта"~~currency": "~~ДОБРЕ"~~BON", // ~~Назва~~назва валюти лояльності;

"~~баланс"~~balance": 0, // кількість бонусів на рахунку;

"~~доступний"~~avialable":0/ 0 // кількість доступних бонусів на рахунку;

}

"cards_data": [

{

"~~номер"~~number": "2020000000259", // ~~Номер~~номер ~~картки;~~карти;

"~~статус"~~status": 3, // статус ~~картки~~карти (0 –- нова; 1 –- не заповнена; 2 –- заблокована; 3 –- платіжна);

"~~створений"~~created": 1579167842, // ~~Дата~~дата створення карти (генерації);

"~~дата_активації"~~date_activated": 1580741547, // дата активації (дата першої операції зпо карті чи дата ~~прив'язки~~привʼязки карти до гаманця) ;

"~~дата~~issue_date": ~~випуску":нуль,~~null, // ~~Дата~~дата видачі карти;

"issue_branch":~~нуль,~~ null, //~~Торгівельна~~ торгова точка в якій ~~видана~~видано ~~карта;~~карту ;

"~~дата_заблоковано"~~date_blocked": 0, // дата ~~переведення~~переводу ~~картки~~карти ув статус "заблокована";

"~~тип"~~type":1/ 1 // тип карти (1 –- основна карта, 2 –- брелок);

{

"~~номер"~~number": "63",

"~~статус"~~status": 3,

"~~створений"~~created": 1579166828,

"~~дата_активації"~~date_activated": 1579178912,

"~~дата~~issue_date": ~~випуску":нуль,~~null,

"issue_branch":~~нуль,~~ null,

"~~дата_заблоковано"~~date_blocked": 0,

"~~тип"~~type": 1

{

"~~номер"~~number": "67",

"~~статус"~~status": 2,

"~~створений"~~created": 1579166828,

"~~дата_активації"~~date_activated": 1579167114,

"~~дата~~issue_date": ~~випуску":нуль,~~null,

"issue_branch":~~нуль,~~ null,

"~~дата_заблоковано"~~date_blocked": 1579167187,

"~~тип"~~type": 1

{

"~~номер"~~number": "2020-80477",

"~~статус"~~status": 3,

"~~створений"~~created": 1578498242,

"~~дата_активації"~~date_activated": 1578910691,

"~~дата~~issue_date": ~~випуску":нуль,~~null,

"issue_branch":~~нуль,~~ null,

"~~дата_заблоковано"~~date_blocked": 0,

"~~тип"~~type": 1

}

"~~подарункові_бонуси"~~gift_bonuses": [ //Інформація зпро ~~подарункових~~подарункові ~~бонусів~~бонуси

{

"id": 268, //ID операції

"~~ім'я"~~name":~~«Для~~ ~~книг»~~"For books",// Назва нарахування

"~~бонус"~~bonus": 1000, //Кількість нарахованих бонусів

"~~відкрито_у"~~opened_at":~~1581948299/~~ 1581948299 //Дата активації бонусів

}

"~~статуси карток"~~card_statuses": {

"0": "~~новий"~~New",

"1": "~~Активний"~~Active",

"3": "~~Оплата"~~Payment",

"2": "~~Заблоковано"~~Blocked"

"~~типи_карт"~~card_types": {

"1": "~~Головний"~~Main",

"2": "~~Раб"~~Slave"

"~~загальна_витрачена_сума"~~total_amount_spent":~~13398/~~ 13398 // загальна сума покупок ~~учасника.~~учасника .

"groups": [ //список груп, д яких належить учасник

"Кайбылдаева",

"0555409355",

"фильтр",

"Чуй обл группа рассылки",

"testoce2",

"All clients",

"омурбеков тест2",

"Тест 2",

"Горобец М, два магазина, квартал",

"Мужчины все ",

"Кроме 996701037770",

"Гавриленко тест",

"Иван Иванов",

"мужчины от 20 до 30",

"тест титан",

"Для рассылки Пуш",

"\t0000001433663",

"0684607869",

"Для_Задания_2",

"Титан мужчины 2 магазина",

"Лекарь тест",

"Женщины за рулем ",

"Чуй конструктор",

"Титан все клиенты",

"Лаки Лук 1",

"1010109147909",

"Ж 20-30, МП_Горобец",

"мужчины по заданию",

"Печенье весовое",

"мужчины до 30",

"Валерия",

"5% скидка"

]

}

- Запит зміни інформації про учасника програми лояльності (редагування анкетних даних)

PUT /partner/operation/user/{type}/{token}/user-info

Назва	Тип даних	Опис
phone	рядок	Номер мобільного телефону у форматі 380#########
first_name	~~рядок~~string	Ім'я учасника ПЛ
middle_name	~~рядок~~string	По батькові учасника програми лояльності
last_name	~~рядок~~string	Прізвище учасника програми лояльності
birth_day	~~рядок~~string	Дата народження учасника програми лояльності у форматі 1989-03-17
id_region	~~ціле число~~integer	Глобальний довідник регіону проживання
id_city	~~ціле число~~integer	Глобальний довідник міста проживання пов'язаний з регіоном.
gender	~~ціле число~~integer	Стать:1 - чоловік2- жінка
sms_notify	~~ціле число~~integer	Підписатися на смс розсилку:1-Згідний0-Не згоден
email_notify	~~ціле число~~integer	Підписатися на email розсилку:1-Згідний0-Не згоден
email	~~рядок~~string	Електронна пошта у форматі abm@abmcloud.com

Приклад відповіді при успішному запиті:

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 200,

"~~даних"~~data": {

"guid":« "77f8f2d6-afad-4123-bd52-~~0db68df28e74»~~0db68df28e74",

"~~мобільний"~~mobile": "380931000013",

"~~електронною~~email": ~~поштою":~~"titkin1@ua-2.com",

"~~ім'я"~~first_name": "~~Артур"~~Artur",

"поmiddle_name": ~~батькові":~~"~~Іванович"~~Ivanovich",

"~~прізвище"~~last_name":«Я ~~досліджував»~~"Titkin",

"~~створений"~~created": 1521451738,//Дата створення

"~~день_народження"~~birth_day": "1979-04-28",

"~~Стать"~~gender": "2",

"sms_notify": "0",

"email_notify": "0",

"id_region": "91",

"id_city": "1586",

"~~заблоковано"~~blocked":1/ 1 //Кількість блокувань ~~картки~~карти

}

Інформація про картку учасника програми лояльності

Зміна статусу картки на касі

Запит оновлює дані картки:

Встановлює/змінює статус картки;
Встановлює/змінює дату видачі;
Встановлює/змінює точку видачі;
Надає карту існуючому учаснику програми.

POST /v2/partner/card/card-update

Перелік параметрів у запиті:

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
card_issue_branch	~~рядок~~string	Код торгової точки, де видали карту
card_issue_date	~~ціле число~~integer	Дата та час видачі картки передається у форматі unix time
card_number	~~рядок~~string	Номер картки учасника ПЛ, за якою оновлюються дані
card_status	~~ціле число~~integer	Картка статусу:1 - Активна/Нова2 - Заблоковано3 - Платіжна
user_card	~~рядок~~string	Номер картки учасника ПЛВикористовується для прив'язки додаткової карти	Ідентифікатор учасника програми лояльності, використовувати при необхідності прив'язки нової карти до існуючого учасника. Потрібно передавати один із цих параметрів
user_phone	~~рядок~~string	Номер телефону учасника програми лояльності до якого буде прив'язана карта, вказана в параметрі card_number

Приклад відповіді при успішному запиті:

{

"success": true,

"status": 200,

"data": {

"card_number": "10000009"

}}

Продаж

Запросити передрахунок за чеком

POST /v2/partner/operation/pre-check

Якщо користувач - учасник програми лояльності, необхідно заповнити значення в полі card або phone. Якщо користувач не є учасником програми лояльності, дані card або phone не передавати.

Дані отримані в pre-check потрібно кешувати для подальшого друку чека та відправлення даних про продаж в облікову систему клієнта.

Дані параметра meta в receipt_details відповідають значенням товару опис деталей клієнт.

перевіряє наявність купона у системі, приналежність до партнера
можливість його погашення цим користувачем на даний момент часу
пов'язує код купона з номером транзакції, до якої буде застосовано купон
робить передрахунок чека з урахуванням купону (для купону знижок)

У запиті необхідно заповнювати наявний параметр"купон"

Перелік параметрів у запиті:

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
branch_id	~~рядок~~string	Код (id) торгової точкиПопередньо має бути створений у CRM Лояльності
card	~~ціле число~~integer	Номер картки учасника ПЛ
coupon	~~рядок~~string	Код купона, якщо купонів кілька, їх необхідно записати через кому
offline	~~логічний~~boolean	Визначає режим проведення операції: 1 – офлайн, 0-онлайнСписати бонуси у режимі офлайн неможливо
operator_id	~~рядок~~string	Код касираПопередньо має бути створений у CRM Лояльності
phone	~~рядок~~string	Номер телефону учасника ПЛ
receipt_bonus_amount	~~номер~~number	Кількість бонусів за чек, які покупець хоче списати.
receipt_currency	~~рядок~~string	Валюта бонусів	Передавати значення BON
receipt_datetime	~~Ціле число~~Integer (тип: 1470825537)	Дата та час покупки за UTC(GMT) вформаті UNIX час (без часового поясу)
receipt_description	~~рядок~~string	Опис типу покупки	Звичайний продаж
receipt_details	~~рядок~~string	Деталі покупки (повний список товарів та їх властивості у квитанції) у вигляді масиву JSON. "position" - позиція в чеку. "prod_cat" – код групи товарів. "prod_code" - код SKU. "prod_name" - повна назва продукту. "prod_price" - ціна товару. "prod_amount" – кількість товару. "prod_sum" - загальна вартість продукту (зазвичай дорівнює prod_amount * prod_price). ~~bonus_restrict~~ “bonus_restrict”:true - виключити позицію з ~~розрахунку~~нарахування ~~бонусу,~~і несписання ~~потрібно,~~бонусів , “bonus_accrual_restrict”:true -виключити позицію з нарахування бонусів “discount_restrict”:true -виключити позицію зі списання бонусів ,external_discount - рармер (у грошах) зовнішньої знижки"meta":"{\"параметр1\":\"значення\", \"параметр2\":\"значення\"}"
session_id	~~ціле число~~integer	Код сесії
terminal_id	~~рядок~~string	Код каси
variables	~~рядок~~string	Дод. св-тва товару у вигляді масиву JSON Приклад: {"key1":1, "key2":1}

Важливо!!!:

1.bonus_restrict - Якщо товар продається за акцією, налаштованою в обліковій або касовій системі, передавати 1 до параметра bonus_restrict, щоб механіки лояльності по даному товару не спрацьовували.В інших позиціях цей параметр не передавати.

2. Якщо на продукт спрацьовує знижка, бонуси на цей продукт не нараховуються та не списуються.

Приклад відповіді при успішному запиті (значення в параметрі "pre_check_id" необхідно зберегти для передачі в операції підтвердження продажу )

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 201,

"~~даних"~~data": {

"pre_check": {

"pre_check_id": "1548149007.104900.03",// id ~~який~~котре необхідно буде підтвердити методом check-confirm

"~~оплата"~~payment": {

"~~гроші"~~money":~~899,~~ 899.03, // "чиста" сума до оплати (скільки грошей ~~необхідно~~покупець має заплатити ~~користувачу,~~після завсіх ~~вирахуванням дисконтних~~знижок та ~~бонусних~~списання ~~знижок~~бонусів

"~~bonus_redeeded"~~bonus_redeemed": 1, // скільки бонусів використано на оплату покупки

"~~знижка"~~discount":0/ 0/ /розмір знижки ув грошах

"~~валюта"~~currency": "~~ДОБРЕ"~~BON",// ~~Валюта~~валюта нарахування бонусів

"~~купон"~~coupon": [// купон використані в цьому чеку

{

"~~код"~~code": "3863NUM6",// номер купона

"~~успіх"~~success": ~~помилковий,~~false,// статус операції

"~~повідомлення"~~message": "~~Конфігурація~~Coupon ~~купона~~configuration ~~неактивна"~~is not active"// опис помилки

{

"~~код"~~code": "6556PRE",// ~~Номер~~номер купона

"~~успіх"~~success": ~~правда,~~true,// статус операції

"~~повідомлення"~~message": "",// назва купона

"reward_type": "1"// вид купону 1- бонус, 0 - знижка

}

], // купон ~~використовуєний~~використані зв ~~цим~~цьому ~~чеком~~чеку

"~~ідентифікатор_гілки"~~branch_id": "001", // id торгової точки

"terminal_id": "~~термінал_1"~~terminal_1",// id каси

"operator_id": "~~оператор_1"~~operator_1",// id касира

"session_id": ~~нуль,~~null, // id сесії

"receipt_amount": ~~"сума_квитанції":900,~~900.03, // повна сума чека

"~~платіжний_бонус"~~payment_bonus":~~63,~~ 63.86, // всього бонусів нараховано запо ~~чеком~~чеку

"~~базовий_бонус"~~base_bonus":~~63,~~ 63.86, // ~~Розмір~~розмір базового бонусу (кешбек)

"~~квитанція_опис"~~receipt_description":~~«Перевірочна~~ ~~перевірка»~~"Precheck test",// опис чека

"~~день~~birthday_bonus": ~~народження_бонус":~~0, // бонус ув день народження

"userStatusFixBonus": 0, // бонус за статус (~~тільки~~только ~~фіксована~~фиксирована сума ~~винагороди,~~нагороди, ~~не%~~не %)

"~~реквізити_квитанції"~~receipt_details": [// деталі чеку

{

"~~положення"~~position": 1, // номер позиції ув чеку

"prod_cat": "20316",// категорія ~~продукту~~продукта (якщо товару ~~немає~~нема ув CRM, то повертається як "0")

"prod_code": "13997",// ~~номер~~sku ~~продукту~~продукта

"prod_name": "КОНФ ~~ВАГОВІ~~ВЕСОВЫЕ ~~АСОРТІ"~~АССОРТИ",// назва продукту (якщо товару ~~немає~~нема ув CRM, то повертається як "no name product")

"prod_price": "~~100,~~100.01",// ціна ~~товару~~продукту

"prod_amount": "3",// /кількість ~~Кількість продукту (~~продуктів(шт.)

"prod_sum":~~300,~~ 300.03, // загальна вартість запо ~~позицією~~позиції ~~продукту~~продуктів

"bonus_restrict": "~~в порядку"~~1",

"~~ліміт_знижки"~~discount_limit":~~300,~~ 300.03, // максимально можлива знижка напо ~~позицію~~позиції

"~~знижка"~~discount": 0, // ~~Розмір~~розмір застосованої ~~знижки~~знижкм на позицію

"~~параметри"~~parameters": [],// ~~Додаткові~~додаткові параметри позиції, встановлені в налаштуваннях товарів (ціна, мрц, обмеження ~~щодо~~по ~~нарахування~~нарахуванню таі ~~списання~~списанню бонусів)

"discount_success": [],// інформація ~~щодо~~по успішно ~~застосованих~~застосованим ~~дисконтних~~знижковим ~~акцій~~акціям

"~~знижка_бонус"~~discount_bonus": 0, // розмір знижки ~~наданий~~представленій бонусами в грошах

"~~бонус"~~bonus": 0, // кількість ~~бонусів,~~бонусів нарахована на позицію

"bonus_success": []// детальна інформація по бонусах нарахованих на позицію

~~"бонус_успіх": []// докладна інформація щодо бонусних нарахувань на позицію~~

{

"~~положення"~~position": 2,

"prod_cat": "20316",

"prod_code": "86163",

"prod_name":~~«Текіла~~ ~~Патрон~~"Tekila ~~срібло~~Patron ~~0,5»~~silver 0.5",

"prod_price": "100",

"prod_amount": "2",

"prod_sum": 200,

"~~ліміт_знижки"~~discount_limit": 0,

"~~знижка"~~discount": 0,

"~~параметри"~~parameters": {

"~~ціна"~~price": 100,

"~~мрп"~~mrp": ~~нуль,~~null,

"~~знижка"~~discount": 0,

"max_calculation_bonus": 4,

"max_payment_bonus": 0

"discount_success": [ // ~~докладна~~детальна інформація ~~ззнижкам~~про знижки на позицію

{

"~~правило"~~rule": "~~купон"~~coupon",// ~~Тип~~тип нарахування, ~~вечірка~~купон

"action_id": 0, // id акції (для нарахування зпо акції)

"~~назва~~action_title": ~~дії":~~"",// ~~Назва~~назва акції

"~~інформація"~~info": "6556PRE",//код купону

"~~знижка"~~discount": 7.11, // розмір знижки ув грошах

"~~пріоритет"~~priority":1/ 1// ~~Пріоритет~~пріорітет акції

}

"~~знижка_бонус"~~discount_bonus": 0,

"~~бонус"~~bonus": 4,

"~~бонус_успіх"~~bonus_success": [

{

"~~правило"~~rule": "~~кешбек"~~cashback",

"action_id": 0,

"~~назва~~action_title": ~~дії":~~"",

"~~бонус"~~bonus": 4,

"~~пріоритет"~~priority": 999998

}

]

{

"~~положення"~~position": 3,

"prod_cat": "20316",

"prod_code": "77765",

"prod_name": "ПАКЕТ МАЙКА ~~ФІРМОВИЙ~~ФИРМЕННЫЙ ~~ЄЛІСЕЙ~~ЕЛИСЕЙ 12КГ",

"prod_price": "100",

"prod_amount": "2",

"prod_sum": 200,

"~~ліміт_знижки"~~discount_limit": 200,

"~~знижка"~~discount": 0,

"~~параметри"~~parameters": [],

"discount_success": [],

"~~знижка_бонус"~~discount_bonus":0, 0.5,

"~~бонус"~~bonus": 29.93,

"~~бонус_успіх"~~bonus_success": [

{

"~~правило"~~rule": "~~кешбек"~~cashback",

"action_id": 0,

"~~назва~~action_title": ~~дії":~~"",

"~~бонус"~~bonus": 29.93,

"~~пріоритет"~~priority": 999998

}

]

{

"~~положення"~~position": 4,

"prod_cat": "20316",

"prod_code": "13997",

"prod_name": "КОНФ ~~ВАГОВІ~~ВЕСОВЫЕ ~~АСОРТІ"~~АССОРТИ",

"prod_price": "100",

"prod_amount": "2",

"prod_sum": 200,

"~~ліміт_знижки"~~discount_limit": 200,

"~~знижка"~~discount": 0,

"~~параметри"~~parameters": {

"~~ціна"~~price": 100,

"~~мрп"~~mrp": 95,

"~~знижка"~~discount": 0,

"max_calculation_bonus": 200,

"max_payment_bonus": 200

"discount_success": [],

"~~знижка_бонус"~~discount_bonus":0, 0.5,

"~~бонус"~~bonus": 29.93,

"~~бонус_успіх"~~bonus_success": [

{

"~~правило"~~rule": "~~кешбек"~~cashback",

"action_id": 0,

"~~назва~~action_title": ~~дії":~~"",

"~~бонус"~~bonus": 29.93,

"~~пріоритет"~~priority": 999998

}

]

}

"sms_id": 6756, // даний параметр приходить тільки після налаштування в системі АБМ - Підтвердження списання по смс

"max_payment_bonus_check":~~2264,~~ 2264.5, // максимальна кількість бонусів для списання (ув бонусах)

"max_payment_money_check":~~226,~~ 226.45, // максимальна кількість бонусів для списання (ув грошовій одиниці з коефіцієнтом ~~переказу~~ 1 ~~бонус =~~ бонус=10 копійок, ~~у вас він~~ може ~~відрізнятися)~~відрізнятись )

"~~баланс_доступний"~~balance_available":~~100,~~ 100 , //~~Доступно~~доступно бонусів на ~~рахунку~~срахунку в учасника ~~програми лояльності~~ПЛ

"discount_fail": [],//інформація ~~щодо~~про не ~~застосованих~~застосовані ~~дисконтних акцій~~дисконти (акція активна, але в чеку не ~~дотримано~~дотримана ~~умови~~умова для її роботи)

"bonus_fail": []//інформація ~~щодо~~про не ~~застосованих~~застосовані ~~бонусних~~бонусні ~~акцій~~акції

}

Рекомендація:

- Отримані у відповіді на pre_check параметри "max_payment_bonus_check" і

-balance_available виводити на касі мінімальне з них, як «Максимально можлива кількість бонусів для списання:»

-"sms_id": 6756,- ідентифікатор смс підтвердження списання бонусів за кодом з смс

- pre_check_id – дійсний 10 днів

Приклади відповідей від АБМ під час використання купонів у чеку:

Приклад відповіді від лояльності	Значення
"~~купон"~~coupon": [ { "~~код"~~code": "1000896246", "~~успіх"~~success": ~~правда,~~true, "~~повідомлення"~~message": "", "template_name": "Купон на бонус Titan", "reward_type": 0}0 } ]	Цей купон дійсний і його можна застосувати в даному чеку
"~~купон"~~coupon": [ { "~~код"~~code": "1000110027", "~~успіх"~~success": false, "message": "~~Купон~~Coupon ~~погашено"~~redeemed" } ]	Цей купон вже погашено
"~~купон"~~coupon": [ { "~~код"~~code": "1000358936", "~~успіх"~~success": false, "message": "~~Конфігурація~~Coupon ~~купона~~configuration ~~неактивна"~~is not active" } ]	Термін дії вказаного купона минув
"~~купон"~~coupon": [ { "~~код"~~code": "1000303888", "~~успіх"~~success": false, "message": "НеWrong ~~той~~user", ~~користувач",~~ "template_name": "Купон на ~~знижку"~~скидку" } ]	Цей купон не належить зазначеному користувачеві
"~~купон"~~coupon": [ { "~~код"~~code": "1000572007", "~~успіх"~~success": false, "message": "~~Купон~~Coupon ~~застарів"~~is out of date" } ]	Термін дії вказаного купона ще не настав
"~~купон"~~coupon":[ { "~~код"~~code": "CUP20416079", "~~успіх"~~success":false, ~~false,~~ "message":"Condition ~~"Сума~~Order ~~замовлення~~sum неis ~~виконана"~~not met" } ]	Умови купона за сумою чека не виконані (сума чека менша, ніж задано в умовах купона)

Запит на підтвердження продажу

POST /v2/partner/operation/check-confirm

підтверджує проведення чека, списання та нарахування бонусів (pre_check_id- дійсний 10 днів)
застосовує купон (ставить відмітку про використання)

Перелік параметрів у запиті:

Назва	Тип даних	Опис	Відповідає значенню у Клієнта
~~коробка~~box	~~номер~~number	Кількість грошей, які будуть перераховані у бонуси згідно з коефіцієнтом списання. Має бути реалізований функціонал скарбнички.
~~номер_чек~~check_number	~~ціле число~~integer	Номер перевіркиКод операції з продажу. При формуванні має бути унікальним у розрізі партнера	Формат:Номер_чека_+_Дата_покупки
~~тип оплати~~payment_type	~~рядок~~string	Массив с типами оплат. Пример: [{"type":1,"sum":899},{"type":2,"sum":0.00}]
pre_check_id	~~рядок~~string	Код (ID) операції отриманий у відповіді на запит POST /v2/partner/operation/pre-check
sms_id	integer	Ідентифікатор смс при списанні бонусів	смс приходить тільки після налаштування в системі АБМ - Підтвердження списання по смс
code	integer	Код з смс відправнику

Приклад відповіді при успішному запиті

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 201,

"~~даних"~~data": {

"pre_check_id":"1548149007.104900.03",// ідентифікатор підтвердженого чека

"~~номер_чек"~~check_number":"100110",// Номер чека, переданий касою

"box_bonus":0,07, // бонуси передані у скарбничку

"~~бонус_нараховано"~~bonus_accrued":63,93, // нараховані бонуси

"bonus_redeeded":1,// списані бонуси, в рахунок оплати

"bonus_balance":288, //баланс бонусів у користувача після оплати чека

"c2b_result": {// відомості про ~~журнальні~~операції ~~операції~~списання

"~~успіх"~~success": ~~правда,~~true,// статус операції

"errorDescription":"",// опис ~~у разі~~ помилки

"process_transaction_datetime":1548150560,// час операції у unixtime

"c2b_check_number":"C2B-100110"// id операції списання

"b2c_результат": {// відомості про ~~журнальні~~операції ~~операції~~нарахування

"~~успіх"~~success": ~~правда,~~true,// статус операції

"errorDescription":"",// опис ~~у разі~~ помилки

"process_transaction_datetime":1548150560,// час операції у unixtime

"b2c_check_number":"B2C-100110"// id операції нарахування бонусів

"~~купон"~~coupon": [// інформація про купон

{

"~~код"~~code": "~~6067ПОПЕРЕДНЯ~~6067PRECHECK",// ~~ПЕРЕВІРКА",~~Код купону

"~~успіх"~~success": ~~правда,~~true,

"~~повідомлення"~~message": "",

"~~параметри"~~options": {

"~~отримана_знижка"~~received_discount": "~~16,~~16.85",

"redemption_count": 1

"reward_type": "1"

}

]

}

Повернення товару

POST /~~партнер/операція/чек-повернення~~partner/operation/check-return

Перелік параметрів у запиті:

Назва	Тип даних	Опис
~~ідентифікатор_гілки~~branch_id	~~рядок~~string	Код (id) торгової точки
~~номер_чек~~check_number	~~рядок~~string	Номер чека повернення
operator_id	~~номер~~number	Код касира
~~повернення_номер_чеку~~return_check_number	~~рядок~~string	Номер продажу (чека), що підлягає поверненню
~~повернення_датачас~~return_datetime	~~ціле число~~integer (тип: 1550478564)	Дата та час повернення
return_details	~~рядок~~string	Перелік кодів товарів та їх кількості, що підлягають поверненню. Приклад: [{"prod_code":"139974","prod_amount":1}]
terminal_id	~~номер~~number	Код каси

Приклад відповіді при успішному запиті

~~#Відгук~~#Відповідь для учасника програми лояльності

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 201,

"~~дані"~~data": {

"return_check_number":"471",// Номер чека продажу з якого зроблено повернення

"~~чек_номер"~~check_number":"4587",// Номер чека повернення

"branch_id":"001",// id торгової точки

"~~ідентифікатор_терміналу"~~terminal_id": ~~нуль,~~null,// id каси

"~~ідентифікатор_оператора"~~operator_id": ~~нуль,~~null,// id касира

"b2c_returned":15,// кількість бонусів повернутих на рахунок партнера

"b2c_transaction_id":471,// id транзакції повернення бонусів на рахунок партнера

"c2b_returned":0,5,// кількість бонусів повернутих на рахунок клієнта

"c2b_transaction_id":~~470,~~470,// id транзакції повернення бонусів на рахунок клієнта

"~~повідомлення"~~message": "b2c - ~~усі~~all ~~бонуси~~bonuses ~~очищені"~~cleared" // повідомлення про бонуси, що повертаються на рахунок партнера (чи вдалося повернути бонуси, якщо так, то всі бонуси або тільки частина)

}

#Відповідь для анонімного клієнта

{

"~~успіх"~~success": ~~правда,~~true,

"~~статус"~~status": 201,

"~~дані"~~data": {

"return_check_number":"CN-1570437820-db",// Номер чека продажу з якого зроблено повернення

"~~чек_номер"~~check_number":"CN-1570437820-ret",// Номер чека повернення

"branch_id":"1",// id торгової точки

"~~ідентифікатор_терміналу"~~terminal_id": ~~нуль,~~null,// id каси

"~~ідентифікатор_оператора"~~operator_id": ~~нуль,~~null,// id касира

"b2c_returned":0,// кількість бонусів повернутих на рахунок партнера

"b2c_transaction_id": ~~нуль,~~null,// id транзакції повернення бонусів на рахунок партнера

"c2b_returned":0,0,// кількість бонусів повернутих на рахунок клієнта

"c2b_transaction_id": ~~нуль,~~null,// id транзакції повернення бонусів на рахунок клієнта

"~~повідомлення"~~message":~~«Не~~ ~~потребує~~"Does ~~виконання~~not ~~транзакції»~~require transaction execution"// повідомлення про бонуси, що повертаються на рахунок партнера (чи вдалося повернути бонуси, якщо так, то всі бонуси або тільки частина)

}

Режим offline

Якщо немає можливості надіслати дані в CRM Лояльності, необхідно зберігати ці дані в окремому сховищі і вивантажити їх за регламентом рекомендується 1 - 2 рази на добу

Регламент налаштувати гнучкий, щоб клієнт міг за необхідності змінити час.

Виводити на касу в якому стані знаходиться каса – онлайн/оффлайн – списання бонусів неможливо.

Перелік операцій у режимі offline

- операції продажу

Дані з продажу анонімних покупців та учасників програми лояльності накопичуються на касі, при доступі до лояльності відправляються дані про купівлюслінним бонусам. Списати бонуси в режимі онлайннеможливо - Виводити на касу діалогове вікно: «Каса перебувати в offline режимі. Списання бонусів неможливе.».

POST /v2/partner/operation/pre-~~checkпередавати~~check передавати до параметра offline – 1(офлайн),далі застосувати метод POST /v2/partner/operation/check-confirm

- Операції повернення

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

POST /~~партнер/операція/чек-повернення~~partner/operation/check-return

Рекомендація

Щоб ідентифікувати транзакцію offline у звітах системи, рекомендуємо до номера чека додавати слово ”off”.

Приклад для POST /v2/partner/operation/check-confirm

~~номер_чек~~check_number	~~ціле число~~integer	Номер ~~перевіркиКод~~перевірки Код операції з продажу. При формуванні має бути унікальним у розрізі партнера	off+Номер_чека_+_Дата_покупки

Приклад для POST /partner/operation/check-return

~~номер_чек~~check_number	~~рядок~~string	Номер чека повернення	off+Номер_чека

Реферальна програма

~~ОПУБЛІКУЙТЕ /партнера/реферал/посилання~~

Участь у РП не є обов'язковою. Частина учасників програми лояльності може бути в РП, тоді як інша частина учасників може бути звичайними власниками карт лояльності.

Немає постійної прив'язки Реферала до Реферера. Співвідношення Реферал-Реферер може змінюватись від операції до операції.

До одного реферера може бути прив'язано кілька рефералів. Реферал може змінити свого реферера, у своїй старий зв'язок не видаляється, а перетворюється на неактивний статус.

~~арбітр~~ ~~(реферер) – учасник програми лояльності, за рекомендацією якого реферали здійснюють операції.~~

~~Реферал~~ ~~(рефері) –учасник програми лояльності, який здійснює операцію за рекомендацією іншого учасника.~~

RP ~~–реферальна програма~~

~~Зв'язок реферал -> реферер може бути створена двома способами:~~

при реєстрації, якщо майбутній учасник програми лояльності вказав ідентифікатор реферера і при цьому виконується подіяРеєстрація.

після реєстрації, якщо учасник програми лояльності вказав ідентифікатор реферера, при цьому подіяРеєстрація не виконується.

Ідентифікатор реферера може бути змінений рефералом будь-якої миті. У такому разі в системі створюється новий зв'язок реферер -> реферал, а старий зв'язок деактивується (зберігаємо для історії та звітності).

ПодіяРеєстрація вважати виконаним, якщо учасник програми лояльності заповнив всі обов'язкові поля анкети і вказав ідентифікатор свого реферера (зазначено посилання реферера на даний момент, коли користувачеві проставляється дата реєстрації в rtl_users.start_day). Після цього в системі створюється зв'язок реферер -> реферал та фіксується подіяРеєстрація.

~~Алгоритм:~~

~~Створення користувача у системі~~

~~Створення зв'язку реферер -> реферал методом /partner/referral/link~~

~~Завершення реєстрації (заповнення всіх обов'язкових полів анкети)~~

ПодіяКупівля вважати виконаним, якщо на момент покупки учасник програми лояльності є рефералом (в системі існує активний зв'язок реферер -> реферал). Після цього у системі фіксується подіяКупівля.

~~Алгоритм:~~

~~Розрахунок за чеком методом pre-check~~

~~Створення зв'язку реферер -> реферал методом /partner/referral/link~~

~~Підтвердження чека методом check-confirm~~

~~Або~~

~~Створення зв'язку реферер -> реферал методом /partner/referral/link~~

~~Розрахунок за чеком методом pre-check~~

~~Підтвердження чека методом check-confirm~~

~~Алгоритм:~~

~~Створення користувача у системі~~

~~Створення зв'язку реферер -> реферал методом /partner/referral/link~~

~~Завершення реєстрації (заповнення всіх обов'язкових полів анкети)~~

~~Назва~~	~~Тип даних~~	~~Опис~~
~~refereeToken~~	~~рядок~~	~~Твікон (номер картки/телефону хто здійснює продаж)~~
~~refereeType~~	~~рядок~~	~~Тіп ідентифікації рефері(card/phone)~~
~~referToken~~	~~рядок~~	~~Токен (номер картки/телефонуза рекомендацією якого операція відбувається)~~
~~refererType~~	~~рядок~~	~~Тип ідентифікації реферера(card/phone)~~

~~Приклад успішної відповіді:~~

{

~~"успіх": правда,~~

~~"статус":201,~~

~~"даних": {~~

~~"refererType":"карта",~~

~~"referToken":"20000000001",~~

~~"refereeType":"карта",~~

~~"refereeToken":"20000000001"~~

}

Помилки

Код помилки	Текст відповіді від сервера АБМ	Причина
~~попередня перевірка~~pre-check (~~продаж)~~Продаж)
401	"name": "~~Неавторизовано"~~Unauthorized", "message": "~~Ваш~~Your ~~запит~~request ~~було~~was ~~зроблено~~made зwith ~~недійсними~~invalid ~~обліковими даними.~~credentials.",	Помилка авторизації. Неправильно вказано токен.
404	"name": "НеNot ~~знайдено"~~Found", "message": "~~Сторінка~~Page неnot ~~знайдена.~~found.",	Допущена помилка на адресі сервера
422	"field": "receipt_details", "message": "~~Деталі~~Receipt ~~квитанції~~Details неcannot ~~можуть~~be ~~бути пустими.~~blank."	Допущено помилку в деталях чека (розділювач, параметри тощо)
422	"field": "branch_id","message": "~~Партнерська~~Partner ~~філія~~branch неnot ~~знайдена"~~found"	Торговельну точку з таким Id не знайдено
422	"field": "~~змінні"~~variables", "message": "~~Недійсний~~Invalid ~~формат~~variables ~~змінних"~~format"	Помилка у синтаксисі змінної для акції
422	"field": "~~картка"~~card", "message": "~~картка~~Card неnot ~~знайдена"~~found"	Вказаної карти немає в програмі лояльності
422	"field": "~~помилки"~~errors", "message": "~~Користувача~~User неnot ~~знайдено"~~found"	Вказаного користувача немає в лояльності
422	"field": "receipt_bonus_amount", "message": "~~Максимум~~Maximum 330 ~~бонусів"~~bonuses"	Перевищено ліміт зі списання бонусів
422	"field": "~~телефон"~~phone", "message": "~~Користувач~~User ~~заблоковано"~~is blocked"	Якщо користувач заблоковано
422	"field": "terminal_id", "message": "~~Термінал~~Terminal неnot ~~знайдено"~~found"	Каса з таким Id не знайдено
422	"field": "operator_id", "message": "~~Оператор~~Operator неnot ~~знайдено"~~found"	Касира з таким Id не знайдено
500	"~~Внутрішня~~Internal ~~помилка~~Server ~~сервера"~~Error"	Зовнішня помилка сервера
check-confirm(Продаж)
422	"field": "payment_type", "message": "~~Сума~~The ~~чека~~amount неof ~~збігається~~the зcheck ~~сумою~~does ~~переказу~~not вmatch and the amount transferred in the payment_type."	Сума оплати не відповідає потрібній
422	"field": "payment_type", "message": "~~Неправильний~~Wrong ~~тип~~payment ~~платежу.~~type."	Помилка синтаксису в "payment_type"
422	"field": "pre_check_id", "message": "~~Попередня~~Pre ~~перевірка~~check неnot ~~знайдена.~~found."	pre_check_id не знайдено
422	"field": "pre_check_id","message": "~~Ідентифікатор~~Pre ~~попередньої~~Check ~~перевірки~~Id неcannot ~~може~~be ~~бути порожнім.~~blank."	"pre_check_id" не передано
422	"field": "check_number", "message": "~~Такий~~Such ~~номер~~check ~~чеку~~number ~~вже~~already ~~існує"~~exists"	Такий номер check_number вже зайнятий
422	"field": "payment_type", "message": "~~Тип~~Payment ~~платежу~~Type неcannot ~~може~~be ~~бути пустим.~~blank."	"payment_type" не передано
422	"field": "pre_check_id", "message": "ЦюThis ~~перевірку~~check ~~вже~~has ~~підтверджено.~~already been confirmed."	pre_check_id не правильний або був раніше підтверджений
500	"~~Внутрішня~~Internal ~~помилка~~Server ~~сервера"~~Error"	Зовнішня помилка сервера
check-return (Повернення)
422	"field":"return_details","message":"~~Неможливо~~Unable ~~повернути~~to ~~товар~~return product 1930612	Неможливо повернути продукт із цим кодом, його нею у зазначеному чеку або повернення цього продукту вже здійснено
422	"field":"return_check_number","message":"~~Чек~~Check неnot ~~знайдено"~~found"	Зазначений чек для повернення не знайдено у програмі лояльності
500	"~~Внутрішня~~Internal ~~помилка~~Server ~~сервера"~~Error"	Зовнішня помилка сервера