Postnl.nl

Checkout

Documentation

The Checkout API combines the functionality of the DeliveryDate, Location and Timeframe API’s. So  you only need 1 API for showing all PostNL delivery options in your checkout. In this way it becomes easier to implement the delivery options and there is also less overhead in requesting the PostNL services by using this 3-in-1 API.

Development

All the necessary information for implementing this API.

Why use the Checkout API?

Delivery options
This API provides the possible day(s) of delivery, timeframes and PostNL pickup locations to display in the checkout of a webshop. Based on the address of the customer, orderdate and specified delivery options, you get timeframes and nearest PostNL pickup locations in the response.

Customers convenience
Enhance your customer's online shopping experience by providing more control over the delivery of their purchased product. Integrate the PostNL frontend webservices into your checkout and empower your customers to choose the delivery option that suits them best.

More information and control 
Using the Checkout API gives your customers more information and control about the arrival of the parcels. But it is good to realize that it gives you, the webshop, also a responsibility to deliver the parcel on time by PostNL.

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

Use of the webservice
This API can be used to fill a webshop’s checkout page. 

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

Holiday sorting
It is possible to allow for holiday sorting. With holiday sorting enabled, you can tell PostNL that you will be able to deliver the parcel to PostNL during holidays.

Sustainability options
You can show customers when their parcel can be delivered sustainably. In the response of the API the follow sustainability codes be distinguished:

Code 01 = Sustainable delivery
Code 02 = Sustainable option
Code 03 = Sustainable delivery + Sustainable option
Code 00 - Not available

You can build in the corresponding communication messages in your checkout; 

Sustainably delivery;  “Duurzaam bezorgd”
Sustainable option;  “Duurzame optie”

Not available: Not a sustainable option (yet). 

Sustainably delivery
1. PostNL delivers the parcel to your address with an electric vehicle or with a sustainable fuel vehicle.
2. PostNL delivers the parcel to a PostNL location with an electric vehicle or with a sustainable fuel vehicle.

Sustainable option
If we can deliver the package at a PostNL retail location or in a parcel machine we deliver fewer kilometers. We can also deliver multiple parcels at 1 (retail) point. This results in less CO2 emissions.

In the below file you can find the visual assets which you can you use in your checkout to show the sustainability options.

Visual assets

Delivery options
It is possible to specify which delivery options should be considered. The possible values are:

OptionDescription
DaytimeDaytime delivery
EveningEvening delivery
SundaySunday delivery
TodayDelivery on day of handover to PostNL
SamedaySameday delivery
08:00-09:00Guaranteed delivery between the timeframe specified
08:00-10:00Guaranteed delivery between the timeframe specified
08:00-12:00Guaranteed delivery between the timeframe specified
08:00-17:00Guaranteed delivery between the timeframe specified
PickupPickup at PostNL location

All the above delivery options can be used in the request of the Checkout API. PostNL will charge an additional amount for delivery of the parcels with the options Evening, Morning, (After)Noon, Sameday, Delivery on demand, Guaranteed delivery, Sunday and Today. For specific costs and the activation of this delivery options, it is recommended to consult your PostNL Pakketten account manager. For Sunday, Sameday and Today delivery it is even mandatory to consult your account manager.

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

Visual Assets
The Visual Assets can be useful to create a delivery options frame in your checkout.

Warnings
Warnings are returned when there is a functional problem with the request (e.g. when an address is not recognized, or when no delivery options are available).