Базовые возможности внешних скидок позволяют получить в ответе на запрос фиксированный процент или значение скидки на весь заказ, а также указывать, что на часть позиций заказа скидка не действует.
С помощью новой функции внешних скидок можно запросить величину скидки за одну штуку на конкретную позицию.
Для подключения данного функционала необходимо написать обращение в техническую поддержку.
В запросе GET /admin/orders/:order_id.json передается вся информация по заказу.
Пример ответа для таких внешних скидок (JSON):
{
"discount": 0,
"discount_type": "MONEY",
"discounts_per_piece": {vartiant_id_1: 100, variant_id_2: 200},
"title": "Скидка по промокоду",
"external_id": "promo-code"
},
{
"discount": 0,
"discount_type": "MONEY",
"discounts_per_piece": {vartiant_id_1: 300, variant_id_2: 500},
"title": "Списание бонусных баллов",
"external_id": "bonus"
}При необходимости можно подключить автоматический перерасчет при добавлении позиций заказа. Доступно как для новых внешних скидок, так и для старых внешних скидок.
В discounts_per_piece задается скидка за одну штуку для каждой позиции.
Если возвращается несколько скидок, то надо задать external_id, чтобы система при изменении состава заказа (например, при добавлении позиций) смогла правильно сопоставить ответ внешней системы и имеющиеся скидки.
Платформа не поддерживает:
discounts_per_piece по variant_idНовая и старая версии чекаута поддерживают скидку discounts_per_piece по variant_id.
Отдельной кнопки discounts_per_piece нет. Так называется объект в ответе расчетчика: номер варианта товара и скидка в рублях на одну штуку. Несколько скидок в одном ответе передаются массивом.
Скидки различает поле external_id (например, промокод и списание баллов). Эти скидки одного ответа складываются. С купоном магазина, скидкой группы и правилом скидки внешняя скидка не складывается - при пересчёте корзины платформа оставляет источник с большей суммой. Нативные бонусы на этом шаге тоже участвуют в выборе. Но, если покупатель при оформлении включил «списать бонусы», при сохранении заказа эта скидка добавляется сверху к уже выбранной. Если в магазине несколько адресов расчётчика, сработает адрес с большей суммой скидок.
Пересчёт при смене состава корзины пойдёт после создания записи, если у неё включена зависимость от строк заказа. После сохранения заказа правка строк не обратится к расчетчику самостоятельно.
Одинаковая корзина и один и тот же покупатель могут взять прошлый ответ из памяти до одного часа. Принудительно расчётчик спрашивают при начале оформления и при сохранении заказа. Простое открытие корзины прошлый ответ из памяти не сбрасывает.
variant_id в разных строках и округлениеОдинаковый номер варианта в двух строках получает одну и ту же скидку за штуку. Комплект в составе набора этим ключом не скидывается.
Сумма по строке равна скидке за штуку, умноженной на количество. Скидка за штуку округляется до копеек, затем снова умножается на количество. Если из-за этого общая скидка изменится на копейку, платформа пытается поправить одну строку. Правка возможна, только если цена штуки остаётся в целых копейках.
Отдельной подписи запроса нет. Штатная проверка — логин и пароль в адресе расчётчика, обычная базовая авторизация HTTP. Платформа не проверяет сертификат вашего сервера.
client есть его номер и признак registered. У гостя нет сохранённого покупателя.Подпись тела отсутствует, до создания заказа поля id, number и key пустые.
{
"id": null,
"number": null,
"key": null,
"account_id": 0,
"items_price": 3000.0,
"total_price": 3000.0,
"client": { "id": 100, "registered": true, "bonus_points": 0 },
"order_lines": [
{ "id": null, "variant_id": 501, "product_id": 80, "quantity": 2, "sale_price": 1500.0, "title": "Товар" }
]
}Ответ расчётчика — один объект или массив. Нужны discount и title. При скидке за штуку discounts_per_piece обязателен, discount можно передать нулём. external_id различает скидки внутри массива. Ответ должен прийти за 3 секунды с кодом 200 и быть JSON. Иначе скидка не применится. Сумма скидок одного ответа не может быть больше стоимости товаров.
[
{
"discount": 0,
"discount_type": "MONEY",
"title": "Промокод",
"external_id": "promo",
"discounts_per_piece": { "501": 100 }
},
{
"discount": 0,
"discount_type": "MONEY",
"title": "Баллы",
"external_id": "bonus",
"discounts_per_piece": { "501": 50 }
}
]
В данном примере для двух штук варианта 501 первая скидка будет составлять 200 рублей, вторая - 100 рублей.
Штатного резерва внешнего баланса нет. Платформа только уменьшает цену заказа. Два оформления могут получить одну и ту же внешнюю скидку.
Удержать баланс должен ваш расчётчик в момент ответа. Заказ после этого могут не создать. Повторного вызова вашего адреса при создании, неоплате, отмене и возврате нет.
Расчётчик на события создания, неоплаты, отмены, полном и частичном возврате повторно не вызывается.
Можно ли использовать нативный бонусный счёт/историю с внешним начислением, полностью отключив автоматическое процентное начисление и автоматическое списание, чтобы не было двух механизмов одновременно?
Счёт и историю использовать можно. Внешнее начисление — это запись в историю бонусов через API, положительное число баллов. Процент начисления в настройках бонусной системы нужно указать "0". Тогда оплата заказа самостоятельно баллы не добавит. Автоматического фонового списания нет. Баллы магазина списываются, только если покупатель сам включил их при оформлении заказа. Не включайте эту галочку, если те же баллы уже приходят скидкой из расчётчика. Иначе при сохранении заказа скидки сложатся. Скидка из расчётчика сама баланс магазина не уменьшает.
Баллы меняют баланс сразу. У отдельного начисления нет даты, с которой оно доступно, и нет своего срока сгорания. Дата в ручной записи — только дата в истории.
Как безопасно проверить интеграцию на тестовых заказах/staging без включения программы для всех покупателей?
Отдельного режима «только этот покупатель» нет. Включённая внешняя скидка считается для корзин всего магазина, если сработал её фильтр. Данные тестового стенда и боевого магазина одни. Проверка на стенде — проверка этого же магазина.
Безопасный путь: расчётчик для всех, кроме одного тестового покупателя, возвращает скидку 0 и пустой заголовок. Такой ответ не станет скидкой. Либо заведите поле оформления, которое заполняет только тест, и привяжите запрос к этому полю. Пока запись выключена, запросов нет.
Минимальный технический контракт для проверки:
variant_id при количестве >1,Это тело POST-запроса, которое платформа отправляет на адрес расчётчика до сохранения заказа. Номер заказа ещё пустой. Скидку расчётчик из этого тела не читает: её ещё нет, её нужно посчитать.
В живом запросе полей больше: адрес целиком, куки, источники перехода, пустая история изменений заказа. Для расчёта скидки за штуку нужны order_lines и client.
{
"id": null,
"key": null,
"number": null,
"account_id": 2942166,
"currency_code": "RUR",
"fulfillment_status": "new",
"financial_status": "pending",
"items_price": 3000.0,
"delivery_price": 0.0,
"full_delivery_price": 0.0,
"total_price": 3000.0,
"discounts": [],
"discount": null,
"client": {
"id": 100,
"registered": true,
"email": "buyer@example.com",
"name": "Иван",
"phone": "+79990000000",
"bonus_points": 0,
"client_group_id": null
},
"order_lines": [
{
"id": null,
"order_id": null,
"variant_id": 501,
"product_id": 80,
"sku": "SKU-501",
"title": "Товар",
"quantity": 2,
"sale_price": 1500.0,
"full_sale_price": 1500.0,
"total_price": 3000.0,
"full_total_price": 3000.0,
"discounts_amount": 0.0,
"bundle_id": null
}
]
}У гостя в client нет сохранённого id, а registered равен false. Две штуки варианта 501 в ответе считаются так: скидка за штуку умножается на quantity. Для 100 рублей за штуку это 200 рублей.