Xsolla-logo

Criar promoção de desconto para itemServer-sideAdmin

post/v2/project/{project_id}/admin/promotion/item

Cria uma promoção de desconto para um item.

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

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Example: 44056
Request Body schema: application/json

Objeto com dados de promoção.

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

SKU do item.

required
object
percent
required
string

Percentual de desconto. O preço do item será diminuído usando um valor calculado usando essa porcentagem e, em seguida, arredondado para 2 casas decimais.

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

property name*
additional property
string
Array of tipo = string (objects) or Array of tipo = data (objects) or Array of type = number (objects)
One of:

Condições que são comparadas aos valores de atributo do usuário. Devem estar reunidas todas as condições para que a ação entre em efeito.

[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Código de atributo do usuário.

operator
required
string

Tipo de operação realizada por condição. Para o tipo de atributo string.

Enum: Description
eq

Iguais

ne

Não são iguais

value
required
string <= 255 characters

Valor da condição com o qual o valor do atributo do usuário será comparado. O tipo depende do tipo de atributo.

type
required
string

Tipo de atributo de usuário.

Value: "string"
can_be_missing
boolean

Indicates that the condition is met even if attribute is missing from user attributes. Pass true to show the item to users who don't have this attribute. Users who have the attribute, but the value does not match that specified in the condition, will not see the item. False — users who have the attribute, but the value does not match that specified in the condition, or the attribute is missing, will not see the item.

date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Data em que sua promoção será concluída. Pode ser null.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Data em que sua promoção será iniciada.

object

Limites da promoção.

per_user
integer or null

Limitação de promoção para um usuário separado.

object or null

Limite o período de atualização.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)
One of:

Tipo diário de atualização de limites de usuário.

interval_type
required
string

Período de atualização recorrente.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Tempo de atualização do limite no fuso horário desejado (arredondamento para horas).

object or null

Condição para aplicar a promoção a itens com preços dentro da faixa de preço especificada. No objeto price_range_condition, você precisa fornecer um valor para pelo menos um dos parâmetros: lower_limit ou upper_limit.
Se você tiver especificado itens no objeto items, a promoção só se aplicará aos itens dentro desse objeto e dentro da faixa de preço especificada.
Para fazer com que a condição promocional se aplique a todos os itens, passe o valor null no objeto items.

lower_limit
required
string or null

Limite inferior da faixa de preço para aplicação da promoção. Se o valor lower_limit for definido, as promoções só serão aplicadas a itens cujo preço seja maior ou igual a esse valor. O valor do preço deve ser especificado na moeda padrão.
Exemplo: "10.0000"

upper_limit
required
string or null

Limite superior da faixa de preço para aplicar a promoção. Se upper_limit estiver definido, as promoções serão aplicadas apenas a itens cujo preço seja menor ou igual a esse valor. O valor do preço deve ser especificado na moeda padrão.
Exemplo: "20.0000"

Responses
201

Promoção criada com sucesso.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

422

Solicitação inválida.

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": null,
  • "name": {
    }
}
Response samples
application/json
{
  • "promotion_id": 2384756
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2024 Xsolla Inc.