Atualizar promoção de item

Observação

Novos dados substituirão dados antigos. Se você quiser atualizar apenas uma parte de uma promoção, você deve transferir todos os dados necessários na solicitação também.

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
promotion_id required	integer ID de promoção. Identificador exclusivo da promoção dentro do projeto. Example: 111425

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 tipo = number (objects)

One of:

[ 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

Indica que a condição é atendida mesmo se o atributo estiver ausente dos atributos do usuário. Passe true para mostrar o item aos usuários que não têm esse atributo. Os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, não verão o item. false — os usuários que têm o atributo, mas o valor não corresponder ao especificado na condição, ou o atributo estiver ausente, não verão o 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

204

A promoção foi atualizada 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.

404

Promoção não encontrada. Certifique-se de que promotion_id está correto.

422

Solicitação inválida.

Request samples

application/json

{"attribute_conditions": [{"attribute": "race",
"operator": "eq",
"type": "string",
"value": "ork"
},
{"attribute": "level",
"can_be_missing": true,
"operator": "ge",
"type": "number",
"value": "10"
}
],
"date_end": "2020-04-25T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"discount": {"percent": "24.00"
},
"items": null,
"name": {"en-US": "Ork set discount",
"ru-RU": "Скидка на набор для орка"
}
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}