Get Single Offer

Get Single Offer

Retrieves information on a single offer

GET /offers/v2/parameters

Parameters

Name Type Description
EAN string Required. EAN number associated with this offer
Condition string Condition of the offer. It is possible to have more conditons per EAN.

omitting the condition will list all results for an EAN.

Example request

GET /offers/v2/0843591082877?condition=NEW

Example response

Status: 202 Accepted

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OfferResponse xmlns="https://plazaapi.bol.com/offers/xsd/api-2.0.xsd">
 <RetailerOffers>
  <RetailerOffer>
   <EAN>0843591082877</EAN>
   <Condition>NEW</Condition>
   <Price>50.00</Price>
   <DeliveryCode>24uurs-16</DeliveryCode>
   <QuantityInStock>1</QuantityInStock>
   <UnreservedStock>1</UnreservedStock>
   <Publish>true</Publish>
   <ReferenceCode>MEM1337</ReferenceCode>
   <Description></Description>
   <Title>Corsair Vengeance LPX 16GB DDR4-2400 16GB DDR4 2400MHz geheugenmodule</Title>
   <FulfillmentMethod>FBR</FulfillmentMethod>
   <Status>
    <Published>false</Published>
    <ErrorCode>NOT_PUBLISHED_BY_SELLER</ErrorCode>
    <ErrorMessage>The seller is on holiday</ErrorMessage>
   </Status>
  </RetailerOffer>
 </RetailerOffers>
</OfferResponse>

When omitting the condition you will receive a list with all offers for that EAN, including all conditions.

 

Example request

GET /offers/v2/0843591082877

Example response

Status: 202 Accepted

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OfferResponse xmlns="https://plazaapi.bol.com/offers/xsd/api-2.0.xsd">
 <RetailerOffers>
  <RetailerOffer>
   <EAN>0843591082877</EAN>
   <Condition>NEW</Condition>
   <Price>50.00</Price>
   <DeliveryCode>24uurs-16</DeliveryCode>
   <QuantityInStock>1</QuantityInStock>
   <UnreservedStock>1</UnreservedStock>
   <Publish>true</Publish>
   <ReferenceCode>MEM1337</ReferenceCode>
   <Description></Description>
   <Title>Corsair Vengeance LPX 16GB DDR4-2400 16GB DDR4 2400MHz geheugenmodule</Title>
   <FulfillmentMethod>FBR</FulfillmentMethod>
   <Status>
    <Published>false</Published>
    <ErrorCode>NOT_PUBLISHED_BY_SELLER</ErrorCode>
    <ErrorMessage>The seller is on holiday</ErrorMessage>
   </Status>
  </RetailerOffer>
  <RetailerOffer>
   <EAN>0843591082877</EAN>
   <Condition>AS_NEW</Condition>
   <Price>45.00</Price>
   <DeliveryCode>24uurs-16</DeliveryCode>
   <QuantityInStock>1</QuantityInStock>
   <UnreservedStock>1</UnreservedStock>
   <Publish>true</Publish>
   <ReferenceCode>OLD1337</ReferenceCode>
   <Description>1x gebruikt</Description>
   <Title>Corsair Vengeance LPX 16GB DDR4-2400 16GB DDR4 2400MHz geheugenmodule</Title>
   <FulfillmentMethod>FBR</FulfillmentMethod>
   <Status>
    <Published>false</Published>
    <ErrorCode>INSUFFICIENT_PERMISSIONS</ErrorCode>
    <ErrorMessage>Not allowed to sell this product with this condition.</ErrorMessage>
   </Status>
  </RetailerOffer>
 </RetailerOffers>
</OfferResponse>

Return values explained

In contrast to the version 1, there is no longer an OfferID. The unique identifier for an offer is it’s combination of EAN+Condition. This is now the same for API, FTP and Dashboard.

Name Type Description
EAN string EAN code for the product.
Condition string Whether the offer refers to a new or second hand product.
Available Conditions.
Price decimal The price of the product with a dot (.) as a decimal separator (Decimal). Maximum value: 9999
Deliverycode string The delivery promise that applies to this product.
Available Delivery Codes 
QuantityInStock int The amount of items in stock minus handled orders. As compared to the stock you sent us.

More info on stock in our Stock scenarios

UnreservedStock int The amount of items in stock minus handled order and minus open orders. As compared to the stock you sent us.

When this reaches zero, your offer will not be for sale on the shop.

More info on stock in our Stock scenarios

Publish boolean Boolean (Y/ N ) determines whether or not the Offer is for sale
ReferenceCode string A value sent by you to identify this particular offer when receiving orders.
Description string A description that is only applicable when the chosen condition is NOT “NEW”. This described the condition of the article to the buyer.
Title string Title for this product as shown on the webshop. When the EAN is new for bol.com your input will be shown. When this is already a known EAN, the bol.com title will be shown.
FulfillmentMethod string Specifies whether this shipment will be fulfilled by the seller (FBR) or by bol.com (FBB).

possible values:

  • FBB
  • FBR
Published boolean Shows whether or not this offer is published on the website. It is defaulted to N by bol.com if any errors occur in this offer or if out of stock.
Status
ErrorCode String if Published is set to N, this field will show the associated error code.

child element of Status

ErrorMessage string Explains the reason why this offer is not shown if Published is N

child element of status

Status

Every offer you request has a status, most often this status will be.

<Status>
 <Published>true</Published>
</Status>

If your offer is for some reason not valid to be shown on bol.com the status message will reflect this and explain why it is invalid.

There are several reasons why an offer might be rejected, some examples include:

  • You are not allowed to sell that specific product (e.g. certain pharmaceuticals or jewelry categories)
  • You are trying to add a duplicate offer (you already sell this product)
  • Your price is way above marketprice

We have listed al reasons why an offer might be rejects on: Appendix D – Offer Errors

It is also possible to set the publish status to false yourself or trigger this status by decreasing your stock to zero.