Pre-alerting change to use additional services for International products

Next year, we’re renewing our international packet and parcel portfolio. This will make it possible to select additional services per product. The choice of services offers you extra flexibility. You can easily choose per item which service you require. Do you send valuable items? Then you can choose to send the item with an insurance. Or do you prefer a cheaper option? Simply turn off the proof of delivery (signature) for that item.

The new additional services will be available per the 1st of January 2023. In order to profit from our new international services, we ask you to adjust the way of pre-alerting in advance. Please see the instructions to adjust your way of pre-alerting below.

Per the 1st January 2023 there are two methods of pre-alerting your shipments. It’s preferable to use our new commercial product and services API set up as this is the most future proof. This setup however, requires you to include a new product segment in your current API call. We will also support a way of pre-alerting based on our current API set up, based on the product options segment. This setup requires less changes from you, but is less future proof.

Pre-alerting using the current API set up (productcodes + options)

The PostNL API can be used with a variety of PostNL products. Using the current API set up in combination with the options segment enables you to unlock the new International Parcel product portfolio, while also allowing you to use our new add on services.

See product codes and options

Example call current API set up (productcodes + options)

EU of non-EUServiceOld ProductCodeDeliveryNew ProductCodeDeliveryCharacteristic & Option ICharacteristic & Option II
Parcel EU (2C)Track&Trace Insured Plus4952/49444907004-016101-012

"ProductCodeDelivery": "4907",
            "ProductOptions": [
                {
                    "Characteristic": "004",
                    "Option": "016"
                },
                {
                    "Characteristic": "101",
                    "Option": "012"
                }
            ],

Pre-alerting using the new API set up (commercial product and service)

The PostNL API can be used with a variety of PostNL products. Using the new API set up enables you to unlock the new International product portfolio, while at  the same time allowing you to use our new add on services.

See commercial product and service

Example call using the new API set up (commercial product and service)

EU of non-EUServiceOld productcodeCommercial ProductCodeBUNDLE (PAK)SERVICE I (BEZ)SERVICE II (VPK)ProductCode
Parcel non-EUTrack&Trace Insured Plus4947/494517000PAK0032-VPK 006.004

"Product": {
                "CommercialProductCode": "17000",
                "CommercialServiceCodes": [
                    "VPK:6:4",
                    "PAK0032"
                ]
            },

EU of non-EUServiceOld productcodeCommercial ProductCodeBUNDLE (PAK)SERVICE I (BEZ)SERVICE II (VPK)ProductCode
PacketTrack&Trace Insured690620310PAK0031--7105

"Product": {
                "CommercialProductCode": "20310",
                "ProductCode": "7105",
                "CommercialServiceCodes": [
                    "PAK0031"
                ]
            },

For more information please contact your Account Manager or IT consultant.