Топ-100

Произвольная скидка

Базовые возможности внешних скидок позволяют получить в ответе на запрос фиксированный процент или значение скидки на весь заказ, а также указывать, что на часть позиций заказа скидка не действует.

С помощью новой функции внешних скидок можно запросить величину скидки за одну штуку на конкретную позицию.

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

Описание

В запросе 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. Платформа не проверяет сертификат вашего сервера.

  1. В теле лежит заказ. До сохранения заказа номер заказа пустой.
  2. У вошедшего покупателя в блоке client есть его номер и признак registered. У гостя нет сохранённого покупателя.
  3. Пароль в адресе доказывает, что запрос знает секрет магазина. Он не доказывает подпись конкретного покупателя.
  4. В теле есть имя, телефон, почта и адрес. Адрес расчётчика должен быть вашим.

Пример обезличенного payload до создания заказа

Подпись тела отсутствует, до создания заказа поля 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 и пустой заголовок. Такой ответ не станет скидкой. Либо заведите поле оформления, которое заполняет только тест, и привяжите запрос к этому полю. Пока запись выключена, запросов нет.

Контракт для проверки

Минимальный технический контракт для проверки:

  • обезличенный JSON запроса расчётчику до создания заказа,
  • штатная проверка подлинности запроса и клиента,
  • формат ответа по 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 рублей.

Оставить оценку

Оценка успешно отправлена.
Она будет проверена администратором перед публикацией.
Нажимая кнопку «Отправить оценку», я принимаю пользовательское соглашение и политику конфиденциальности
Перед публикацией все оценки проходят модерацию

Количество отзывов: 0

Недавно просмотренные статьи
Остались вопросы?
Отправьте обращение в техподдержку!
Для улучшения работы сайта, ООО «Инсейлс Рус» обрабатывает файлы Cookie, а также использует сервисы веб-аналитики. Для получения дополнительной информации, пожалуйста, ознакомьтесь с Политикой использования Cookie-файлов.