Offer unpublished event

When your offer transitions from PUBLISHED to UNPUBLISHED, Walmart sends an event notification to your configured destination URL. Use this event to update your systems when an offer becomes unavailable for sale.

Event metadata

  • Event type: OFFER_UNPUBLISHED
  • Resource name: ITEM
  • Event version: V1

When the event occurs, Walmart posts a JSON payload to your destination URL with the fields below.

Response parameters

NameDescriptionType
sourceMetadata about the eventObject
eventTypeEvent for which the notification is receivedString
eventTimeTimestamp of when the event occurredString
eventIdUnique identifier for the eventString
payloadEvent-specific detailsObject
partnerIdSeller’s partner IDString
skuStock Keeping Unit - Unique identifier which identifies the itemString
publishStatusStatus of the item in the submission processString
lifecycleStatusStatus of the item in the overall lifecycleString
statusChangeReasonsReasons the offer was unpublished. If multiple reasons apply, all are included as key–value pairs.Map<String,String>
itemIdA unique identifier for the item. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDString
itemNameName of the item. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDString
categoryCategory of the item. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDString
totalNumberOfOffersNumber of offers for the item from all sellers. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDInteger
sellerOfferPriceSeller’s offer price on the item. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDDouble
sellerShippingPriceSeller’s shipping price on the item. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDDouble
referencePriceReference price used to unpublish the offer. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDDouble
referencePriceURLURL that documents the reference price. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDString
referencePriceTypeSource/type of the reference price. Received only if statusChangeReasons = REASONABLE_PRICE_NOT_SATISFIEDString

Sample payload 1: Offer unpublished


{ "source": { "eventType": "OFFER_UNPUBLISHED", "eventTime": "2019-02-21T01:01:08.000Z", "eventId": "03d34580-61d4-11ea-9e23-cd38810ff7cd" }, "payload": { "partnerId": "12300014482", "sku": "83852627", "publishStatus": "UNPUBLISHED", "lifecycleStatus": "ACTIVE", "statusChangeReasons": { "SHIPPING_INFO_MISSING": "No shipping information was set up." } }
}

Sample payload 2: offer unpublished

{ "source": { "eventType": "OFFER_UNPUBLISHED", "eventTime": "2019-02-21T01:01:08.000Z", "eventId": "03d34580-61d4-11ea-9e23-cd38810ff7cd" }, "payload": { "partnerId": "12300014482", "sku": "9458276", "publishStatus": "UNPUBLISHED", "lifecycleStatus": "ACTIVE", "statusChangeReasons": { "REASONABLE_PRICE_NOT_SATISFIED": "Reasonable price requirements are not met" }, "itemId": "21125774", "itemName": "Pantene Pro-V Daily Moisture Renewal Shampoo, 12.6 fl oz", "category": "HAIR CARE", "totalNumberOfOffers": 28, "sellerOfferPrice": 11.72, "sellerShippingPrice": 0, "referencePrice": 9.47 }
}

Sample payload 3: Offer unpublished

{ "source": { "eventType": "OFFER_UNPUBLISHED", "eventTime": "2019-02-21T01:01:08.000Z", "eventId": "03d34580-61d4-11ea-9e23-cd38810ff7cd" }, "payload": { "partnerId": "12300014482", "sku": "83852627", "publishStatus": "UNPUBLISHED", "lifecycleStatus": "ACTIVE", "statusChangeReasons": { "REASONABLE_PRICE_NOT_SATISFIED": "Reasonable price requirements are not met" }, "itemId": "771087594", "itemName": "OVE Decors Lynton 36 in. Fruit Single Sink Bathroom Vanity with Tiger Granite Top", "category": "BATH AND LAUNDRY", "totalNumberOfOffers": 7, "sellerOfferPrice": 1049.95, "sellerShippingPrice": 0, "referencePrice": 680.59, "referencePriceURL": "https://www.amazon.com/dp/B07NPLPTYH?psc=1", "referencePriceType": "Amazon" }
}