# Получение продаваемого товара по артикулу

Получает продаваемый товар по артикулу для построения каталога.


Примечание
Без авторизации метод возвращает общие данные по каталогу товаров. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции, связанные с этим товаром. Для этого необходимо передать JWT пользователя в заголовке Authorization. Подробная информация о JWT пользователя приведена в блоке Безопасность для этого метода.

Endpoint: GET /v2/project/{project_id}/items/sku/{sku}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    Example: 59080

  - `sku` (string, required)
    Артикул товара.
    Example: "electric_shield"

## Query parameters:

  - `promo_code` (string)
    Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Отображает предметы с ограниченным сроком действия, которые недоступны пользователю. Срок действия таких предметов еще не начался или уже истек.
    Example: 1

  - `additional_fields[]` (array)
    Дополнительные поля, которые будут включены в ответ. По умолчанию не возвращаются. Передайте нужные значения, чтобы получить их в ответе.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

## Response 200 fields (application/json):

  - `item_id` (integer)
    Внутренний уникальный ID товара, который задается при создании товара.
    Example: 259774

  - `sku` (string)
    Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания.
    Example: "electric_shield"

  - `name` (string)
    Название товара.
    Example: "Electric shield"

  - `groups` (array)
    Группы, к которым принадлежит товар.

  - `groups.external_id` (string)
    [Внешний ID группы товаров](/ru/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id), который был указан при создании.
    Example: "exclusive"

  - `groups.name` (string)
    Название группы.
    Example: "Exclusive"

  - `groups.item_order_in_group` (integer)
    Позиция предмета внутри группы, определяющая порядок отображения.
