Перейти до основного вмісту

Отримання чека з доступними акціями (з операціями списання і нарахування)​

URI: /api/v1/promotion/analyze-after-sell

Метод використовується для отримання чека з доступними акціями, з виконанням операцій списання та нарахування бонусів.

Запит виконується методом POST у json форматі з даними.

⚠️ Запит повинен містити заголовок Accept: application/json

Параметри запиту​

Ім'яТипОбов'язковийОпис
drugstore_idstringТакІдентифікатор аптеки (з бази даних аптеки)
cash_register_numberstringТакІдентифікатор каси
pharmacist_idstringТакІдентифікатор фармацевта
documentarrayТакДані чека
document.idstringТакУнікальний ідентифікатор (GUID) документу (чек)
⚠️ GUID повинен бути ідентичним document.id в запиті analyze_before_sell
document.numberstringТакВнутрішній номер чека
document.fiscal_numberstringТакФіскальний номер чека
document.datedateТакДата і час формування чека, в форматі Y-m-d H:i
Формат часу - 24 години
document.amount_of_cashfloat | nullНіГотівка, яку дав покупець
document.amount_of_change_to_bonusfloat | nullНіКількість решти яку перевести в бонус
document.contentarrayТакТовари в чеку
document.content.*.idstringТакУнікальний ідентифікатор (GUID) позиції в чеку
document.content.*.goods_idstringТакІдентифікатор товару
document.content.*.quantitynumericТакКількість товару в чеку
document.content.*.price_buynumericТакЗакупівельна вартість
document.content.*.price_retailnumericТакРоздрібна вартість
document.content.*.activebooleanНіПараметр товару в чеку
true - нараховувати бонуси і знижки
false - не нараховувати бонуси і знижки
customerarray | nullНіДані покупця
customer.phonestring | nullНіНомер телефона покупця
customer.card_numberstring | nullНіНомер бонусної карти покупця
customer.confirmation_codestring |nullНіКод підтвердження списання бонусних балів
customer.amount_of_bonuses_to_write_offnumeric | nullНіКількість бонусів для списання
channelstring | nullНіКанал продажу:
  • insurance
  • call_center
  • online
  • offline
  • insulin
  • reimbursement
  • hesed
sourcestring | nullНіТорговий майданчик:
  • bond
  • glovo
  • telegram
  • zdorovi
  • own
  • *
  • atb
  • liki
  • viber
  • helsi
  • optimapharm
  • aptekaskarb
  • tabletki
  • geoapteka
  • liki24
promocodestringНіПромокод (для спрацювання акцій які діють за промокодом)
увага
  • Кожен клієнт (аптека) підтверджує списання бонусів тільки якщо сума списання більше певної суми X. Для списання бонусів, сума яких більше X, необхідно передати параметр amount_of_bonuses_to_write_off та confirmation_code
  • Якщо сума списання менше X, то запитувати код підтвердження не потрібно і достатньо передати параметр amount_of_bonuses_to_write_off
  • Кожна аптека встановлює своє значення суми X

Приклад запиту​

Запит: /api/v1/promotion/analyze-after-sell
{
    "drugstore_id": "969",
    "cash_register_number": "7890",
    "pharmacist.id": "000001",
    "customer": {
        "phone": "380997654321",
        "card_number": "969000000013",
        "confirmation_code": "199928",
        "amount_of_bonuses_to_write_off": 11
    },
    "document": {
        "id": "f2a28abd-34d3-4ea1-9153-5beb50cd56ca",
        "number": "1234",
        "fiscal_number": "86960",
        "date": "2023-03-30 23:20",
        "document.amount_of_cash": 205,
        "document.amount_of_change_to_bonus": 0.5,
        "content": [
            {
                "id": "f2a28abd-34d3-4ea1-9153-5beb50cd56ca",
                "goods_id": "1057426",
                "quantity": 5.5,
                "price_buy": 15.75,
                "price_retail": 22.5,
         "active":true
         }
      ]
   },
   "channel": "offline",
   "source": null,
   "promocode": "PROMO123"
}
інформація

Алгоритм відправки запитів із обробкою помилок та повторними спробами знаходиться за посиланням

Параметри відповіді​

