Offer request error codes

While retrieving the offer information through the API, there are several reasons why an offer could not be published on the platform even after its creation.

The specific reason can be inspected through the notPublishableReasons field element offered by Retrieve an offer by its offer id endpoint.

Alternatively, you can also investigate the reasons behind multiple unpublished offers using the unpublished offers report offered by the Request an unpublished offer report endpoint. For more information, see Unpublished offer report.

The table below shows the currently available error codes and their interpretations. The list below is subject to change due to the dynamic nature of the platform.

Error code Meaning Description How to proceed

1000

ISBN_EAN_INCORRECT

Specified EAN is not correct, and it does not adhere to the EAN specification standards.

Ensure that you have entered a correct EAN that adheres to the EAN-13 barcode standard.

1001

CONDITION_INCORRECT

The specified condition of the offered product does not match with its product category.

Ensure that the condition of the product in the created offer corresponds to the correct product category based on the table below.

Product category Product condition

NEW

  • NEW

SECONDHAND

  • AS_NEW

  • GOOD

  • REASONABLE

  • MODERATE

For example, if your product belongs to a SECONDHAND product category, specifying the condition NEW in the offer will result in an error.

1002

PRICE_INCORRECT

The price configured for the specified offer is not within the permitted boundaries.

Ensure that the configured price is within the permitted boundaries of 1-9999.

1003

STOCK_INCORRECT

Either of the following could be the reason for this error:

  1. The stock value configured for the specified offer is too low and is not within the allowed boundaries.

  2. The stock value configured for the specified offer is too high and is not within the allowed boundaries.

Ensure that the configured stock value is within the permitted boundaries of 0-999.

1007

COMMENT_INCORRECT

Either of the following could be the reason for this error:

  1. The specified comment does not adhere to the standards.

  2. The specified comment is too long.

Based on the type of the error encountered, adopt any one of the following to resolve the error:

  1. Ensure that you don’t include telephone numbers or e-mail addresses within your comment.

  2. Ensure that the length of the specified comment is within 0-2000 characters.

1010

FULFILLMENT_CALENDAR_INCORRECT

Issue in the configuration of your offer with MijnLeverbelofte calendar.

Check the MijnLeverbelofte configuration in your account settings. If you are unable to resolve it by making changes to your calendar, contact partner services for assistance.

2

DELIVERY_PROMISE_UNKNOWN

Delivery time to customer can not be calculated yet.

This will resolve itself within 3 hours, if not then contact partner service.

2000

BLOCKED

Your partner account has been temporarily closed. Ensure that your account has an approved status to make the offers available to the customers.

Re-open your account by following the instructions provided here.

2002

UNMATCHED_OFFER

Product is blocked and is prohibited to be sold on the bol platform.

Check the assortment guidelines and verify if your product is permitted to be sold. To unblock this product, contact partner services.

2003

EXCLUSIVE_PRODUCT

Partner account does not have the appropriate selling rights. The product that you want to sell requires a selective distribution policy where only specific partners receive permission to sell.

Check the applicable selling rights for your product and the process of requesting additional selling rights here.

2004

  1. FULFILLMENT_NOT_ALLOWED_FOR_CONDITION

  2. FULFILLMENT_NOT_ALLOWED_FOR_PRODUCT

Following are the reasons for these errors:

  1. The specified fulfillment method cannot be used in combination with a second-hand product condition.

  2. The specified fulfillment method "FBB` cannot be used for this product due to its size.

Based on the type of the error encountered, adopt the following to resolve the errors:

  1. Change the fulfillment method to sell this product in a second-hand condition.

  2. Change the fulfillment method to sell this product. For more information on FBB, check the assortment regulations.

2005

INSUFFICIENT_PERMISSIONS

Products with second-hand condition cannot be sold within the specified category.

Change the category in which you are selling your second-hand product.

For more information on which specific categories permit selling second-hand products, check the assortment policy.

2006

BRAND_NOT_ALLOWED

