Upcoming change to processStatusId format

Beginning on May 12, the format of the processStatusId returned by our APIs will be updated. Instead of only numeric values, the processStatusId will now use a new format, such as: 019d4d55-8027-7ac0-b4dd-903528125d36.

Check your own implementation
The processStatusId has always been returned and defined in the API as a string. This remains unchanged. Until now, the value has been numeric, which may have led some implementations to handle it as a number. With the upcoming change, the value will use a different string format.

We recommend verifying that your implementation treats processStatusId strictly as a string and does not rely on its internal format. You could check your implementation through this demo endpoint: https://api.bol.com/retailer/public/Retailer-API/demo/v10-PROCESS_STATUS.html

Rollout plan
The change will be rolled out in phases over two weeks, starting on 12 May:
• Week 1: Content, shipments, invoices, and shipment labels
• Week 2: Offer-related endpoints

By the end of week two, the new processStatusId format will be fully live across all affected endpoints.