Update offer v1 – Deprecated

All documentation below refers to the Offer-API-Version-1. this version is DEPRECATED. Please refer to

Create and Update an Offer (v2)

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.

XSD: https://plazaapi.bol.com/offers/xsd/api-1.0.xsd
URL structure: https://plazaapi.bol.com/offers/v1/<offerID>
HTTP Verb: PUT
HTTP Header:
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 Example

<?xml version="1.0" encoding="UTF-8"?>
<OfferUpdate xmlns="http://plazaapi.bol.com/offers/xsd/api-1.0.xsd">
<Price>10.00</Price>
<DeliveryCode>24uurs-16</DeliveryCode>
<Publish>true</Publish>
<ReferenceCode>1234567890</ReferenceCode>
<Description>This is a new product so this description is of no use.</Description>
</OfferUpdate>

Errors

See Appendix D and Appendix E for error details