Products

The PostNL Parcels API can be used with a variety of PostNL Pakketten shipping products. Each shipping product requires to be agreed upon in a contract between PostNL Pakketten and customers. The product codes mentioned must be used in various requests. The combilabel product codes are mapped to regular product codes.

Some specific product codes have different business rules which they need to comply with.

We distinguish three common products:

Product code

Description

3085Standard shipment

3385

Deliver to stated address only

3090

Delivery to neighbour + Return when not home

3390

Deliver to stated address only + Return when not home

Business rules (for all products)

  • Receiver address fields required:
    Home number (only mandatory for Benelux shipments)
    Postcode (only mandatory for Benelux shipments)
    City
    Country code
    Street
    Last name/ Company name (at least one is required)
  • Barcode requirements*:
    Type must be 3S
    Range must be 1-4 letter string
    Serie must be 7-12 digits
    Barcode must be 13-15 characters long

*Not mandatory for Parcels non-EU labels.

Product code

Description

3087

Extra Cover

3094Extra cover + Return when not home

Business rules

  • Insurance amount (type 02) is required. 
  • Insurance amount entered cannot exceed the maximum allowed amount (€ 5000,-)

Product code

Description

3089

Signature on delivery + Deliver to stated address only

3096

Signature on delivery + Deliver to stated address only + Return when not home

3189

Signature on delivery

3389

Signature on delivery + Return when not home

