Buy Box changed event

Suggest Edits

This event occurs when the Buy Box winner or Buy Box winning price on the seller’s published items changes if there is at least one offer on the item.

When the event occurs, the seller will receive the response payload on the destination URL, as given in the samples.

Event Type: BUY_BOX_CHANGED
Event Version: V1
Resource Name: PRICE

Response parameters

Name	Description	Type
source	Event Meta information	Object
eventType	Event for which the notification is received	String
eventTime	Time at which the event occurs	String
eventId	Unique ID of the event	String
payload	Event details	Object
partnerId	Seller’s Partner ID	String
itemInfo	Item information	Object
itemId	A unique ID which identifies the item	String
itemName	Name of the item	String
category	Category of the item	String
productType	Product type of the item	String
brand	Brand of the item	String
sku	A unique ID which identifies the item	String
totalNumberOfOffers	Number of offers on the item from all sellers	Integer
offer	Offer information	Object
currentOffer	Seller’s current offer information	Object
sellerName	Seller’s name	String
sellerOfferPrice	Seller’s offer price on the item	Double
sellerShippingSpeed	Seller’s shipping speed on the item	String
sellerShippingPrice	Seller’s shipping price on the item	Double
winningOffer	Buy box winning offer information	Object
sellerName	Buy box winning seller’s name	String
sellerOfferPrice	Buy box winning seller’s offer price on the item	Double
sellerShippingSpeed	Buy box winning seller’s shipping speed on the item	String
sellerShippingPrice	Buy box winning seller’s shipping price on the item	Double
priceDifference	Difference of seller’s offer price with buy box winning offer price on the item	Double

Sample payload: Buy Box changed

{ "source": { "eventType": "BUY_BOX_CHANGED", "eventTime": "2020-07-03T14:12:42.913Z", "eventId": "42c2b910-bd37-11ea-89f1-4f3bd9e0e3af" }, "payload": { "partnerId": "12300001205", "itemInfo": { "itemId": "50655131", "itemName": "Sizzix SBarnard Thinlits Die Drop In Thank You", "category": "Crafts", "productType": "Die-Cut Cartridges", "brand": "Sizzix", "sku": "NMG300868", "totalNumberOfOffers": 33 }, "offer": { "currentOffer": { "sellerName": "CB&WS goods", "sellerOfferPrice": 13.03, "sellerShippingSpeed": "STANDARD", "sellerShippingPrice": 8.99 }, "winningOffer": { "sellerName": "Save you Stores", "sellerOfferPrice": 16.25, "sellerShippingSpeed": "EXPEDITED", "sellerShippingPrice": 0 }, "priceDifference": -3.22 } }
}

Updated about 2 months ago