Buy Box changed event (COPY)

The Buy Box Changed event notifies you when the Buy Box winner or winning price changes for your published items, if at least one offer exists for the item.

When this event occurs, Walmart sends a notification to your destination URL. The notification includes a payload with detailed information about the item, your offer, and the Buy Box winner.

Event details

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

Response parameters

NameDescriptionType
sourceEvent meta informationObject
eventTypeEvent for which the notification is receivedString
eventTimeTime at which the event occursString
eventIdUnique ID of the eventString
payloadEvent detailsObject
partnerIdSeller partner IDString
itemInfoItem informationObject
itemIdA unique ID which identifies the itemString
itemNameName of the itemString
categoryCategory of the itemString
productTypeProduct type of the itemString
brandBrand of the itemString
skuA unique ID which identifies the itemString
itemConditionItem conditionString
totalNumberOfOffersNumber of offers on the item from all sellersInteger
offerOffer informationObject
currentOfferSeller’s current offer informationObject
winningOfferBuy Box winning offer informationObject
offersArray of top 5 offersArray
sellerNameSeller’s name / Buy Box winning seller’s nameString
sellerOfferPriceSeller’s offer price / Buy Box winning seller’s offer priceDouble
sellerShippingSpeedSeller’s shipping speed / Buy Box winning seller’s shipping speedString
sellerShippingPriceSeller’s shipping price / Buy Box winning seller’s shipping priceDouble
proSellerBadgePro Seller badgeBoolean
isWFSFulfillment method is WFSBoolean
offers[].sellerNameSeller name of the offerString
offers[].sellerOfferPriceOffer price of the sellerDouble
offers[].sellerShippingSpeedShipping speed of the offerString
offers[].sellerShippingPriceShipping price of the offerDouble
offers[].partnerIdPartner ID of the sellerString
offers[].proSellerBadgePro Seller badgeBoolean
offers[].isWFSFulfillment method is WFSBoolean
priceDifferenceDifference between seller’s offer price and Buy Box winning offer priceDouble

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 }, "offers": [ // New attribute { "sellerName": "Save you Stores", "sellerOfferPrice": 16.25, "sellerShippingSpeed": "EXPEDITED", "sellerShippingPrice": 0 }, { "sellerName": "CB&WS goods", "sellerOfferPrice": 13.03, "sellerShippingSpeed": "EXPEDITED", "sellerShippingPrice": 0 } ] }, "priceDifference": -3.22 }
}