With the delivery option Pickup Points your customers can choose a pick up point (in Dutch: Ophalen bij PostNL-punt to pick up their parcels.

More than 4000 pick up points available in supermarkets, bookstores etc.

It is mandatory to use a frontend solution of PostNL to let your customers choose a pick up point. This frontend solution will return the correct information about the pick up point, which you will have to use in the Shipping, Labelling and/or Confirming API. Please check the specific documentation for more specific information.

Note:
It is also possible to let your customers choose pick up points in Belgium.
Please contact your PostNL accountmanager if you consider this option. For more information see the paragraph Pickup at PostNL Location Belgium.

Furthermore, in the Shipping, Labelling and/or Confirming API you will need to provide us with:

  • the complete address of your customer
  • the complete address of the pick up point

Confirming is essential for Pick up Points shipments. Without a confirming on time, it is not possible to process these parcels.

Product code

Description

3533

Ophalen bij PostNL locatie + Signature on Delivery

3534

Ophalen bij PostNL locatie + Extra Cover

3543 *

Ophalen bij PostNL locatie + Signature on Delivery + Notification

3544 *

Ophalen bij PostNL locatie + Extra Cover + Notification

* These products can only be used after consulting your PostNL Pakketten account manager.

Business rules

  • Receiver address fields required:
    Company name or last name
    Street
    Home number
    Postcode
    City
  • Ophalen bij PostNL locatie address fields required:
    Company name
    Street
    Home number
    Postcode
    City
  • Receiver contact fields required (only for the product codes with Notification):
    Email address or mobile phone number

With this product you will have the possibility to send a shipment that fits into the mailbox of your customers and have some shipping status information during the shipping process.

Product code

Description

2928

Mailbox parcel + Unsorted (ongesorteerd aanleveren)

 

2929

Mailbox parcel + Sorted (gesorteerd aanleveren)

Note: It is not possible to sent multiple shipments of this product (Multicollo) in one request to the Shipping or Labelling webservice.

Please use the latest version of the Shipping | Labelling API because a required coding line is added to the Mailbox parcel label template.

What is a coding line?
A coding line is a readable line of text, consisting of letters and numbers. It is printed on all postal items we process through our letter department and allows us to deliver your mail smarter and faster.

The coding line is based on parameters such as delivery date and address and therefore address-specific content of the coding line can change over time. To ensure its validity coding lines must be retrieved from an online PostNL solution. 

When the coding line has been successfully generated you will also see the Letter on the labels of the sorting center which you will need for productcode 2929 (BBP+ sorted).

Why is a coding line important?
With a coding line, our machines and employees can prepare each postal item and ensure that it is sorted for the correct delivery area. By using a coding line, we’re able to deliver your mail smarter and faster.

Proces
You can only generate coding lines if you add the DeliveryDate during the labelling phase. The DeliveryDate can be in the format date <dd-mm-yyyy> or in the format date+time <dd-mm-yyyy hh:mm:ss>. The date is mandatory, but you can choose whether you want to add the time as well.

For a correct DeliveryDate you can use the next following working day.

Please use the exact same DeliveryDate during generating labels and confirmation.

Error codes of the coding line (default coding lines)
Please make sure that single Coding text requests are made with a minimum interval of 200 milliseconds between service calls. Also make sure to complete this process at least 3 times before falling back to the default coding line. This way you get as many good coding lines as possible on the parcels.

N0N coding line 

#000N0N#00#0000#

This default coding rule occurs if no proper coding rule is issued within the process before the labelling process continues.

X0X coding line

#0000X0X#00#0000#

This default coding rule can be caused by a foreign address, an address unknown (to PostNL), the presence of a PostNL service at that address (eg moving service) or an incorrect use of the DeliveryDate. If larger amounts of X0X coding rules are generated, it is often because the DeliveryDate is not correctly specified (see above).

This product offers you the ability to make sure that confidential and age-validation transactions can be secure. So if you have some product(s) were identification or age control is required, it is possible to let the deliverer check the ID.

Age validation

Product code *Description
3438Standard shipment + Age Check
3443Extra Cover + Age Check
3446Extra Cover + Retun when not home + Age Check
3449Retun when not home + Age Check
* These products can only be used after consulting your PostNL Pakketten account manager.

Combine these product codes with the following product option: 

  • product option: characteristic 002, option 014
We distinguish the following types:
TypeDescription
01Dutch residence document
02Dutch ID
03Dutch passport
04Dutch driving license
05European ID
07Foreign ID

Pickup Points (ID check) 

It is also possbile to send the parcels to PostNL Pickup Points. You can use the below product codes. Please note that you also have to use the product options and business rules as described above.

Product code *Description
3571Ophalen bij PostNL locatie + Age Check 
3574Ophalen bij PostNL locatie + Age Check + Notification
3581Ophalen bij PostNL locatie + Extra Cover + Age Check
3584Ophalen bij PostNL locatie + Extra Cover + Age Check + Notification
* These products can only be used after consulting your PostNL Pakketten account manager.

ID Check products must be used in combination with a specific product option:

  • Age validation requires product option: characteristic 002, option 014

PostNL offers the possibility of sending registered mail items. This is called Registered letter labels. This offers you the ability to make sure that confidential and age-validation transactions can be secure. So if you have some letter(s) were identification or age control is required, it is possible to let the deliverer check the ID.

There are two possibilities:

- Registered letters (1010, 1011, 1020, 1410, 1420)

- ID check labels (1175)

These products can only be used after consulting your PostNL account manager.

Product code

Description

1010, 1011*

Registered letter

1020Registered parcels Losse Post
1410Registered letters Partijen Post
1420Registered parcels Partijen Post

1175

Letter + ID check

* To be used in combination with franking machine.

Offering dangerous goods (ADR shipments) with a statutory exemption, is only possible if a special business contract of carriage has been concluded with PostNL Pakketten. The transport of dangerous goods with a statutory exemption is permitted subject to certain conditions. Please contact your PostNL Pakketten account manager if you want to ship this goods. All the domestic product codes can be used in combination with dangerous goods, except the product codes for letters. The products can only be used after consulting your PostNL Pakketten account manager. 

Combine these product codes with the following product option:

  • product option: characteristic 136, option 006

Business rules

  • Product option and Characteristic are required. 
  • Field Reference must be filled with ADR/LQ (possibly followed by your own customer reference)
See the Returns product section for detailed information about returns forn destination the Netherlands.

Return labels Belgium
PostNL also offers the possibility to create return labels for Belgium. See paragraph Return labels Belgium.

The Afhaalservice Basis and Plus (Pickup Basic and Plus) allows you to instruct a PostNL Parcels driver to go to a specific address on a specific date to retrieve (a) parcel(s). A maximum of 5 parcels can be collected per pick up, pick up requests with more than 5 parcels will be denied. The parcel(s) will then be delivered to an (antwoordnummer)address specified by you. The driver will provide the shipment label, so there is no option to create one via the API. For these products, the Confirming WebService must be used. For an example of a Pickup basic shipment, please refer to the Confirming WebService documentation.

Product code

Description

3151*

Pickup Plus (collection order)

3160**

Pickup Basic (collection order)

3238

Pickup Plus (delivery order)

*If you use the Pickup Plus service you must use both product codes (3151 and 3238).     

**If you use the Pickup Basic service you must use both product codes (3160 and 3238).

Pickup products have a specific structure different from regular parcels or Cargo shipments. Pickup products consist of two Shipments, the collection order and the delivery order. Both orders must be placed in a separate Shipment in the request. This means that a request for a pickup product will contain two Shipment segments. Please refer to the Confirming API documentation for an example of a pickup plus order and a pickup basic order.

Business rules (Customer)
  • A customer with AddressType 02 is required.

Business rules (Shipment)
 
       •  A shipment with 
    o AddressType 04 (collection address)
    o 2S barcode
    o Product code 3151 (Plus) or 3160 (Basic).
    o CollectionTimeStampEnd
    o CollectionTimeStampBegin
 
       •  A shipment with 
    o AddressType 01 (receiver address). For Pickup Basic (3160) an Antwoordnummer address is required.
    o 3S barcode. The 3S barcode should be exactly the same as the 2S barcode; the number of characters. But with 3S instead of 2S.
    o Product code 3238.
    o Maximum 5 parcels per pick up
 
       •  A GroupType with 
    o 2S barcode of the first shipment
    o Count 
    o Sequence
 

Pickup Basic and Plus
Pickup plus products consist of two Shipments, the collection order and the delivery order. Both orders must be placed in a separate Shipment in the request. This means that a request for a pickup plus product will contain two Shipment segments. The below structure is required: 

Pickup plus Confirming structure

Pickup basic Confirming structure 

Customer

Customer

Message

Message

Shipments

Shipments

Shipment

  • AddressType 04
  • 2S barcode
  • CollectionTimeStampEnd
  • CollectionTimeStampBegin
  • ProductCode 3151

Shipment

  • AddressType 04
  • 2S barcode
  • CollectionTimeStampEnd
  • CollectionTimeStampBegin
  • ProductCode 3160

 Shipment

  • AddressType 01
  • 3S barcode the same as 2S (but with 3S)
  • Grouptype 01
  • Mainbarcode 2S of first shipment
  • GroupCount
  • GroupSequence
  • ProductCode 3238

 Shipment

  • AddressType 01
    • Antwoordnummer required
  • 3S barcode the same as 2S (but with 3S)
  • Grouptype 01
  • Mainbarcode 2S of first shipment
  • GroupCount
  • GroupSequence
  • ProductCode 3238

PostNL Pakketten will deliver parcels on working days between 5.00 – 10.00 pm. It is mandatory to use a frontend solution of PostNL to let your customers choose a evening for the delivery. This frontend solution (timeframe webservice) will return the correct information about the delivery, which you will have to use in the confirming and / or labelling service. For example: for evening delivery you will need product options. Please check the specific confirming and / of labelling documentation for more information.

You will need to provide us with the delivery date of the parcel. This delivery date will be checked in our database. We cannot provide evening delivery for all addresses in the Netherlands. Therefore it is important to check if the stated delivery date and postal code are known in our database.

For evening delivery, confirming is essential. Without a confirming on time, it is not possible to process these parcels. Therefore, we advise strongly to use the method ‘generate label’ in the labelling service. Furthermore, you will need to hand over the parcels one day before the delivery date. If you hand over the evening parcels too soon or too late, they will be delivered the next evening.

Product code *

Description

3085 **Standard shipment

3087 **

Extra cover

3089 **

Signature on delivery + Deliver to stated address only

3090 **

Delivery to neighbour + Return when not home

3094 **

Extra cover + Return when not home

3096 **

Signature on delivery + Deliver to stated address only + Return when not home

3189 **Signature on delivery

3385 **

Deliver to stated address only

3389 **Signature on delivery + Return when not home

3390 **

Deliver to stated address only + Return when not home

* These products can only be used after consulting your PostNL Pakketten account manager.
** It is mandatory to use a combination of product code and a product option. The PostNL frontend will return this product option.

Combine these product codes with the following product option:

  • product option: characteristic 118, option 006

Business rules

  • Delivery date is required:
    • Evening delivery must be allowed on the given delivery date
  • Receiver address fields required:
    • Company name or last name 
    • Street 
    • Home number 
    • Postcode 
    • City
  • Evening delivery must be allowed on the address specified
    • Receiver contact mobile or email is required

PostNL Pakketten will deliver parcels on sundays between 12:00 -18:00 pm. All postal codes (except P.O boxes) in the Netherlands are being served. Only the Wadden Islands are exclude from this service for the time being.

Product code *

Description

3087**

Extra cover

3089 **

Signature on delivery + Deliver to stated address only

3094 **

Extra cover + Return when not home

3096 **

Signature on delivery + Deliver to stated address only + Return when not home

3385 **

Deliver to stated address only

3390 **

Deliver to stated address only + Return when not home

* These products can only be used after consulting your PostNL Pakketten account manager
** It is mandatory to use a combination of product code and a product option.

Combine these product codes with the following product option: 

  • product option: characteristic 101, option 008

Business rules

  • Delivery date is required:&
    • Sunday delivery must be allowed on the given delivery date
  • Receiver address fields required
    • Company name or last name
    • Street
    • Home number
    • Postcode
    • City
  • Sunday delivery must be allowed on the address specified
PostNL Parcels offers the possibility to hand over parcels to PostNL on working days between 05.00 and 11.00 AM. These parcels will be delivered on the same evening (note: only working days Monday to Friday) between 5.30PM and 10.00 PM. It is mandatory to retrieve availability of a given address for Today delivery using a front-end solution (webservice). Please consult the documentation and business rules for more information.  
 
Confirming the Today delivery is essential. When using the PostNL Shipping or Labelling API to confirm shipments, a shipment is confirmed by default. In the situation that you override this setting with confirm=false in the URL (I.e. only requesting a label), confirming the shipment separately via the PostNL Confirming API is necessary. 
 
Without a confirmation before 10AM on day of handover to PostNL, it is not possible to process these parcels in time. 
 
Furthermore, parcels need to be handed over between 05.00 and 11.00 AM at the specified  location for Today. If Today parcels are handed over to the wrong location, they will be delivered the next day at the first available delivery moment.

Product code *

Description

3085 **Standard shipment

3087 **

Extra cover

3089 **

Signature on delivery + Deliver to stated address only

3090 **

Delivery to neighbour + Return when not home

3094 **

Extra cover + Return when not home

3096 **

Signature on delivery + Deliver to stated address only + Return when not home

3189 **Signature on delivery

3385 **

Deliver to stated address only

3389 **Signature on delivery + Return when not home

3390 **

Deliver to stated address only + Return when not home

* These products can only be used after consulting your PostNL Pakketten account manager
** It is mandatory to use a combination of product code and a product option ‘Today’. Using ‘Today’ in combination with other product codes is not possible.

Combine these product codes with the following product option:

  • product option: characteristic 118, option 044

Business rules

  • Availability of Today delivery on given address must be allowed and confirmed by using the DeliveryDate + Timeframe webservice OR Checkout webservice. 
  • Confirmation must be received by PostNL before 10.00AM on the day of handover to PostNL.
  • Confirmation for Today delivery must contain:  
    • Today product option code: characteristic 118, option 044
    • Delivery date
    • Receiver address fields: Company name or last name, Street name, House number, Postcode
    • Receiver contact mobile phone number or email addres

PostNL Parcels offers the possibility to deliver parcels on the same day if customers order before lunchtime*. This product is available on Monday till Friday and will be delivered in the evening between 6.00 – 10.00 pm. We cannot provide same day delivery for all addresses in the Netherlands, therefore it is important to check if the postal codes are known in our database and allow evening/ same day delivery. This can be done by using the Timeframe WebService.

*This is a indicative time; for the exact time please contact your PostNL Pakketten account manager.

Product code *

Description

3085 **Standard shipment

3087 **

Extra cover

3089 **

Signature on delivery + Deliver to stated address only

3090 **

Delivery to neighbour + Return when not home

3094 **

Extra cover + Return when not home

3096 **

Signature on delivery + Deliver to stated address only + Return when not home

3189 **Signature on delivery

3385 **

Deliver to stated address only

3389 **Signature on delivery + Return when not home

3390 **

Deliver to stated address only + Return when not home

* These products can only be used after consulting your PostNL Pakketten account manager
** It is mandatory to use a combination of product code and a product option.

Combine these product codes with the following product options (both product options are needed for this product):

  • product option: characteristic 118, option 015
  • product option: characteristic 118, option 006

Business rules

  • Delivery date is required:
    • Sameday delivery must be allowed on the given delivery date
  • Receiver address fields required:
    • Company name or last name
    • Street
    • Home number
    • Postcode
  • Receiver contact mobile phone number or email address
    • Sameday delivery must be allowed on the address specified (use the timeframe webservice)

If your customer needs the parcel the next day as soon as possible and/or guaranteed, then you can use the product guaranteed delivery. There are four options: (1) on working days before 09:00 2) on working days before 10:00 (3) on working days before 12:00 (4) and on working days before 17:00. If the service has not been carried out according to our promises, you can request a reimbursement of the surcharge. Ideal for recipients who need certainty on their shipment.

