# 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 do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
    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):

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

  - `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"

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

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

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

  - `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.

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

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

  - `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.recurrent_schedule` (object,null)
    Limite o período de atualização.

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

  - `limits.recurrent_schedule.per_user.day_of_month` (integer,null)
    Dia do mês em que os limites são atualizados. Se não houver um dia selecionado do mês por ser mais curto, a atualização ocorrerá no último dia do mês. Não null apenas para o tipo de período de atualização de limite monthly.

  - `limits.recurrent_schedule.per_user.day_of_week` (integer,null)
    Dia da semana em que os limites se atualizam. Onde 1 é segunda-feira e 7 é domingo. Não null apenas para o tipo de período de atualização de limite weekly.

  - `limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    Data e hora em que os limites devem ser redefinidos (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    Data e hora da primeira atualização de limite (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `limits.recurrent_schedule.per_user.interval_type` (string)
    Tipo de período de atualização recorrente.
    Enum: "daily", "weekly", "monthly"

  - `limits.recurrent_schedule.per_user.reset_next_date` (integer)
    Data e hora em que os limites são atualizados (Unix Timestamp).
    Example: 1677553200

  - `limits.recurrent_schedule.per_user.time` (string)
    Tempo de atualização do limite no fuso horário desejado (arredondamento para horas).
    Example: "11:00:00+03:00"

  - `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":"Акция"}

  - `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.
    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.

  - `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.

  - `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"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `errorCode` (integer)
    Example: 9502

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

  - `statusCode` (integer)
    Example: 404