# Создание бандла Создает бандл. Endpoint: POST /v2/project/{project_id}/admin/items/bundle Version: 2.0.0 Security: basicAuth ## Path parameters: - `project_id` (integer, required) ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта. Example: 44056 ## Request fields (application/json): - `attributes` (array) Список атрибутов. Внимание. Для товара невозможно указать более 20 атрибутов. Любые попытки превысить данное ограничение вызовут ошибку. - `attributes.external_id` (string, required) Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания. Example: "attribute_1" - `attributes.name` (object) Объект с локализациями для названия атрибута. Ключи для обозначения стран указаны в стандарте ISO 3166-1. Example: {"de":"Genre","en":"Genre"} - `attributes.values` (array, required) Внимание. Невозможно создать более 6 значений для каждого атрибута. Любые попытки превысить данное ограничение вызовут ошибку. Example: [{"external_id":"strategy","value":{"de":"Strategie","en":"Strategy"}},{"external_id":"action","value":{"de":"Aktion","en":"Action"}}] - `attributes.values.external_id` (string, required) Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания. Example: "attribute_value" - `attributes.values.value` (object, required) Объект с локализациями для названия значения. Ключи для обозначения стран указаны в стандарте ISO 3166-1. Example: {"de":"Strategie","en":"Strategy"} - `bundle_type` (string) Тип бандла. Используйте standard, чтобы создать бандл с товарами и указать артикулы товаров, которые содержатся в бандле. Используйте partner_side_content, чтобы создать пустой бандл и добавить в него товары на своей стороне с помощью [вебхука](https://developers.xsolla.com/ru/webhooks/operation/personalized-partner-catalog/). Используется только для [персонализации каталога товаров на стороне партнера](https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side). Enum: "standard", "partner_side_content" - `content` (array) Example: [{"quantity":1,"sku":"com.xsolla.kg_1"}] - `content.quantity` (integer) Количество выбранных товаров в бандле. Example: 1 - `content.sku` (string, required) Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания. Example: "bundle_1" - `custom_attributes` (object) JSON-объект, содержащий атрибуты товара и их значения. Атрибуты позволяют добавить дополнительную информацию к товарам. Например, указать уровень игрока, на котором ему станет доступен этот товар. Атрибуты дополняют внутреннюю логику игры и могут быть получены через GET-методы и вебхуки. - `description` (object,null, required) Объект с локализованными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в [документации](/ru/doc/shop-builder/references/supported-languages/). - `groups` (array) Группы, к которым принадлежит элемент. Примечание. Строковое значение относится к группе external_id. Example: ["honor"] - `image_url` (string,null) URL-адрес изображения. Example: "https://image.example.com" - `is_enabled` (boolean) Если этот параметр отключен, товар не может быть найден и приобретен. Example: true - `is_free` (boolean) Если true, товар бесплатный. - `is_show_in_store` (boolean) Товар доступен для покупки. Example: true - `limits` (object) Ограничения на продажу товара. - `limits.per_item` (integer,null) Глобальное ограничение товара. Example: 10 - `limits.per_user` (any) Ограничение количества товара для отдельного пользователя. - `limits.recurrent_schedule` (object,null) Период обновления установленный ограничений. - `limits.recurrent_schedule.per_user` (any) Сброс лимитов на покупку товара, выполняемый через временной интервал, заданный в часах. - `long_description` (object,null) Объект с локализованными длинными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в [документации](/ru/doc/shop-builder/references/supported-languages/). - `media_list` (array,null) Дополнительные ассеты бандла. Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}] - `media_list.type` (string) Тип медиа: image/video. Enum: "image", "video" - `media_list.url` (string) Ссылка на файл. Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg" - `name` (object,null, required) Объект с локализованными названиями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код языка из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется двухбуквенный код языка. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в [документации](/ru/doc/shop-builder/references/supported-languages/). - `order` (integer) Приоритет заказа бандла в списке. Example: 1 - `periods` (array,null) Период продажи товара. - `periods.date_from` (string) Дата, когда указанный товар будет доступен для продажи. Example: "2020-08-11T10:00:00+03:00" - `periods.date_until` (string,null) Дата, когда указанный товар станет недоступен для продажи. Может быть null. Example: "2020-08-11T20:00:00+03:00" - `prices` (array) Цены в реальных валютах. - `prices.amount` (string, required) Цена товара. Example: "100.99" - `prices.country_iso` (string,null) Страна, где доступна эта цена. Двухбуквенный код в соответствии с [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Example: "US" - `prices.currency` (string, required) Валюта, в которой указана цена товара. Трехбуквенный код в соответствии со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `prices.is_default` (boolean, required) Цена по умолчанию используется для построения каталога, если цена в валюте пользователя не указана. - `prices.is_enabled` (boolean, required) Цена включена. - `regions` (array) - `regions.id` (integer) Example: 1 - `vc_prices` (array,null) - `vc_prices.amount` (integer, required) - `vc_prices.is_default` (boolean, required) - `vc_prices.is_enabled` (boolean, required) ## Response 201 fields (application/json): - `sku` (string) Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания. Example: "bundle_1" ## Response 401 fields (application/json): - `errorCode` (integer) Example: 1020 - `errorMessage` (string) Example: "[0401-1020]: Error in Authentication method occurred" - `statusCode` (integer) Example: 401 ## Response 422 fields (application/json): - `errorCode` (integer) Example: 1102 - `errorMessage` (string) Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required" - `errorMessageExtended` (array) - `statusCode` (integer) Example: 422 - `transactionId` (string) Example: "x-x-x-x-transactionId-mock-x-x-x"