This service is available for the whole Netherlands, excluding the Wadden Islands. There is no guaranteed distribution on Saturday and Sunday. To be able to use guaranteed delivery, please contact your PostNL Pakketten account manager for more information.

Product code *

Description

3085 **

Standard shipment

3087 **

Extra cover

3089 **

Signature on delivery + Deliver to stated address only

3090 **

Delivery to neighbour + Return when not home

3094 **

Extra cover + Return when not home

3096 **

Signature on delivery + Deliver to stated address only + Return when not home

3189 **

Signature on delivery

3385 **

Deliver to stated address only

3389 **

Signature on delivery + Return when not home

3390 **

Deliver to stated address only + Return when not home

* These products can only be used after consulting your PostNL Pakketten account manager
** It is mandatory to use a combination of product code and a product option.

Combine these product codes with one of the following product options: 

  • product option: characteristic 118, option 017 (delivery before 09:00) 
  • product option: characteristic 118, option 007 (delivery before 10:00) 
  • product option: characteristic 118, option 008 (delivery before 12:00) 
  • product option: characteristic 118, option 012 (delivery before 17:00)

Business rules

  • Delivery date is required
    • Guaranteed delivery must be allowed on the given delivery date
  • Receiver address field required:
    • Street 
    • Home number 
    • Postcode 
    • City
  • Guaranteed delivery must be allowed on the address specified
  • Receiver contact mobile phone number or email address is required. 

