PUT
/
price-controls
/
{itemId}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id
string
required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-channel-id
string

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-client-id
string

A unique identifier obtained from Copilot for the System app in the fabric ecosystem, essential for OpenID Connect authentication flows.

x-fabric-request-id
string

A unique request ID.

Path Parameters

itemId
integer
required

ID of the item whose price controls are to be updated

Query Parameters

priceListId
integer

Price list ID to which the item belongs. If not sent, the default price list is considered.

Body

application/json

Price control details

msrp
number | null

Item's manufacturer suggested retail price. Represents the price that the manufacturer suggests the retailer should sell the product to make a reasonable profit.

map
number | null

Item's minimum advertised price. It's the lowest price that a manufacturer or supplier allows its retailers or distributors to advertise a product for sale.

floor
number | null

The lowest price at which the product can be sold. Price created for the item ID or item SKU under the specified price list shouldn't be lower than the specified floor price.

ceiling
number | null

The maximum price the seller is allowed to charge for the product. Price created for the item ID or item SKU under the specified price list shouldn't exceed the specified ceiling price.

Response

200 - application/json

The sample response for price control request.

priceListId
integer
required

The price list ID for which the prices are created or updated.

itemId
integer
required

The item ID for which the prices are created or updated.

itemSku
string

The Stock Keeping Unit (SKU) of the item for which prices are created or updated.

msrp
number | null

The manufacturer-suggested retail price for the item. It's the price that the manufacturer suggests the retailer should sell the product for in order to make a reasonable profit.

map
number | null

The minimum price advertised for the item. It's the lowest price that a manufacturer or supplier allows its retailers or distributors to advertise a product for sale.

floor
number | null

The lowest price at which the product can be sold. Price created for the item ID or item SKU under the specified price list shouldn't be lower than the given floor price.

ceiling
number | null

The maximum price the seller is allowed to charge for the product. The price created for the item ID or item SKU under the specified price list shouldn't exceed the given ceiling price.

channelId
string

The sales channel ID for the created prices.

isDeleted
boolean
required

true: Record is deleted<br>false: Record isn't deleted

createdAt
string
required

Record's creation time

updatedAt
string
required

Record's last updated time