Возвращается в ответ только при указании в запросе query-параметра additional_fields[].
    Example: 1

  - `attributes` (array)
    Список атрибутов и их значений, соответствующих товару. Может использоваться для фильтрации каталога.

  - `attributes.external_id` (string)
    Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания.

  - `attributes.name` (object)
    Название атрибута.
    Example: "Genre"

  - `attributes.values` (array)

  - `attributes.values.external_id` (string)
    Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

  - `attributes.values.value` (string)
    Значение атрибута.
    Example: "Strategy"

  - `type` (string)
    Тип товара: virtual_good/virtual_currency/bundle/game_key/physical_good.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good"

  - `description` (string)
    Описание товара.
    Example: "Electric shield"

  - `image_url` (string)
    URL-адрес изображения.
    Example: "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png"

  - `is_free` (boolean)
    Является ли товар бесплатным.

  - `price` (object)
    Цены на товар.

  - `price.amount` (string)
    Цена товара со скидкой.
    Example: "9.99"

  - `price.amount_without_discount` (string)
    Цена товара.
    Example: "9.99"

  - `price.currency` (string)
    Валюта, в которой указана цена товара. Трехбуквенный код в соответствии со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `virtual_prices` (array)
    Виртуальные цены.

  - `virtual_prices.amount` (integer)
    Цена товара в виртуальной валюте.
    Example: 100

  - `virtual_prices.amount_without_discount` (integer)
    Цена товара в виртуальной валюте без скидки. Всегда равна значению amount, так как скидки не применяются к ценам в виртуальной валюте.
    Example: 200

  - `virtual_prices.calculated_price` (object)

  - `virtual_prices.calculated_price.amount` (string)

  - `virtual_prices.calculated_price.amount_without_discount` (string)

  - `virtual_prices.sku` (string)
    Артикул виртуальной валюты.
    Example: "vc_gold"

  - `virtual_prices.is_default` (boolean)
    Является ли ценой в виртуальной валюте по умолчанию.
    Example: true

  - `virtual_prices.image_url` (string,null)
    URL-адрес изображения виртуальной валюты.
    Example: "http://image.png"

  - `virtual_prices.item_id` (integer)
    Уникальный ID товара, назначенный Xsolla.
    Example: 259774

  - `virtual_prices.name` (string)
    Название виртуальной валюты.
    Example: "Gold"

  - `virtual_prices.type` (string)
    Тип товара. Для виртуальной валюты имеет значение `virtual_currency.
    Example: "virtual_currency"

  - `virtual_prices.description` (string,null)
    Описание виртуальной валюты.
    Example: "In-game currency used to purchase weapons and upgrades"

  - `can_be_bought` (boolean)
    Если true, пользователь может купить товар.
    Example: true

  - `promotions` (array)
    Примененные акции для отдельных товаров в корзине. Массив возвращается, если:

* Скидочная акция настроена для отдельного товара.

* Используется промокод с настройкой Скидка на выбранные товары.

Если акции на уровне отдельных товаров не применялись, возвращается пустой массив.

  - `promotions.name` (string)

  - `promotions.date_start` (string,null)

  - `promotions.date_end` (string,null)

  - `promotions.discount` (object,null)

  - `promotions.discount.percent` (string,null)

  - `promotions.discount.value` (string,null)

  - `promotions.bonus` (array)

  - `promotions.bonus.sku` (string)

  - `promotions.bonus.quantity` (integer)

  - `promotions.bonus.type` (string)
    Тип бонусного товара.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `promotions.bonus.name` (string)
    Название бонусного товара. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.image_url` (string)
    URL-адрес изображения бонусного бандла. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.bundle_type` (string)
    Тип товара бонусного бандла. Доступно только для бонусного товара типа bundle.
    Enum: "standard", "virtual_currency_package"

  - `promotions.limits` (object)

  - `promotions.limits.per_user` (object)

  - `promotions.limits.per_user.available` (integer)

  - `promotions.limits.per_user.total` (integer)

  - `virtual_item_type` (string)
    Тип виртуального предмета.

Возможные значения:
- consumable — предмет, исчезающий из инвентаря после использования (например, патроны).
- non_consumable — предмет, остающийся в инвентаре в течение неограниченного времени.
- non_renewing_subscription — предмет с ограниченным сроком действия, который может служить представлением доступа к сервисам или контенту в течение ограниченного периода времени.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

  - `limits` (object,null)
    Ограничения на продажу товара.

  - `limits.per_user` (object,null)
    Ограничения на продажу товара для пользователя.

  - `limits.per_user.total` (integer)
    Максимальное количество товара, которое может приобрести один пользователь.
    Example: 5

  - `limits.per_user.available` (integer)
    Оставшееся количество товара, которое может приобрести текущий пользователь.
    Example: 3

  - `limits.per_user.recurrent_schedule` (any)

  - `limits.per_user.limit_exceeded_visibility` (string)
    Определяет видимость товара в каталоге после достижения лимита покупок до момента следующего обновления лимитов.

Применяется к товарам, для которых задано регулярное обновление лимитов в массиве recurrent_schedule.

Если обновление лимитов не задано, товар не отображается в каталоге после достижения лимита независимо от значения limit_exceeded_visibility.

Возможные значения:
- show — Товар возвращается в методах получения каталога товаров после достижения лимита покупок. В клиентских методах получения каталога после достижения лимита товар возвращается с флагом can_be_bought: false. Дата следующего сброса возвращается в reset_next_date.
- hide — Товар не возвращается в методах получения каталога товаров после достижения лимита покупок до момента сброса лимитов.
    Enum: "show", "hide"

  - `limits.per_item` (object,null)
    Ограничения на продажу для конкретного товара.

  - `limits.per_item.total` (integer)
    Максимальное количество товара, которое могут приобрести все пользователи.
    Example: 5

  - `limits.per_item.available` (integer)
    Оставшееся количество товара, которое могут приобрести все пользователи.
    Example: 3

  - `custom_attributes` (object)
    JSON-объект, содержащий атрибуты товара и их значения.

  - `vp_rewards` (array)
    Список призовых баллов для товара.

  - `vp_rewards.item_id` (integer)
    Внутренний уникальный ID виртуального предмета или валюты.

  - `vp_rewards.sku` (string)
    Уникальный ID призовых баллов.

  - `vp_rewards.amount` (integer)
    Количество призовых баллов.

  - `vp_rewards.name` (string)
    Название призовых баллов.

  - `vp_rewards.image_url` (string)
    URL-адрес изображения.

  - `vp_rewards.is_clan` (boolean)
    Может ли призовой балл использоваться в цепочках наград для клана.

  - `loyalty_rewards` (array)
    Баллы лояльности, которые пользователь получает в награду за покупку товара.

  - `loyalty_rewards.name` (string)
    Название баллов лояльности.

  - `loyalty_rewards.sku` (string)
    Артикул балла лояльности. Используйте это значение в параметре loyalty_point_sku в других запросах API, например при создании заказа, оплачиваемого баллами лояльности.

  - `loyalty_rewards.description` (string)
    Описание баллов лояльности.

  - `loyalty_rewards.image_url` (string,null)
    URL-адрес изображения.

  - `loyalty_rewards.amount` (integer)
    Количество баллов лояльности, которое пользователь получает за покупку товара.

  - `loyalty_prices` (array)
    Баллы лояльности, за которые можно купить товар.

  - `loyalty_prices.name` (string)
    Название баллов лояльности.

  - `loyalty_prices.sku` (string)
    Артикул балла лояльности. Используйте это значение в параметре loyalty_point_sku в других запросах API, например при создании заказа, оплачиваемого баллами лояльности.

  - `loyalty_prices.description` (string)
    Описание баллов лояльности.

  - `loyalty_prices.image_url` (string,null)
    URL-адрес изображения.

  - `loyalty_prices.amount` (integer)
    Цена товара в указанных баллах лояльности.

## Response 404 fields (application/json):

  - `statusCode` (integer)
    Example: 404

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-4001]: Item with sku = 'electric_shiel' not found"