Скидки

Вы можете установить скидку на весь чек или на конкретную позицию. Рассказываем, как это сделать!

Чтобы устанавливать скидки, вам понадобится специальное расширение — это набор полей API, отвечающий за определённые возможности и подключаемый дополнительно на ваше усмотрение. Подключить расширение можно в личном кабинете (ЛК) LIFE POS или через API.

Чтобы начать работу с расширением, объявите его в заголовке запроса в параметре X-LP-Client-Extensions. Подставьте discounts вместо %extension_name%:

Объявление расширения в заголовке запроса

curl -i -X GET \
   -H "Authorization:eyJhbGciOiJI.eyJzdWIiOiIxMjM0NTY.SflKxwRJSMeKK" \
   -H "Accept-Language:ru-RU" \
   -H "X-LP-Client-Identifier:unique_id" \
   -H "X-LP-Client-Type:App" \
   -H "X-LP-Client-Extensions:%extension_name%" \
 'https://api.life-pos.ru/v4/orgs/123e4567-e89b-12d3-a456-123456780000/deals/sales'

При подключении расширения вы можете ограничить максимальный размер скидки. Для этого укажите необязательный параметр max_value_percentage с числовым значением от 1 до 99. Это максимально допустимая скидка в процентах от полной стоимости товара. Если скидка указана в копейках, LIFE POS сам переведёт значение max_value_percentage в копейки и сравнит числа.

Рассмотрим работу расширения discounts, отвечающего за скидки. Когда вы его подключите, сможете передавать в запросе на создание продажи объект extensions.discounts.

Скидка на чек

Предположим, вы хотите сделать скидку 10% на всю продажу. Для этого передайте в объекте extensions.discounts поле sale_discount_percentage. Оно может иметь любое целое значение от 1 до 100 включительно.

Пример кода:

"extensions": {
        "discounts": {
            "sale_discount_percentage": 10
                }
            ],
            "version": "1.0"
        }
    },

Скидка на позицию

Если нужно сделать скидку на отдельную позицию, то в запросе на продажу в блоке positions сразу укажите цену позиции с учётом скидки. Затем в объекте extensions.discounts передайте размер скидки и исходную цену. Для этого добавьте массив deal_position_discounts, включающий в себя по одному элементу на каждую позицию, на которую вы хотите сделать скидку. Каждый элемент массива deal_position_discounts — это объект со следующими полями:

• deal_position_guid — идентификатор позиции, к которой относится скидка.
• sale_price_discount — объект, описывающий скидку.
• original_sale_price_value — исходная цена; указывается в копейках.

Объект sale_price_discount описывается следующими полями:

• type – тип скидки. Возможные значения: Percentage, Absolute.
• amount – размер скидки. Если type=Percentage, это число от 1 до 100; если type=Absolute, это размер скидки в копейках. Обратите внимание, что скидка в копейках применяется не ко всей позиции, а к единице товара. Если вы хотите сделать скидку 50 рублей на позицию, в которой два товара, то в поле amount следует указать 2500 копеек.

Скидка 10% на позицию с исходной ценой 100 рублей (10 000 копеек):

"extensions": {
    "discounts": {
        "deal_position_discounts": [
            {
                "deal_position_guid": "4c1b13fc-f547-4913-8f29-4840259a399b",
                "sale_price_discount": {
                    "type": "Percentage",
                    "amount": 10
                    },
                "original_sale_price_value": 10000
            }
        ],
        "version": "1.0"
    }
},

Скидка 102,45 рублей (10 245 копеек) на товар с ценой в 150 рублей (15 000 копеек):

"extensions": {
    "discounts": {
        "deal_position_discounts": [
            {
                "deal_position_guid": "4c1b13fc-f547-4913-8f29-4840259a399b",
                "sale_price_discount": {
                    "type": "Absolute",
                    "amount": 10245
                },
                "original_sale_price_value": 15000
            }
        ],
        "version": "1.0"
    }
},

Вот и всё, что нужно знать о скидках. В следующей статье поговорим о продаже маркированных товаров.