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 code | Service description |
|---|---|
| 4890 | Standard shipment |
| 4891 | Signature on delivery |
| 4893 | Delivery to stated address only |
| 4894 | Signature on delivery + Delivery to stated address only |
| 4895*** | Age check 18+ + Delivery to stated address only |
| 4896 | Signature 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 code | Service description | Recommended product code | Service description |
|---|---|---|---|
| 4940 | Parcels EU to Business (Delivery to neighbour) | 4897 | Extra Cover |
| 4944 | Parcels EU to Business (Delivery to neighbour) | 4897 | Extra Cover |
| 3189 | Signature on delivery NL | 4891 | Signature on delivery |
| 3533 | Pickup at PostNL location NL | Pickup at PostNL location | |
| 3543 | Pickup at PostNL location NL | 4898 | Pickup at PostNL location** |
| 3089 | Signature on delivery + Delivery to stated address only NL | 4894 | Signature on delivery + Delivery to stated address only |
| 3087 | Extra cover NL | 4897 | Extra Cover |
| 3096 | Signature on delivery + Delivery to stated address only + Return when not at home NL | 4896 | Signature on delivery + Delivery to stated address only + Return when not at home |
| 4907/4906 | Parcel EU 2C / 2B *** | Signature on delivery + Delivery to stated address only + Return when not at home | |
| 4952 | Parcel EU 2C | 4897 | Signature on delivery + Delivery to stated address only + Return when not at home |
| 3085 | Standard shipment (NL-NL) | 4890 | Standard shipment (NL-BE) |
| 3385 | Deliver to stated address only (NL-NL) | 4893 | Delivery to stated address only (NL-BE) |
| 3438 | Standard shipment + Age Check | 4895 | Age 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 Shipping, Confirming 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.