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

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

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

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

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

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

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

Ім'яТипОбов'язковийОпис
drugstore_idstringТакІдентифікатор аптеки (з бази даних аптеки)
cash_register_numberstring | nullНіІдентифікатор каси
pharmacist_idstringТакІдентифікатор фармацевта
customerarray | nullНіДані покупця
customer.phonestring | nullНіНомер телефона покупця
customer.card_numberstring | nullНіНомер бонусної карти покупця
customer.confirmation_codestring | nullНіКод підтвердження списання бонусних балів
customer.amount_of_bonuses_to_write_offnumeric | nullНіКількість бонусів для списання
documentarrayТакДані чека
document.idstring | nullНіУнікальний ідентифікатор (GUID) документу (чек)
⚠️ GUID повинен бути ідентичним document.id в запиті analyze_after_sell
document.numberstring | nullНіВнутрішній номер чека
document.fiscal_numberstring | nullНіФіскальний номер чека
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 - не нараховувати бонуси і знижки
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
увага
  • Кожен клієнт (аптека) підтверджує списання бонусів тільки якщо сума списання більше певної суми X. Для списання бонусів, сума яких більше X, необхідно передати параметр amount_of_bonuses_to_write_off та confirmation_code
  • Якщо сума списання менше X, то запитувати код підтвердження не потрібно і достатньо передати параметр amount_of_bonuses_to_write_off
  • Кожна аптека встановлює своє значення суми X

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

Запит: /api/v1/promotion/analyze-before-sell
{
    "drugstore_id": "969",
    "cash_register_number": "7890",
    "pharmacist.id": "000001",
    "customer": {
        "phone": "380997654321",
        "card_number": "969000000013",
        "amount_of_bonuses_to_write_off": 11,
        "confirmation_code": "199928"
    },
    "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
}
інформація

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

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

Ім'яТипОпис
documentobjectПараметри чека
document.idstringУнікальний ідентифікатор (GUID) документу (чек)
document.numberstringВнутрішній номер чека
document.datestringДата і час формування чека
document.totalfloatПовна вартість товару в чеку
document.total_initialfloatВартість товару в чеку з урахуванням знижок
document.bonus_to_write_offfloatКількість бонусів для списання
document.bonus_to_write_off_max_amountfloatКількість бонусів доступна до списання в поточному стані документу
document.bonus_to_accruefloatКількість бонусів для нарахування
document.bonus_to_accrue_from_changefloatКількість решти яку переведено в бонус
document.amount_of_cashfloatГотівка, яку дав покупець
document.amount_of_changefloatРешта, яку треба дати покупцю
contentlist[object]Товари в чеку
content.idstringУнікальний ідентифікатор (GUID) позиції в чеку
content.goods_idstringІдентифікатор товару
content.price_buyfloatЗакупівельна вартість
content.price_retailfloatРоздрібна вартість
content.price_newfloatЦіна товару з урахуванням знижок. Якщо немає ніяких знижок - дублюється роздрібна ціна. Якщо є знижка - ціна з урахуванням знижки або фіксована ціна на товар
content.quantityfloatКількість товару в чеку
content.discountfloatСума або відсоток знижки
content.bonusfloatКількість отриманих бонусів за покупку
content.quantity_partfloatКількість безоплатних товарів по акції
pharmacistobjectПараметри фармацевта
pharmacist.idstringІдентифікатор фармацевта
pharmacist.full_namestringПовне ім'я фармацевта
pharmacist.emailstringЕлектронна пошта фармацевта
pharmacist.phonestringНомер телефона фармацевта
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Значення параметра бонуса
customerobjectПараметри покупця
customer.first_namestringІм'я покупця
customer.last_namestringПрізвище покупця
customer.middle_namestringПо-батькові покупця
customer.emailstringЕлектронна пошта покупця
customer.citystringМісто проживання покупця
customer.phonestringНомер телефона покупця
customer.card_numberstringНомер бонусної карти покупця
customer.birthdaystringДата народження покупця
customer.bonusesfloatКількість бонусів на рахунку покупця

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

200 OK

Відповідь: /api/v1/promotion/analyze-before-sell
{
    "data": {
        "document": {
            "id": "f2a28abd-34d3-4ea1-9153-5beb50cd56ca",
            "number": "1234",
            "date": "2023-03-30 11:20",
            "total": 123.75,
            "total_initial": 123.75,
            "bonus_to_write_off": 0,
            "bonus_to_write_off_max_amount": 122.75,
            "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": {
            "first_name": "Anna",
            "last_name": "Anna",
            "middle_name": "Anna",
            "email": "[email protected]",
            "city": "Полтава",
            "phone": "380997654321",
            "card_number": "969000000013",
            "birthday": "08.08.1993",
            "bonuses": 9715
        }
    }
}

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

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

Відповідь: 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": "Помилка сервера" 
}