bol.com Retailer API migration guide from V3 to V5

Version 5 of the Retailer API introduces some significant improvements to bol.com’s partner developer tools. We recommend upgrading to V5 to take advantage of the enhanced designs and features in the new API.

The API lifecycle schedule can be found here. Please ensure that you migrate from V3 before it is removed on 1 October 2021.

New features in v4 and v5

New features are not documented in the migration guide. For details regarding the implementation of these features, refer to the release notes and related documentation.

Adding product information: serve your product content via the Retailer API.
Insights in assortment and sales: retrieve insights in your offer performance and expected sales forecast.
Process status in bulk: retrieve multiple process statuses in one single request.
Subscribe to relevant events (beta): subscribe to specific events from bol.com.
Retrieve your unpublished offers (beta): retrieve your offers that are not yet published.
New shipping label flow: purchase shipping labels from bol.com, including through the new Verzenden Via Bol.com service.
Search terms: see the items that bol.com customers are searching for.
Get orders with all statuses: track all orders from the last 48 hours, even if they have been shipped or cancelled.
Replenishments API: the Inbounds API is now the Replenishments API, and includes the ability to use bol.com’s first mile replenishments.

Changed resources from v3

To guide you through the right steps and take important changes into account, you can use this migration guide to migrate from V3 to v5. Any changes in this guide are compared to V3.

We changed IDs from integers to strings throughout V5 of the Retailer API. In the case of the Process status, the process-status-id is now a string. This will affect every endpoint that uses the processStatusId - often called id - in its response message. See the migration guides for more information. If you have this field stored, you should update it.
All BETA features, including the Unpublished Offers Report and the Subscriptions API, will be moved to V6 on 1 April, and removed from earlier versions on 1 May. You should migrate your endpoints if you are still using these features.

Table 1. Table of changed resources
Resource	Impact
Commissions	Low (4 changes)
Replenishments (previously Inbounds)	Resource has been replaced
Insights	Medium (10 changes)
Inventory	Low (8 changes)
Invoices	Low (4 changes)
Offers	High (17 changes)
Orders	High (63 changes)
Orders	High (61 changes)
Process status	High (5 changes)
Reductions	Endpoints removed
Returns	High (48 changes)
Shipments	High (48 changes)
Shipping labels	Low (3 changes)
Transports	Low (2 changes)