PostNL API

Technical change specification

If you are using any version of the follow confirming (API’s), the product code content in field “ProductCodeDelivery” should be updated to match the new product code(s). These changes must be implemented between August 1st 2023 and January 1st 2024. During this period both the old and the new portfolio can be used. After January 1st 2024 only the new product portfolio can be used for sending from Belgium to the Netherlands.

Updating to the latest API version is advised.

Overview of the new portfolio for sending from Belgium to the Netherlands

Product codeService description
4890Standard shipment
4891Signature on delivery
4893Delivery to stated address only
4894Signature on delivery + Delivery to stated address only
4895***Age check 18+ + Delivery to stated address only
4896Signature on delivery, Delivery to stated address only, Return when not home
4897*Extra cover
4898**Pickup at PostNL location, Signature on delivery

Overview of the recommended product codes for replacing the old portfolios

Former product codeService descriptionRecommended product codeService description
4940Parcels EU to Business (Delivery to neighbour)4897Extra Cover
4944Parcels EU to Business (Delivery to neighbour)4897Extra Cover
3189Signature on delivery NL 4891Signature on delivery  
3533Pickup at PostNL location NL4898Pickup at PostNL location
3543Pickup at PostNL location NL4898Pickup at PostNL location** 
3089Signature on delivery + Delivery to stated address only NL 4894Signature on delivery + Delivery to stated address only
3087Extra cover NL4897Extra Cover
3096Signature on delivery + Delivery to stated address only + Return when not at home NL 4896Signature on delivery + Delivery to stated address only + Return when not at home
4907/4906Parcel EU 2C / 2B ***
Signature on delivery + Delivery to stated address only + Return when not at home
4952Parcel EU 2C4897Signature on delivery + Delivery to stated address only + Return when not at home
3085Standard shipment (NL-NL)4890Standard shipment (NL-BE)
3385Deliver to stated address only (NL-NL)4893Delivery to stated address only (NL-BE)
3438Standard shipment + Age Check4895Age check 18+ + Delivery to stated address only

* Business rule Insurance amount (type 02) is required and cannot exceed the maximum allowed amount (€ 5000,-). Please find more detailed specifications in the corresponding ShippingConfirming and Labelling API documentation. 

** It is possible to let your customers choose pick up points in the Netherlands. It is mandatory to use a frontend location webservice solution to let your customer choose a pick up point.

*** This product code contains different products depending on the Characteristic/Option combinations wherefore it does not translate to one product code. This code can be replaced by any of the new product codes. 

*** Combine these product codes with the following product option:
- product option: characteristic 002, option 014

Please note: if you send parcels to other EU destinations with Parcels EU codes, you can still use these codes for EU destinations other than Belgium and the Netherlands. 

Questions?

For questions related to the new shipping products please contact your PostNL account manager. 

Questions related to the technical implementation can be submitted here.