Shipping labels

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.

Before we start

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.

Shipping labels flow endpoints

The following endpoints should be configured to set up the flow to successfully ship an order with a shipping label purchased from bol.com:

  1. Retrieve open orders: returns a list of open orders eligible for shipping.

  2. Retrieve purchasable shipping labels: returns a list of shipping label options based on an orderItemId the retailer wishes to ship.

  3. Confirm order: confirms shipment of an order. Including the shippingLabelRuleCode will allow the retailer to purchase a label.

  4. Retrieve shipments list: returns a list of shipments, which will include previously confirmed orders and an associated transport method.

  5. Retrieve shipping label: returns a shipping label in PDF format to print and put on the package, by providing the transportId of the shipment.

All fees are automatically deducted from your monthly invoice.