Create Prices

POST/api/v2/public/products/prices

Creates or updates standard product prices. Each price has a price group and a validity window, so future prices can be loaded ahead of time. For promotions use the discount prices endpoint.

Body ParametersJSONExpand Collapse

body: optional array of object { price_id, product_number, country_code, 8 more }

price_id: string

Unique price identifier.

minLength1

product_number: string

The product number this price applies to.

minLength1

country_code: optional string

Optional ISO country code restricting the price.

price: optional number

Price value.

formatdouble

price_group: optional string

Optional price group identifier.

price_quantity: optional number

Quantity for which the price applies.

formatdouble

price_type: optional number

Numeric price type.

formatint32

price_unit: optional string

Unit of measure the price applies to.

store_number: optional string

Optional store number restricting the price.

valid_from: optional string

Start of the price’s validity period.

formatdate-time

valid_to: optional string

End of the price’s validity period.

formatdate-time

ReturnsExpand Collapse

success: boolean

Indicates whether the operation completed successfully.

data: optional string

Optional data payload returned by the operation.

message: optional string

Human-readable message describing the result.

Create Prices

curl https://api.colleqtive.net/api/v2/public/products/prices \
    -X POST \
    -H "Authorization: $COLLEQTIVE_BEARER_TOKEN"

{
  "success": true,
  "data": "data",
  "message": "message"
}

{
  "code": 401,
  "status": "error",
  "message": "Authentication failed.",
  "error": "unauthorized",
  "error_description": "Authentication failed."
}

{
  "code": 500,
  "status": "fail",
  "message": "The request could not be processed.",
  "error": "internal_error",
  "error_description": "The request could not be processed."
}

Returns Examples

{
  "success": true,
  "data": "data",
  "message": "message"
}

{
  "code": 401,
  "status": "error",
  "message": "Authentication failed.",
  "error": "unauthorized",
  "error_description": "Authentication failed."
}

{
  "code": 500,
  "status": "fail",
  "message": "The request could not be processed.",
  "error": "internal_error",
  "error_description": "The request could not be processed."
}