Ім'яТипОпис
documentobjectПараметри чека
document.idstringУнікальний ідентифікатор (GUID) документу (чек)
document.numberstringВнутрішній номер чека
document.datestringДата і час формування чека
document.bonus_to_write_offfloatКількість бонусів для списання
document.bonus_to_write_off_max_amountfloatКількість бонусів доступна до списання в поточному стані документу
document.bonus_to_accrue_from_changefloatКількість решти яку переведено в бонус
document.amount_of_cashfloatГотівка, яку дав покупець
document.amount_of_changefloatРешта, яку треба дати покупцю
document.contentlist[object]Товари в чеку
document.content.idstringУнікальний ідентифікатор (GUID) позиції в чеку
document.content.goods_idstringІдентифікатор товару
document.content.quantityfloatКількість товару в чеку
document.content.price_buyfloatЗакупівельна вартість
document.content.price_retailfloatРоздрібна вартість
document.content.price_newfloatЦіна товару з урахуванням знижок. Якщо немає ніяких знижок - дублюється роздрібна ціна. Якщо є знижка - ціна з урахуванням знижки або фіксована ціна на товар
document.content.discountfloatСума або відсоток знижки
document.content.bonusfloatКількість отриманих бонусів за покупку
document.content.quantity_partfloatЧастина товарів по акції
promotionobjectПараметри акції
promotion.namestringНазва акції
promotion.date_fromstringДата з якої діє акція
promotion.date_tostringДата до якої діє акція
promotion.typeobjectТип акції
promotion.type.namestringНазва типу акції
promotion.type.descriptionstringОпис типу акції
promotion.parametersobjectПараметри знижки
promotion.parameters.bonus_percentobjectПараметри бонуса у % від роздрібної ціни
promotion.parameters.bonus_percent.namestringНазва параметра бонуса
promotion.parameters.bonus_percent.descriptionstringОпис параметра бонуса
promotion.parameters.bonus_percent.valuefloatЗначення параметра бонуса
pharmacistobjectПараметри фармацевта
pharmacist.idstringІдентифікатор фармацевта
pharmacist.full_namestringПовне ім'я фармацевта
pharmacist.emailstringЕлектронна пошта фармацевта
pharmacist.phonestringНомер телефона фармацевта
customerobjectПараметри покупця
customer.customerobjectПараметри покупця
customer.customer.first_namestringІм'я покупця
customer.customer.last_namestringПрізвище покупця
customer.customer.middle_namestringПо-батькові покупця
customer.customer.emailstringЕлектронна пошта покупця
customer.customer.citystringМісто проживання покупця
customer.customer.phonestringНомер телефона покупця
customer.customer.card_numberstringНомер бонусної карти покупця
customer.customer.birthdaystringДата народження покупця
customer.customer.bonusesfloatКількість бонусів на рахунку покупця
customer.customer.typeobjectТип карти
customer.customer.type.idstringID типу карти
customer.customer.type.namestringНазва типу карти
customer.bonus_accountsobjectsБлок містить деталізацію по подарунковим бонусам клієнта
customer.bonus_accounts.typestringТип бонусного рахунку
customer.bonus_accounts.amountfloatКількість подарункових бонусів, доступна для оплати товару з даного бонусного рахунку
customer.bonus_accounts.date_fromstringДата та час активації бонусів
🛈 Початковий час, з якого бонуси можуть бути використані
customer.bonus_accounts.date_tostringДата та час згоряння бонусів
🛈 Кінцевий термін, після настання якого бонуси стають недійсними (неактивними) і не можуть бути списані
customer.bonus_accounts.write_off_percent_from_totalfloatМаксимальний відсоток від загальної суми чека, який можна оплатити бонусами з цього рахунку
🛈 Значення 100 означає, що цими бонусами можна покрити всю суму покупки, якщо не встановлено інших обмежень
customer.bonus_accounts.commentstringКоментар. Передається назва подарункових бонусів
customer.bonus_accounts.goods_idsarrayСписок ID товарів, на які поширюються обмеження списання бонусів
  • Якщо масив порожній ([]), це означає, що обмежень на списання бонусів немає (бонуси можна використати для будь-якого товару)
  • Якщо вказані ID, то бонуси з цього рахунку можна списати лише на ці товари
messagestringПовідомлення про результат списання / нарахування бонусів
codeintegerКод відповіді від сервера

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

200 OK

