Offer Errors

Once the server is processing the offer create or update request, it will apply all sorts of business rules and decide whether the request is accepted or not. E.g. If a published offer is updated with invalid parameters (i.e. due to a price that exceeds € 9999,99), that same offer will be marked as “not published” and be taken offline from bol.com.

So the main question for any offer is whether or not it is published. And what the reason is for not publishing it. Due to the asynchronous nature of our API, errors are not reported immediately. For offers that are not published a Reason Code and Reason Message are returned in the list of all offers (see tables below).

Note: Despite that there can be more faults in the request, the reason of the first encountered error will be communicated through the response.

Element Description
Reason Code A global categorization of the reason. It is recommended to use the Reason Category in program logic.
Reason Message A human friendly, more in-depth reason. Note: The reason messages are prone to change and must NOT be used in program logic.

Reason Codes

Reason Codes Description Possible solution
INSUFFICIENT_PERMISSIONS Permission issue. Most likely caused by the seller not being allowed to publish articles in a particular category (e.g. jewelry). Another possibility is that the product is banned from bol.com. You can request access to restricted categories via Zakelijk verkopen – Verkooprechten.
INVALID_OFFER There is information missing/incorrect regarding the offer input values rendering it invalid. Adjust the input value(s) based on the reason message. 
NON_EXISTENT_OFFER The offer that was attempted to mutate does not exist. Adjust the input value(s) for either condition, description and/or EAN.
NOT_PUBLISHED_BY_SELLER The seller explicitly set the offer to “publish=false”. Insert the value “true” for parameter “publish” within the upsert request.
OTHER
OUT_OF_STOCK The offer has no more stock according to bol.com. Note: Any unfulfilled orders will affect bol.com’s perception of the seller’s stock. Insert a positive value for parameter “QuantityInStock” within the upsert request.
UNMATCHED_OFFER The EAN specified for the offer is not found in bol.com’s databases. As a result, there is no product information available. Create the product information in the seller portal first. When done, try to create the offer again.

All Reason Messages per Reason Code

Note: “%s” indicates a variable value.

INSUFFICIENT_PERMISSIONS
Not permitted to sell products in this category.
Seller not permitted to sell product %s.
Seller not permitted to sell in this country.
Delivery time %s not permitted for seller.
Price %s not permitted for seller.
Not permitted to sell this product: %s.
The seller is not approved.
Not allowed to sell this product with this condition.
FBB not allowed.
FBB not allowed for second hand products.
FBB not allowed for this product.
Product may only be sold by selected vendors, please contact Partner Service.

 

INVALID_OFFER
Offer with id %s already exists for this product.
Value for stock too low: %s.
Value for stock too high: %s.
Delivery time is missing.
Comment not permitted: %s.
Invalid EAN code: %s.
Unknown delivery time: %s.
Unknown condition.
The offer is blocked by bol.com.
Unknown fulfillment method.
EAN too long: %s.
Reference comment too long: %s.
Comment too long: %s.
Delivery code too long: %s.
ISBN or EAN is missing.
Stock is missing.
Price is missing.
Invalid price.
Invalid title.
Condition is missing.
Condition too long: %s.

 

NON_EXISTENT_OFFER
Offer not found or already deleted.
This offer has been deleted.
The offer is expired.

 

NOT_PUBLISHED_BY_SELLER
The seller has not marked the offer for-sale.
The seller is on holiday.
Invalid For sale mark.

 

OTHER
Unknown errorcode %s for offer.
The offer status does not allow publication.
We are not able to validate ‘Mijn leverbelofte’ of the seller because DLY is out of service.

 

OUT_OF_STOCK
Out of stock OR remaining stock is reserved for pending orders.

 

UNMATCHED_OFFER
Unknown EAN code %s.
This product has been blocked for sale by bol.com.
For this product essential product information is missing. Go to ‘Mijn aanbod’ to enrich this product.

 

PRICE_NOT_COMPETITIVE
Price too high.