Note: Due to the fact that in some cases another connection is required for this product. It is important to contact your PostNL accountmanager or partnermanager before implementing this product.

With the service ‘Instant/ On demand Bike Delivery’ you can book instant, within 2-hour delivery or 2 hour timeslots delivery to consumers in designated service areas within cities. The receiver can choose a timeframe of two hours themselves in the checkout of the webshop, when he/she wishes to receive the parcel, the first time slot starting at the first 15 minute interval available and ending 2 hours after the start of that timeframe (E.a. 13.15 - 13.30 - 13.45 - 14.00) During the delivery, the consumer will receive extra push notifications via e-mail with confirmation of order, confirmation of pick-up and confirmation of delivery. This way, the consumer is even better in control of receiving the parcel.

PostNL delivers the parcels from Monday to Friday in the chosen timeframe (two hours between 12:00-20:00 h).

This service is locally and only on request available in certain cities in the Netherlands (Amsterdam, Utrecht, Rotterdam, The Hague, Eindhoven). The zip codes are user specific and managed by the customer. Postal codes of every pick-up location have to be shared with PostNL and you will receive a service area specifically for each pick-up location. Every order must be checked in combination with the desired delivery area.

Before booking an order there must have been a confirmation at the pick-up location that the requested order is available on the location and that the location is going to be able to pick, package and label every order individually at a maximum of 15 minutes after the start of the requested pick-up slot.

