Настройка подарков (бесплатных дополнительных продуктов) через Products API

Подарок - это бесплатный продукт, который автоматически добавляется в корзину при покупке основного продукта. Покупатель не может удалить из корзины подарок отдельно от основного продукта.

Для настройки подарков используется функционал дополнительных продуктов.

Чтобы настроить подарок вы должны создать два продукта:

Основной продукт - при добавлении которого в корзину туда также добавляется подарок.
Создается как обычный продукт, параметр cross_sell заполнять не нужно.
Продукт для подарка.
У продукта должны быть сделаны настройки:
- Заполнены настройки предложения дополнительных продуктов (cross_sell).
- Включено добавление дополнительного продукта при добавлении в корзину основного: "cross_sell.status":true.
- Выбран тип дополнительного продукта - обязательный: "cross_sell.type":"add_to_basket".
- Отключено удаление подарка из корзины отдельно от основного продукта: "cross_sell.removal_available":false.
- Если вы хотите, чтобы в корзине был всегда 1 подарок, независимо от количества основного продукта в корзине, то:
  - В настройках цен задайте минимальное и максимальное количество продукта = 1: variants.[object].from:1, variants.[object].to:1.
  - Отключите возможность изменять количества продукта в корзине cross_sell.quantity_change_available:false.
  - Заполните массив продуктов, при покупке которых в корзину нужно добавлять подарок (cross_sell.product_id). В массиве укажите идентификатор основного продукта, созданного ранее. Может быть указано несколько продуктов. В этом случае подарок будет добавлен в корзину, если в ней находится хотя бы один из них.
  - Остальные поля заполняются так, как описано в описании соответствующих параметров.

Пример запроса на создание основного продукта (к которому будет добавляться подарок)

{
  "family_name": "Demo Product",
  "name": "1 Pc",
  "variants": [{
      "vendor_code": "1",
      "sku": "111",
      "price": {
        "common": {
          "currency": "USD",
          "price": "100"
        }
      }
    }
  ]
}

Предположим в результате первого запроса был получен идентификатор созданного продукта: "id":11.

Пример запроса на создание подарка

{
  "family_name": "Free Product (gift)",
  "name": "1 Pc",
  "variants": [{
      "vendor_code": "2",
      "sku": "222",
      "from": 1,
      "to": 1,
      "price": {
        "common": {
          "currency": "USD",
          "price": "0.00"
        }
      }
    }
  ],
  "cross_sell": {
    "type": "add_to_basket",
    "status": true,
    "date_from": "2023-10-15 14:18:00",
    "date_to": "2023-10-25 14:18:00",
    "removal_available": false,
    "quantity_change_available": false,
    "product_id": [
      11
    ]
  }
}