Deliverydate

Documentation

With this API you can determine the first date customers can receive their parcels. And it is also possible to determine the date you need to supply the parcels to PostNL in order to have the parcels delivered to your customers on a given shipping date.

Development

All the necessary information for implementing this API.

Why use the Deliverydate API

Recommended starting point

Use this service as a starting point in the Timeframe API to show customers the possible day and time of arrival.

Avoid showing not possible delivery dates
PostNL delivery days and dates are always up to date by using this service and takes into account ‘non-business’ days like Sundays and public holidays.

Find out the delivery date and the send date of the parcels

This API contains two methods; it calculates the expected delivery date for shipment and can calculates the date to handover or send the shipments.

Get started

Request your (Sandbox) API Key and start using the API.
As soon as you have an API key, it is recommended to run our Postman collections. Here you can find code examples of the various services and products we offer. This makes implementing the APIs much easier.

GUIDELINES

Using the methods
Based on the (first possible) shipping date you can determine the appropriate delivery date by PostNL. The delivery date can be requested through the GetDeliveryDate method.

You can use the GetSentDate method to determine the date that you need to supply the parcel to PostNL in order to have the parcel delivered to your customer on the date supplied to this service.

You can use Shipping Duration to define a delay in shipping the parcels to a PostNL location. Shipping duration means the duration it takes from the moment the order is created up until delivery to PostNL.
A value of 1 means that you prepare and send the shipment on the same day. A value of 2 means that there is a day in-between preparing the shipment and the shipment arriving at a PostNL location etc.

Sundays and public holidays
This service takes into account ‘non-business’ days like Sundays and public holidays.

Sunday sorting
It is possible to allow for Sunday sorting. With Sunday sorting enabled, Monday will also be a valid delivery day. When using this option, make sure you have selected Monday delivery in your contract.

Delivery options (GetDeliveryDate)
It is possible to specify which delivery options should be considered when returning a deliverydate using the field Options. The GetDeliveryDate method will also specify which delivery option is applicable to the returned delivery date in the Option field.
Only one delivery option can be specified at once (with exception of Sameday in combination with Evening).

Options

Description

Daytime

Daytime delivery

Evening

Evening delivery

Morning

Morning delivery before 10:00

Noon

Morning delivery before 12:00

Today*

Delivery on day of handover to PostNL

Sunday

Sunday delivery

Sameday

Sameday delivery (must be used in combination with Evening)

Afternoon

Afternoon delivery before 17:00

* The Today delivery option will be returned on any given day (Mon – Sun), but will only be on the first following business day.

Delivery options (GetSentDate)
It is also possible to specify the above delivery options when returning a sentdate by using the Options field.

Note: the given Options will not effect the response; it is always processed as Daytime option.

Best practice
Integrate all three PostNL frontend webservices into your checkout and empower your customers to choose the delivery option that suits them best.

First use the Deliverydate webservice (Get deliverydate method) to determine the available and possible delivery date(s), based on your shipping date. Use the received date from this service as a starting point in the Timeframe webservice to show customers the possible day and time of arrival. In this way you avoid showing not possible deliverydates. The postal code that customers enter by placing their order, determine the timeframes that apply to their address.

Use the Location webservice to show the nearest pickup point(s) based on the postal code or coordinates of the customers. The location(s) can be shown in a map if you want to make it visually more appealing.
The Visual assets can be useful to create a delivery options frame in your checkout.