Selling rights missing to sell a particular brand within a specific category.

Check the applicable selling rights and the process to request additional selling rights here.

2007

FUTURE_RELEASE

Product rejected because of being under embargo and cannot be made available to the customers.

Selling unreleased products is not supported. To unblock your product, contact partner services for assistance.

3000

INSUFFICIENT_PERMISSIONS

Any one of the following could be the reason for this error:

  1. Appropriate selling rights are missing.

  2. Selling rights missing in the account configuration to sell the product in a specific country.

  3. Your partner account has been temporarily closed. Ensure that your account has an approved status to make the offers available to the customers.

  4. Partner account does not have the appropriate rights to use the FBB fulfillment method for your offers.

  5. This specific product type is not permitted to be sold on bol. Some examples are ebooks, digital products, medicines etc.

Based on the type of the error encountered, adopt any one of the following to resolve the error:

  1. Check the applicable selling rights and the process to request additional selling rights here.

  2. Re-open your account by following the instructions provided here.

  3. Check the guidelines to get access to FBB (Logistics via bol) proposition here.

  4. Check the assortment policy here.

3000

MISSING_RIGHTS_CATEGORY_BRAND

Additional selling rights missing for specific category of products. For example, the jewellery category permits only specific brands to sell.

Check the applicable selling rights for your product and the process to request additional selling rights here.

3000

INTERNAL_PRODUCT_CHECK

Offer is temporarily blocked because internal quality checks for this category of assortment is in progress.

Wait upto 48 hours for the internal checks to complete. If the error still remains, contact partner service for assistance.

3000

TECHNICAL_ERROR

Offer is still being processed due to encountered technical error.

Wait upto an hour for the error to resolve. If the error continues, update your offer to resolves the issue. If the error still persists, delete and re-create the offer.

3001

ASSORTMENT_POLICY_INFRINGEMENT

Additional information is needed before you can sell this product.

Most cases can be solved by providing additional information to bol. In the seller dashboard, you can see what information is needed.

4000

PRICE_NOT_COMPETITIVE

The price configured for the offer is too high hence the offer will not be made available to the customers.

Check the pricing policies and reduce the price of your offer.

4001

DUPLICATE_OFFER

An active offer for the product already exists. This is because you are using an EAN that is connected to another EAN that you are already offering.

Either update the existing offer or delete it before re-creating an offer with a different EAN. It is not possible have an active product with two offers even if the EAN attached to the product is different.

4002

NON_EXISTENT_OFFER

The offer you are trying to update or retrieve has been deleted.

Create a new offer for the product.

4003

NOT_PUBLISHED_BY_SELLER

Either of the following could be the reason for this error:

  1. The offer has been invalidated and is not available to the customers because the onHoldByRetailer parameter has been set to true.

  2. All the offers for which you handle the fulfillment have been invalidated because the account is set to holiday mode.

Based on the type of the error encountered, adopt any one of the following to resolve the error:

  1. Update the offer and set the onHoldByRetailer parameter to False.

  2. Change the holiday settings for your account to open.

4003

OUT_OF_STOCK

No stock available for this offer because of any one of the following:

  • You changed the stock value.

  • You cancelled an open order. As a result, your offer is offline.

  • Stock got adjusted after orders were processed.

  • Stock was reserved for current open orders.

Update the stock for your offer. Ensure that stock is available even after taking open orders into consideration.

4004

UNMATCHED_OFFER

Either of the following could be the reason for this error:

  1. The product category for the product is missing. The offer was successfully created, however to make it available to the customers, additional product information is required.

  2. One or more mandatory attributes for this product are missing.The offer was successfully created, however to make it available to the customers, additional product information is required.

Based on the type of the error encountered, adopt any one of the following to resolve the error:

  1. Add a product category for your product followed by required attributes. Ensure that you add all the required information for this product either using the Retailer API or through your partner account.

  2. Enrich the missing mandatory attributes of the product either using the Retailer API or through your partner account.