Shipping with Verzenden via Bol.com (VvB)

Introduction

Verzenden via Bol.com (VvB) is a service offered by bol.com where we commit to ship products sold by our partners with our promise "Order before 23.59, delivered tomorrow". This fast delivery promise ensures more sales and low shipping costs for you, and places the responsibility for shipments away from you and on to us. For more information, see the dedicated webpage.

To use Verzenden via Bol.com, be advised that you need to register yourself first. You can find more information about this process here.

Get started with VvB

The process to set up VvB via the Retailer API requires you to follow the same initial steps as the normal shipping label flow.

You cannot set up your own purchased label if you are participating in VvB.

Additionally you will need to update the following elements:

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.

  • 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.

    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).

  • 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. You can still use the shipping label, but your performance score will be negatively affected.

Update your Offers

Each offer that you want to mark for sale through VvB 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.

Update your Orders

When receiving your order details, a new field has been introduced that indicates whether this item requires shipment through bol.com or by yourself. The distributionParty field under the orderItems.fulfilment element has two possible values:

  • RETAILER indicates that this order requires shipment by you as the retailer

  • BOL indicates that this order must be shipped through bol.com in VvB.

Update your Shipments

When receiving your shipment details, the same new field has been introduced to indicate whether this item was shipped through bol.com or by yourself. The distributionParty field under the shipmentItems.fulfilment element has the same two possible values as you will find in the order details:

  • RETAILER indicates that this order requires shipment by you as the retailer

  • BOL indicates that this order must be shipped through bol.com in VvB.