When an address is not attainable in the chosen timeframe, for example in (traffic) situations and circumstances beyond the control of PostNL, PostNL cannot be held responsible failing in delivery within the chosen timeframe. The receiver of the parcel is responsible to choose a timeframe when its address is attainable.

This timeframe option can be combined with the following products:

Product code*

Description

3070**

Instant delivery

* These products can only be used after consulting your PostNL Pakketten account manager.
** It is mandatory to use a combination of product code and a product option. The PostNL frontend will return this product option.

Combine these products with on of the following product options:

  • product option: characteristic 118, option 032
  • product option: characteristic 152, option 025
Business rules
  • DeliveryTimeStampEnd and DeliveryTimeStampStart are required. This fields should contain the timeframe retrieved from the Timeframe webservice response.
  • Delivery date is required.
  • Sender address field is required:
    • Street
    • Home number
    • Postalcode
    • City
  • Receiver address field required:
    • Street
    • Home number
    • Postalcode
    • City
  • Max. dimensions is 60x60x40 cm
  • Max. amount of parcels in one shipment: 2
  • Max. total weight is 15KG
  • Receiver contact fields required
  • Email address is obligatory and mobile phone number is optional
Product code *Description

4960

Belgium Deliver to stated address only 

4961

Belgium Delivery to neighbour

4962

Belgium Signature on delivery + Deliver to stated address only 

4963

Belgium Signature on delivery 

4965

Belgium Extra cover (EUR 500) +  Deliver to stated address only

* Can only be used after consulting your PostNL Pakketten account manager.