PUT listings/{listingID}/update-price
This call allows you to update the price of the Listing identified by ID. A successful update of price will trigger price update on the channel if it is enabled in the channel settings.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
listingID | The ID of the Listing | integer | Required |
Body Parameters
The update object with new data
ListingPriceBasicUpdateModel
Name | Description | Type | Additional information |
---|---|---|---|
Price | The price of the Listing | decimal number | Required |
Request Formats
application/json, text/json
Sample:
{ "Price": 9.99 }
application/xml, text/xml
Sample:
<ListingPriceBasicUpdateModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Price>9.99</Price> </ListingPriceBasicUpdateModel>
Response Information
Resource Description
This call allows you to update the price of the Listing identified by ID. A successful update of price will trigger price update on the channel if it is enabled in the channel settings.
ListingModelName | Description | Type | Additional information |
---|---|---|---|
ListingID | The ID of the Listing | integer | None. |
CreatedDate | The Created Date of the Listing | date | None. |
ListingSKU | The SKU of the Listing | string | None. |
ListingBarcode | The Barcode of the Listing | string | None. |
ListingName | The name of the Listing | string | None. |
ListingPrice | The price of the Listing | decimal number | None. |
ListingDescription | The description of the Listing | string | None. |
ListingOversell | The oversell stock of the listing | integer | None. |
ListingMaxInventory | The maximum inventory for the listing | integer | None. |
ListingInventoryType | The inventory type of the listing | InventoryType | None. |
ListingInventoryPercentage | The inventory percentage to use for the listing | integer | None. |
ListingStatus | The status of the Listing | ProductChannelStatus | None. |
ChannelIdentifier | The Channel Identifier of the Listing | string | None. |
Channel | The Channel of the Listing | ChannelBaseModel | None. |
Product | The Product of the Listing | ProductListingProductModel | None. |
Response Formats
application/json, text/json
Sample:
{ "ListingID": 123, "ListingSKU": "SKU-AB-2018", "ListingBarcode": "12345678", "ListingName": "Listing Name", "ListingPrice": 9.99, "ListingDescription": "A description string", "ListingOversell": 3, "ListingMaxInventory": 10, "ListingInventoryType": "InventoryOversell", "ListingInventoryPercentage": 100, "ListingStatus": "ActiveOnChannel", "ChannelIdentifier": "CH-AB-2018", "Channel": { "ChannelName": "Amazon UK", "ChannelType": "Amazon", "ChannelID": 1, "ChannelGuid": "bb282fa0-8c76-4435-8ee7-4e626c7d44c8", "IsActive": false }, "Product": { "Categories": [ { "CategoryID": 1, "CategoryName": "Shoes" }, { "CategoryID": 2, "CategoryName": "Trainers" } ], "Ean": "9780471117094", "ProductID": 1, "SKU": "SKU 1" } }
application/xml, text/xml
Sample:
<ListingModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ListingID>123</ListingID> <CreatedDate xsi:nil="true" /> <ListingSKU>SKU-AB-2018</ListingSKU> <ListingBarcode>12345678</ListingBarcode> <ListingName>Listing Name</ListingName> <ListingPrice>9.99</ListingPrice> <ListingDescription>A description string</ListingDescription> <ListingOversell>3</ListingOversell> <ListingMaxInventory>10</ListingMaxInventory> <ListingInventoryType>InventoryOversell</ListingInventoryType> <ListingInventoryPercentage>100</ListingInventoryPercentage> <ListingStatus>ActiveOnChannel</ListingStatus> <ChannelIdentifier>CH-AB-2018</ChannelIdentifier> <Channel> <ChannelName>Amazon UK</ChannelName> <ChannelType>Amazon</ChannelType> <ChannelID>1</ChannelID> <ChannelGuid>bb282fa0-8c76-4435-8ee7-4e626c7d44c8</ChannelGuid> <IsActive>false</IsActive> </Channel> <Product> <ProductID>1</ProductID> <SKU>SKU 1</SKU> <Categories> <CategoryBaseModel> <CategoryID>1</CategoryID> <CategoryName>Shoes</CategoryName> </CategoryBaseModel> <CategoryBaseModel> <CategoryID>2</CategoryID> <CategoryName>Trainers</CategoryName> </CategoryBaseModel> </Categories> <Ean>9780471117094</Ean> </Product> </ListingModel>