Відповідь: /api/v1/promotion/analyze-after-sell
{
    "data": {
        "document": {
            "id": "f2a28abd-34d3-4ea1-9153-5beb50cd56ca",
            "number": "22",
            "date": "2023-03-30 11:20",
            "total": 118.75,
            "total_initial": 123.75,
            "bonus_to_write_off": 0,
            "bonus_to_write_off_max_amount": 0,
            "bonus_to_accrue": 4.5,
            "bonus_to_accrue_from_change": 0.5,
                "amount_of_cash": 205,
                "amount_of_change": 0,
            "content": [
                {
                    "id": "f2a28abd-34d3-4ea1-9153-5beb50cd56ca",
                    "goods_id": "1057426",
                    "price_buy": 15.75,
                    "price_retail": 22.5,
                    "price_new": 22.5,
                    "quantity": 5.5,
                    "discount": null,
                    "bonus": 4.5,
                    "quantity_part": null
                }
            ]
        },
        "pharmacist": {
            "id": "000001",
            "full_name": "Test",
            "email": "[email protected]",
            "phone": "380991234567"
        },
        "promotion": {
            "name": "Test for analyze 2",
            "date_from": "2023-03-26",
            "date_to": "2023-04-01",
            "type": {
                "name": "Бонус у відсотках",
                "description": "Нарахувати бонус при купівлі SKU, у відсотку від роздрібної ціни в торговій точці"
            },
            "parameters": {
                "bonus_percent": {
                    "name": "bonus_percent",
                    "description": "Розмір бонусу у % від роздрібної ціни",
                    "value": 20
                }
            }
        },
         "customer": {
            "customer": {
                "first_name": "Фесенко",
                "last_name": "Анна",
                "middle_name": "test",
                "email": "[email protected]",
                "city": "Полтава",
                "phone": "380999808034",
                "card_number": "3809998080340",
                "birthday": "16.07.1993",
                "bonuses": 32,
                "type": {
                    "id": "ded7f987-719c-41ac-ad53-fe26ab83490d",
                    "name": "Універсальна"
                }
            },
            "bonus_accounts": [
                {
                    "type": "gift",
                    "amount": 20,
                    "date_from": "2025-09-29 00:00:00",
                    "date_to": "2025-10-06 00:00:00",
                    "write_off_percent_from_total": 100,
                    "comment": "ТЕСТ Деталізація подарункових бонусів 3",
                    "goods_ids": [
                        "UT-00030353",
                        "UT-00117645",
                        "UT-00000056",
                        "UT-00030373",
                        "UT-00030389",
                        "UT-00030374",
                        "UT-00030357",
                        "UT-00030348",
                        "00-00025964",
                        "00-00003149"
                    ]
                },
                {
                    "type": "gift",
                    "amount": 12,
                    "date_from": "2025-09-29 00:00:00",
                    "date_to": "2025-10-06 00:00:00",
                    "write_off_percent_from_total": 100,
                    "comment": "ТЕСТ Деталізація подарункових бонусів 3",
                    "goods_ids": [
                        "UT-00034001",
                        "UT-00034003",
                        "UT-00034002"
                    ]
                }
            ]
        }
    }

Приклади неуспішних відповідей​

Код підтвердження для списання бонусів не існує​

Відповідь: 400 Bad Request
{
    "message": "Код підтвердження для списання бонусів не існує" 
}

Термін дії коду підтвердження для списання бонусів завершений​

Відповідь: 400 Bad Request
{
    "message": "Термін дії коду підтвердження для списання бонусів завершений" 
}

Кількість бонусів до списання не відповідає заявленій​

Відповідь: 400 Bad Request
{
    "message": "Кількість бонусів до списання не відповідає заявленій"   
}

Необхідний код підтвердження списання бонусів, можна списати без підтвердження до X бонусів​

Відповідь: 400 Bad Request
{
    "message": "Необхідний код підтвердження списання бонусів, можна списати без підтвердження до X бонусів"  
}

Код підтвердження для списання бонусів вже використано​

Відповідь: 400 Bad Request
{
    "message": "Код підтвердження для списання бонусів вже використано" 
}

Недостатньо бонусів на рахунку​

Відповідь: 400 Bad Request
{
    "message": "Недостатньо бонусів на рахунку"  
}

Для даного чеку немає активних акцій​

Відповідь: 400 Bad Request
{
    "message": "Для даного чеку немає активних акцій"  
}

Подарункового сертифікату не існує​

Відповідь: 400 Bad Request
{
    "message": "Подарункового сертифікату не існує" 
}

Подарунковий сертифікат використаний​

Відповідь: 400 Bad Request
{
    "message": "Подарунковий сертифікат використаний"  
}

Подарунковий сертифікат не активний​

Відповідь: 400 Bad Request
{
    "message": "Подарунковий сертифікат не активний" 
}

За даним каналом продажу бонус не може бути списаний​

Відповідь: 400 Bad Request
{
    "message": "За даним каналом продажу бонус не може бути списаний" 
}

Недостатньо готівки для цього документа, готівка повинна бути не менше ніж:​

Відповідь: 400 Bad Request
{
    "message": "Недостатньо готівки для цього документа, готівка повинна бути не менше ніж:"  
}

Сума решти, конвертована в бонус, перевищує суму решти​

Відповідь: 400 Bad Request
{
    "message": "Сума решти, конвертована в бонус, перевищує суму решти"  
}

Сума готівки не вказана​

Відповідь: 400 Bad Request
{
    "message": "Сума готівки не вказана" 
}

Внутрішня помилка в системі аналізу документів​

Відповідь: 500
{
    "message": "Внутрішня помилка в системі аналізу документів" 
}

Помилка сервера​

Відповідь: 500
{
    "message": "Помилка сервера" 
}

Карта заблокована​

Відповідь: 500
{
    "message": " The card is locked"
}