iotoms Docs

Update a discount

PUT
/api/v1/catalog/attributes/discounts/{id}

Updates a discount; fields not supplied keep their current values. Buy-X-get-Y and tiered-quantity discounts are validated for their required settings. The response is the bare object, without the standard {status, message, data} envelope.

How to use it

  1. Take the discount id from List discounts.
  2. Send name, discountType and rate, plus the type's settings (buy/get quantities for type 3, tierMinQuantity for type 4).
  3. Send status too: if it is omitted the discount is saved as active. Other omitted optional fields keep their current values.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*integer

ID of the record.

Formatint64

Request Body

application/json
  1. body
id*integer

Unique ID of the discount. Set by the server; use it as discountId on items.

Formatint64
name*string

Discount name, up to 100 characters. Required and unique for the merchant.

discountType*integer

Kind of discount: 1 = fixed amount, 2 = percentage, 3 = buy X get Y, 4 = tiered quantity. Any other value is rejected.

Formatint32
rate*number

Discount value: an amount in the merchant's currency for type 1, a percentage for type 2; for type 4 it applies once the tier quantity is reached.

modifiedTime*string

When the discount was last saved. Set by the server.

Formatdate-time
status*string

Status text, for example active (the default when omitted).

buyQuantity?|

Buy X get Y only (type 3): number of units the customer must buy. Required and greater than zero for that type.

Formatint32
getQuantity?|

Buy X get Y only (type 3): number of units that then get the discount. Required and greater than zero for that type.

Formatint32
getDiscountPercent?|

Buy X get Y only (type 3): discount on the get units, above 0 and up to 100 (100 = free).

tierMinQuantity?|

Tiered quantity only (type 4): line quantity at which rate starts to apply. Required and greater than zero for that type.

Formatint32

Response Body

OK

*/*
  1. response
id*integer

Unique ID of the discount. Set by the server; use it as discountId on items.

Formatint64
name*string

Discount name, up to 100 characters. Required and unique for the merchant.

discountType*integer

Kind of discount: 1 = fixed amount, 2 = percentage, 3 = buy X get Y, 4 = tiered quantity. Any other value is rejected.

Formatint32
rate*number

Discount value: an amount in the merchant's currency for type 1, a percentage for type 2; for type 4 it applies once the tier quantity is reached.

modifiedTime*string

When the discount was last saved. Set by the server.

Formatdate-time
status*string

Status text, for example active (the default when omitted).

buyQuantity?|

Buy X get Y only (type 3): number of units the customer must buy. Required and greater than zero for that type.

Formatint32
getQuantity?|

Buy X get Y only (type 3): number of units that then get the discount. Required and greater than zero for that type.

Formatint32
getDiscountPercent?|

Buy X get Y only (type 3): discount on the get units, above 0 and up to 100 (100 = free).

tierMinQuantity?|

Tiered quantity only (type 4): line quantity at which rate starts to apply. Required and greater than zero for that type.

Formatint32
Example Request
curl -X PUT 'https://beta.iotoms.com/api/v1/catalog/attributes/discounts/0' \  -H 'Content-Type: application/json' \  -d '{  "id": 0,  "name": "string",  "discountType": 0,  "rate": 0,  "modifiedTime": "2019-08-24T14:15:22Z",  "status": "string"}'
Example Response
{  "id": 0,  "name": "string",  "discountType": 0,  "rate": 0,  "modifiedTime": "2019-08-24T14:15:22Z",  "status": "string",  "buyQuantity": 0,  "getQuantity": 0,  "getDiscountPercent": 0,  "tierMinQuantity": 0}