All documentation below refers to the Offer-API-Version-1. in February 2017, Offer-API-Version-2 will be released.
This interface allows for updates on existing offers for the authenticated seller.
Note that this interface does not allow for stock updates.
A separate interface exists for that sole purpose.
URL structure: https://plazaapi.bol.com/offers/v1/<offerID>
HTTP Verb: PUT
Content-type: application/xml; charset=UTF-8
X-BOL-Date: Fri, 07 Oct 2011 13:24:01 GMT (See “Authentication” for more info)
X-BOL-Authorization: 0123456789abcdef:7ZHDSYabavdvIG0N4h1py//u3n/UNaqKdqblLhquMig= (See “Authentication” for more info)
Root element: OfferUpdate
Sub elements (all fields are required although ReferenceCode and Description can go without value):
|Element||Max Length / Value||Description|
|Price||9999.99||The price of the product with a dot (.) as a decimal separator|
|DeliveryCode||N/A||The delivery promise that applies to this product.See Appendix C – Delivery Codes|
|Publish||N/A||Boolean (true / false) determining whether the seller desires the product to be offered for sale on the bol.com website or not.Note 1: Even when set to true other factor may cause the offer not to end up being for sale.
Note 2: This field is identical to the “ForSale” field that exists in the FTP variant of offer management.
|ReferenceCode||20 bytes **||A value that may help you identify this particular offer when receiving orders. Element can optionally be left empty.
Note that the offer ID is not (yet) passed along with the Open Offers API call
|Description||2000 bytes **||A description that is shown on the website only if the product is not new. Element can optionally be left empty.|
**) Fields that have maximum lengths in bytes are UTF-8 fields that can contain up to 2000 bytes in data.
<?xml version="1.0" encoding="UTF-8"?>
<Description>This is a new product so this description is of no use.</Description>