This doc page has moved! You should be automatically redirected to the new location. If you are not redirected automatically, follow this link to the new page.

Managing Offers

Once Offers are created, there are calls to update, publish, retrieve, and delete these Offers.

Updating Offers

The Update Offer call is used to update a published Offer (active eBay listing) or unpublished Offer. The requirements of the update action are nearly identical to the create action, in the fact that the update action completely overwrites all values/settings in the existing published/unpublished Offer. All applicable fields must be passed in even if their values are not changing. The only difference is that a offerId value must be passed in at the end of the Update Offer call URI to identify the Offer to update. The offerId value for an Offer is created with a successful Create Offer call, and is returned in the response payload of that call.

For a published Offer, a successful Update Offer call will update the associated active eBay listing in real time. For an unpublished Offer, the seller will have to use the Publish Offer call to create the active eBay listing.

Publishing Offers

The Publish Offer call is used to convert a unpublished Offer into an active eBay listing. The offerId value must be passed in at the end of the Publish Offer call URI to identify the Offer to publish. If the Publish Offer call successfully creates a new eBay listing, the new eBay listing ID is returned in the response payload.

Getting and Deleting Offers

The Get Offer call should be used to retrieve all of the details of a specific Offer. The offerId value is passed in at the end of Get Offer call URI. The Get Offers call will retrieve all Offers associated with a specific SKU value.

The Delete Offer call is used to delete a specific Offer. The offerId value is passed in at the end of Delete Offer call URI. If the call is successful, this action will end the active eBay listing associated with this Offer.