Version 3 of the Retailer API has been deprecated. Please migrate to the V4 API as soon as possible.
Shipping labels can be expensive, especially for products with low margins. As a service to help our partners, bol.com offers Voordelig Verzenden via Bol.com.
This service allows you to benefit from the bol.com bulk discounts on shipping labels, making them less expensive if you purchase them through us.
To make use of this service through the Retailer API we’ve created a guide to help you through the process step-by-step.
It’s important to note that each shipment is unique. For example
shippinglabel options can differ depending on the size of the article or the destination. It is therefore important to check the available options every time you use this method of shipping to avoid failed requests.
The following endpoints should be configured to set up the flow to successfully ship an order with a shipping label purchased from bol.com:
Retrieve open orders: returns a list of open orders eligible for shipping.
Retrieve purchasable shipping labels: returns a list of shipping label options based on an
orderItemIdthe retailer wishes to ship.
Confirm order: confirms shipment of an order. Including the
shippingLabelRuleCodewill allow the retailer to purchase a label.
Retrieve shipments list: returns a list of shipments, which will include previously confirmed orders and an associated transport method.
Retrieve shipping label: returns a shipping label in PDF format to print and put on the package, by providing the
transportIdof the shipment.
All fees are automatically deducted from your monthly invoice.