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 size of the article or destination. It is therefore important to check available options every time you use this method of shipping to avoid failed requests.

Intended use

The following steps are part of 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 eligable 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 retailer to purchase a label.

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

  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.