# Obter promoção de itens

Obtém a promoção aplicada a itens específicos.

As promoções oferecem um desconto (%) nos itens.
O desconto será aplicado a todos os preços dos itens especificados.

Endpoint: GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `promotion_id` (integer, required)
    ID de promoção. Identificador exclusivo da promoção dentro do projeto.
    Example: 111425

## Response 200 fields (application/json):

  - `id` (integer)
    ID de promoção. Identificador exclusivo da promoção dentro do projeto.
    Example: 1

  - `promotion_periods` (array)
    Períodos de validade da promoção. Se múltiplos períodos forem especificados, tanto date_from quanto date_until são necessários.
    Example: [{"date_from":"2020-04-15T18:16:00+05:00","date_until":"2020-04-25T18:16:00+05:00"}]

  - `promotion_periods.date_from` (string, required)
    Data de início da promoção especificada.
    Example: "2020-08-11T10:00:00+03:00"

  - `promotion_periods.date_until` (string,null)
    Data de término da promoção especificada. Se definido como null, a promoção é indefinida. Pode ser null apenas se um único período de validade for especificado.
    Example: "2020-08-11T20:00:00+03:00"

  - `is_enabled` (boolean)
    Se a promoção está habilitada ou não.
    Example: true

  - `name` (object)
    Nome da promoção. Deve conter pares chave/valor,
onde chave é a localidade com o formato "^[a-z]{2}-[A-Z]{2}$", e o valor é uma cadeia de caracteres.
    Example: {"en-US":"Promotion","ru-RU":"Акция"}

  - `discount` (object)
    Example: {"percent":"15.00"}

  - `discount.percent` (string,null)
    Percentual de desconto.
O preço do item será diminuído usando um valor que foi calculado usando essa porcentagem.
    Example: "15.00"

  - `items` (array,null)
    Example: [{"sku":"com.xsolla.elven_sword_1"},{"sku":"com.xsolla.elven_helmet_1"},{"sku":"com.xsolla.elven_armor_1"}]

  - `items.sku` (string)
    SKU do item.

  - `attribute_conditions` (array)
    Condições para validar atributos do usuário.
Determina a disponibilidade da promoção com base em se os atributos de usuário correspondem a todas as condições especificadas.

  - `limits` (object)
    Limites da promoção.

  - `limits.per_user` (object,null)
    Limitação de promoção para um usuário separado.

  - `limits.per_user.total` (integer)
    Número total de itens que um usuário pode comprar. Você pode definir esse número na Conta de Distribuidor ou usar pontos de extremidade de administração para entidades da Store (limitação de objetos).
    Example: 5

  - `limits.per_item` (integer,null)
    Limitação global de itens.
    Example: 10

  - `limits.recurrent_schedule` (object,null)
    Limite o período de atualização.

  - `limits.recurrent_schedule.per_user` (any)
    Período de atualização do limite do usuário.

  - `price_conditions` (array,null)
    Matriz de objetos com condições que definem a faixa de preço para aplicar a promoção. A promoção se aplica apenas a itens cujo preço atenda a todas as condições da matriz. Se você passar essa matriz, defina o valor do objeto [items](/pt/api/shop-builder/operation/create-item-promotion/#!path=items&t=request) como null.

  - `price_conditions.operator` (string, required)
    Operador de comparação para definir a faixa de preço para aplicar a promoção.

Possíveis valores:
- ge — Maior ou igual
- gt — Maior do que
- le — Menor ou igual
- lt — Menor do que
- eq — Equivalente
- ne — Não equivalente
    Enum: "ge", "gt", "le", "lt", "eq", "ne"

  - `price_conditions.value` (string, required)
    Valor para determinar a faixa de preço para aplicar a promoção.

  - `excluded_promotions` (array)
    Lista de IDs de promoção a serem excluídos ao aplicar esta promoção. Example: [12, 789]

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    Example: 404

  - `errorCode` (integer)
    Example: 9502

  - `errorMessage` (string)
    Example: "[0401-9502]: Can not find promotion with ID = 111425 in project 59080"