Shipping with Verzenden via Bol.com

Introduction

Verzenden via bol.com is a service offered by bol.com where we commit to ship products sold by our partners with low shipping costs for you, placing the responsibility for shipments away from you and on to us. For more information, see the dedicated webpage.

Get started with Verzenden via bol.com

Below you will find a summary of the steps required to implement Verzenden via bol.com and more information on which elements should be updated for each API resource.

Sign up for Verzenden via bol.com

To use Verzenden via bol.com, you need to register yourself first. Registration must be done once through your bol.com Seller Dashboard (Instellingen > Diensten > Aanmelden voor Verzenden via bol.com). Registration is currently not available via the API.

More information about the registration process can be found here.

Update your Offers

Each offer that you want to mark for sale through Verzenden via bol.com requires that you add an indication to it. You can do this by setting the deliveryCode of the offer to VVB. Be advised that this delivery code is only allowed in combination when the method under the fulfillment element is set to FBR.

Setting the method to VVB applies to the create offer and update offer endpoints. You will also return the VVB code under the get offer endpoint and in our offer export file. You can find more details and code examples on our technical documentation page.

Retrieve your Orders

When receiving your order details, the distributionParty field under the orderItems.fulfilment element indicates whether this item requires shipment through bol.com or by yourself.

Customers can choose a delivery date for Verzenden via bol.com orders. This can be a date in the future. You should always hand over the order on the latest handover date that is given in the delivery options endpoint, so you don’t deliver the order too early or too late. Do not calculate your own handover date based on the Get order field exactDeliveryDate or the Get delivery options field latestHandoverDateTime.

Retrieve Verzenden via bol.com shipping labels

When retrieving Verzenden via bol.com shipping labels, you should follow the same initial steps as the normal shipping label flow.

You cannot use your own purchased shipping labels for orders that have distributionParty: BOL.

Manage handoverDetails

When you set up the Get delivery options endpoint, you will also find the handoverDetails element in the response. The fields within this element provide you with information regarding how and when you need to deliver your item at the transporter.

  • meetsCustomerExpectations is a boolean that indicates if the label can be used to deliver a order on the promised deliveryDate. If this field is 'false' this label cannot be used to deliver on the promised deliveryDate and this will have a negative consequence on your performance score. If this label is 'true' you have to deliver the order on the latestHandoverdatetime to get the order delivered on the promised deliveryDate.

    For example, you might want to use a label that cannot deliver on the promised delivery date due to its scheduling (such as using TNT_BRIEF to deliver on a Monday). This would result in the deliveryDate being unmet, so the field meetsCustomerExpectations will be false. You can still use the shipping label, but your performance score will be negatively affected.
  • latestHandoverDateTime indicates the final date and time at which the item must be handed over to the transporter. Failing to meet this date and time will result in a penalty (strike), as the promised delivery date towards the customer will no longer be be met, resulting in an unsatisfied customer. In that case, you are still able to purchase the label but it will be delivered later. The time linked to a delivery option differs per region.

    Please note that even though the field is called ‘latest handover date time’, packages should not be handed in (a day) earlier, as the promised delivery date towards the customer will also not be met.

    Always verify the opening hours of your drop-off point, as your drop-off point might close earlier.

  • collectionMethod indicates whether you need to drop off this item at the transporter (DROP_OFF), or whether the items are picked up at your address (PICK_UP).

Ship order item(s)

Verzenden via bol.com order items must be shipped with a purchased Verzenden via bol.com shipping label. When you buy such a shipping label, you will receive a shippingLabelId from the create a shipping label request. With the get a shipping label request you will receive the Transporter and the Track & Trace codes for the shipping label.

You should either provide the shippingLabelId or the transport element to ship a Verzenden via bol.com orderItem. You will receive an error message if you don’t use the correct shipping label.

The shipment of an orderItem is the trigger to pay for your Verzenden via bol.com shipping label.

Hand in package(s)

For more information about handing in your packages, see the dedicated Verzenden via bol.com webpage.

Retrieve your shipments

When receiving your shipment details, the distributionParty field under the shipmentItems.fulfilment element indicates whether this item was shipped through bol.com or by you.

Invoicing

An overview of all income and expenses can be found on your all-in-1 invoice, which you receive every month. Verzenden via bol.com shipping label fees are included in the all-in-1 invoice.