Products
The PostNL Pakketten 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.
Dutch domestic products
Dutch domestic products
We distinguish three common products:
Product code | Description |
3085 | Standard 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 (non-combi) GlobalPack labels.
Instant/ On demand Bike Delivery
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
- 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
Extra cover
Product code | Description |
3087 | Extra Cover |
3094 | Extra cover + Return when not home |
Business rules
- Insurance amount (type 02) is required.
- Insurance amount entered cannot exceed the maximum allowed amount (€ 5000,-)
Signature on delivery
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 |
Pickup Points
Pick Up Points NL Pakketten offers a range of pick up point products. Your customers can choose a pick up point (in Dutch: Ophalen bij PostNL locatie).
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 confirming and / or labelling service. Please check the confirming and / or labelling documentation for more specific information.
*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 confirming and /or labelling service 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. Therefore, we advise strongly to use the method ‘generate label with confirming’ in the labelling service.
Standard Pick up Points
More than 2600 pick up points available in supermarkets, bookstores etc. Parcels are available from 3.00 pm.
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
Mailbox parcel (Brievenbuspakje)
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 | Brievenbuspakje +
|
Note: It is not possible to sent multiple shipments of this product (Multicollo) in one request to the labelling webservice.
Please use the latest version of the Labelling API because a required coding line is added to the Mailbox parcel label template.
ID check
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 |
3437 | Delivery to neighbour + Age Check |
3438 | Standard shipment + Age Check |
3443 | Extra Cover + Age Check |
3446 | Extra Cover + Retun when not home + Age Check |
3449 | Retun when not home + Age Check |
Combine these product codes with the following product option:
- product option: characteristic 002, option 014
Type | Description |
01 | Dutch residence document |
02 | Dutch ID |
03 | Dutch passport |
04 | Dutch driving license |
05 | European ID |
07 | Foreign 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 |
3571 | Ophalen bij PostNL locatie + Age Check |
3574 | Ophalen bij PostNL locatie + Age Check + Notification |
3581 | Ophalen bij PostNL locatie + Extra Cover + Age Check |
3584 | Ophalen bij PostNL locatie + Extra Cover + Age Check + Notification |
ID Check products must be used in combination with a specific product option:
- ID validation (based on ID-number) requires product option: characteristic 002, option 012
- Age validation requires product option: characteristic 002, option 014
- ID validation (based on date of birth) requires product option: characteristic 002, option 016
Registered letter labels
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, 1178, 1179, 1180)
These products can only be used after consulting your PostNL account manager.
Product code | Description |
1010, 1011 | Registered letter |
1020 | Registered parcels Losse Post |
1410 | Registered letters Partijen Post |
1420 | Registered parcels Partijen Post |
1175 | Letter + ID check |
1178 | Letter + ID validation (based on date of birth) |
1179 | Letter + age check |
1180 | Letter + ID validation (based on ID number) |
Next to this, you will have the option to print 18 smaller labels on 1 A4. To use this option, you need to use the printertype GraphicFile|PDF||Merge18. Please be aware that this printertype is only allowed with the product codes mentioned above.
Food
Note: Due to the fact that another connection is required for this product. It is important to contact your PostNL accountmanager or partnermanager before implementing this product.
PostNL participates in the online food market. Grocers have the possibility to send fresh products in special boxes. We distinguish two types: Cool products and DKW products (dry and groceries). This process is different than for regular parcels. The deliverer removes the products out of the boxes. The boxes will be taken back to the depots; the sender receives his own box back.
The sending is offered just one time to the stated address only and will return when not home.
These products can only be used after consulting your PostNL Pakketten account manager.
Product code | Description |
3083 | Food (dry and groceries) |
3084 | Food (cool products) |
* If the shipment is a multi-collo shipment and this contains at least one Cool product (3084), then for the other (DKW) Food product(s) (3083) you must use the product code for Cool products (3084).
Combine the product codes 3084 (NL) and 4984 (BE) with the following product options:
Service | Product option (Characteristic |options) |
Evening BE and NL (17:00-22:00) | 118;024 |
Sunday NL (17:00-20:00) | 118;035 |
Age validation | 002;019 |
Signature on delivery | 002;004 |
Dangerous goods
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)
Return label
PostNL offers the possibility of sending return labels along with parcels. We call this the ‘Label in the box return label’. The receivers can use this labels to return the shipments free of charge via a PostNL location. The return labels must always be addressed to a Business reply number (Antwoordnummer) and can only be used for Dutch Domestic products.
You can apply for an Antwoordnummer at PostNL for receiving prepaid parcel shipments at a PostNL Location.
The barcode of the return label is linked to the barcode of the outbound shipment label. These are the benefits:
- A receiver can use the return label to return a shipment via a PostNL location free of charge.
- Track & Trace your Antwoordnummer shipments.
- In the information, the return label is linked to the outbound shipment label, which provides more insight into your Antwoordnummer shipments.
- The consumer has a return label at his disposal and does not need to address the shipment himself, thus optimizing operational quality.
- The scans of the outbound and return flows are shown in the confirmations of PostNL Parcels.
At the Labelling webservice Documentation page you can find more information about the ‘label in the box return label’.
Single label variant
PostNL Parcels also offers the possibility of providing a single return label, which allows consumers to send parcels to your Business reply number (Antwoordnummer).
Product code** | Description |
- * | Label in the box |
2285 | Single label variant |
*No separate product code, created your return label at the same moment as you create the shipment label.
** These product codes can only be used after consulting your PostNL Pakketten account manager.
Return labels Belgium
PostNL also offers the possibility to create return labels for Belgium. See paragraph Return labels Belgium.
Smart Returns
- You share the barcode with the consumer, e.g. as part of your webshop checkout where a return parcel is announced
- The consumer shows the barcode at the PostNL location on his/her smartphone
- This barcode will be scanned and the return label will be printed
The Smart Returns service is available for the following product:
Product code* | Description |
2285** | Business reply number (Antwoordnummer) |
* This product 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 this product code with the following product option:
- Product option: characteristic 152, option 025
- Receiver contact fields required: Email address *
*To receive a digital confirmation of handing over the parcel to PostNL.
Recommendation
When creating the additional barcode: We strongly recommend you to create a Code 128 barcode instead of the default code 39 barcode. Please be aware: this only holds for the additional barcode that you can provide to the consumer for scanning via smartphone. The code 128 barcode provide the maximum reading rate for the scan devices at the PostNL locations.
- In your native Android or iOS app
- In a HTML (responsive) email which shows the barcode
- Via a link in an email to a (responsive) website where the barcode is showed
Pickup service
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.
- A customer with AddressType 02 is required.
Business rules (Shipment)
o Product code 3151 (Plus) or 3160 (Basic).
Evening delivery
PostNL Pakketten will deliver parcels on working days between 6.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 |
3083 ** | Food (dry and groceries) *** |
3084 ** | Food (cool products) *** |
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.
*** If the shipment is a multi-collo shipment and this contains at least one Cool product, then for all the other (DKW) Food products you must use the product code for Cool products.
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
Sunday delivery
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
Sameday delivery
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 |
3083 ** | Food (dry and groceries) *** |
3084 ** | Food (cool products) *** |
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.
*** If the shipment is a multi-collo shipment and this contains at least one Cool product, then for all the other (DKW) Food products you must use the product code for Cool products.
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)
Delivery on demand (My Time)
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 ‘Delivery on Demand’ you can give a firmer guarantee about the delivery of products. The receiver can choose a timeframe of two hours themselves in the checkout of the webshop, when he/she wishes to receive the parcel. On the delivery day, the consumer will receive an extra notification with a narrower timeframe of one hour within the chosen two-hour timeframe. This way, the consumer is even better in control of receiving the parcel.
It is mandatory to use a frontend solution of PostNL in your webshop checkout. This frontend solution (timeframe webservice) will return the correct information about the timeslots of the delivery, which you will have to use in the confirming and / or labelling service. Please check the specific confirming and / of labelling documentation for more information. We recommend to use the Deliverydate webservice to determine the available deliverydate for Delivery on Demand products. This service takes into account weekends, holidays and non delivery days.
PostNL delivers the parcels from Monday to Friday in the chosen timeframe (two hours between 08:00-12:00 and 15:00-20:00 h) and on Saturday (two hours between 09:00-12:00). Parcels for ‘Delivery on Demand’ should be presented on the working day before the chosen delivery date. Parcels for a timeframe on Monday should therefore be presented on Friday. Parcels can be presented together with regular parcels.
This service is nation wide available in the Netherlands, with the exception of the Wadden Islands and PO boxes. Timeframes after 18:00 h use the zip code ranges of Evening delivery. These zip codes are managed by PostNL. Therefore, to use the Delivery on Demand product, there has to be a link with the Timeframe API. You can choose for interval timeframes of 30 and 60 minutes. We recommend to use the interval of 60, so you can show full two-hour timeframes.
When an address is not attainable in the chosen timeframe, for example in (traffic) situations and circumstances beyond the control of PostNL, PostNL can not 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 |
3083 ** | Food (dry and groceries) *** |
3084 ** | Food (cool products) *** |
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.
*** If the shipment is a multi-collo shipment and this contains at least one Cool product, then for all the other (DKW) Food products you must use the product code for Cool products.
Combine these product codes with one of the following product option:
- product option: characteristic 118, option 014
Business rules
-DeliveryTimeStampEnd and DeliveryTimeStampStart are required.
This fields should contain the timeframe retrieved from the Timeframe webservice response.
-Deliverydate is required.
- Receiver address field required:
Street
Home number
Postcode
City
- Receiver contact fields required
Email address or mobile phone number
Guaranteed/ Morning delivery
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 |
3083 ** | Food (dry and groceries) *** |
3084 ** | Food (cool products) *** |
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.
*** If the shipment is a multi-collo shipment and this contains at least one Cool product, then for all the other (DKW) Food products you must use the product code for Cool products.
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
Destination Belgium
Belgium domestic
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.
Pickup at PostNL Location Belgium
Product code * | Description | ||
4878 | Pickup at PostNL Location Belgium insured. | ||
4880 | Pickup at PostNL Location Belgium, no insurance. |
* Can only be used after consulting your PostNL Pakketten account manager.
It is possible to let your customers choose pick up points in Belgium. It is mandatory to use a frontend solution to let your customer choose a pick up point. See for more information the paragraph Pickup Points (Dutch domestic products).
Business rules
- Downnetwork partner ID is required
- Downnetwork pickup location code is required
- Address type 09 is required (partner pickup location), please refer to the LocationWebService to retrieve the correct pickup location addresses
Netherlands to Belgium
Parcels EU with destination Belgium
All products include standard coverage of € 500,- and a signature upon delivery.
Please be aware that Parcels EU with destination Belgium can be used until 31-12-2021. You can use the products from Parcels Netherlands-Belgium in order to send your parcels to Belgium.
Product code* | Description | |||
4932 | Pick up at a PostNL location in Belgium including insurance ** | |||
4938 | Deliver to stated address only + Signature on delivery | |||
4940 | Parcels EU to Business (Delivery to neighbour + Signature on delivery + Standard Cover) | |||
4944 | Parcels EU to Consumer (Delivery to neighbour + Signature on delivery + Standard Cover) | |||
4983 | Belgium Signature on delivery + Deliver to stated address only + Return when not home (Monday to Saturday) |
** It is possible to let your customers choose pick up points in Belgium. It is mandatory to use a frontend solution to let your customer choose a pick up point. See for more information the paragraph Pickup Points (Dutch domestic products).
Parcels Netherlands-Belgium
Standard delivery to Belgium.
Please be aware: these products need to be added to your contract before using them. Contact your PostNL Pakketten accountmanager in order to check if additional action is needed.
Product code* | Description |
4936 | Pick up at a PostNL location in Belgium ** |
4941 | Deliver to stated address only |
4946 | Belgium Standard delivery |
* Can only be used after consulting your PostNL Pakketten account manager.
** It is possible to let your customers choose pick up points in Belgium. It is mandatory to use a frontend solution to let your customer choose a pick up point. See for more information the paragraph Pickup Points (Dutch domestic products).
Return label
PostNL offers the possibility to create returns labels for Belgium.
You can request return labels in the same two ways for Dutch domestic return shipments (Label in the box and a single label). You can request a return label directly, or you can request a return label with your regular shipping label (label in the box). Both examples are shown below.
Please note: It is only possible to generate return labels for Belgium if you make use of the api's from the new API platform. Please refer to the Call details paragraphs of the Documentation pages.
Single label variant
The return labels for Belgium require some specific fields to be used:
- address of receiver: Shipment/Address/AddressType 01
- address of sender: Customer/Address/AddressType 02
- Countrycode: BE
- Product code: dependent on the origin country. If your company is located in the Netherlands, you must use product code 3250. If your company is located in Belgium you must use product code 4882.
Label in the box
For the label in the box variant, you adjust your regular shipping label api call with some extra parameters. This results in an output of two labels, one initial shipping label and one return label.Label in the box return labels require some specific fields to be used:
- address of receiver: Shipment/Address/AddressType 01
- address of sender: Customer/Address/AddressType 02
- return address: Shipment/Address/AddressType 08
- product code: regular product codes
- return barcode: Shipment/ReturnBarcode
For an example of a Label in the box shipment, please refer to the Request examples of Labelling webservice documentation.
Return Label
For the return process in Belgium, a printed label on the box is required. Labels can not be printed within the PostNL pick-up points.
Product code | Description |
- * | Label in the box |
3250 ** | Single label variant (when your company is located in the Netherlands) |
4882 ** | Single label variant (when your company is located in Belgium) |
*No separate product code, created your return label at the same moment as you create the shipment label.
** These product codes can only be used after consulting your PostNL Pakketten account manager.
Business rules
Address type 1 Contact fields required: Email address *
*To receive a digital confirmation of handing over the parcel to PostNL.
Destination EU
Parcels EU
Product code | Combilabel * | Description |
4940 | 4950 | Parcels EU to Business (Delivery to neighbour + Signature on delivery + Standard Cover **) |
4944 | 4952 | Parcels EU to Consumer (Delivery to neighbour + Signature on delivery + Standard Cover **) |
n/a | 4999 | Parcels EU Standard *** |
* Please contact your PostNL Pakketten accountmanager if you want to use combi-label to FR or GB.
**Standard Cover amount of €500.
*** These product codes can only be used after consulting your PostNL Pakketten account manager. Only available for France.
The barcode type for the above barcodes is 3S and the barcode length contains 13 characters.
Country codes
Destination | Country code ISO2 | Destination | Country code ISO2 | |
Austria | AT | Italy (3) | IT | |
Belgium | BE | Latvia | LV | |
Bulgaria | BG | Lithuania | LT | |
Croatia | HR | Luxembourg | LU | |
Cyprus | CY >>> | Czech Republic | CZ | |
Denmark (1) | DK | Netherlands | NL | |
Estonia | EE | Poland | PL | |
Finland | FI | Portugal (4) | PT | |
France (2) | FR | Romania | RO | |
Germany | DE | Slovakia | SK | |
Slovenia | SI | |||
Greece | GR | Spain (5) | ES | |
Hungary | HU | Sweden | SE | |
Ireland | IE |
- Excluding Faroe Islands and Greenland
- Including Monaco and Corsica. Excluding Andorra
- Excluding San Marino and Vatican City
- Including Azores and Madeira
- Including Balearic Islands. Excluding Canary Islands, Melilla and Ceuta
To recognize the Canary Islands (5):
Las Palmas has country code IC and zip codes start with 35. Santa Cruz has country code IC and zip codes start with 38. Melilla has country code IC and zip code starts with 52.
Parcels to the Channel Islands, the Canary Islands can only be sent with the Global Pack product: Ask your account manager about the available options.
As of May 18th Malta (MT) is a Parcel EU country as well.
Business rules
- Barcode requirements
- Type must be 3S
- Range must be 1-4 letter string
- Serie must be 7-12 digits
- Barcode must be 13 characters long
- Receiver country must be an Parcels EU country
- Receiver address fields required&
- Company name or last name
- City
- Country code
- Door code is not allowed for countries other than FR, IE and SE
Easy Return Service (ERS)
With this product you give your customers abroad the opportunity to return a shipment free of charge. This can be done through a local post office in 23 European countries. Parcels are then fully traceable.
Check the PostNL site for more information and the countries where this service can be used.
Productcode* | Description |
4910 | Europe Returns |
*You have to use the Shipping API v1 for this product.
Destination Rest Of World
GlobalPack products
Product code * | Combilabel | Description | |||
4945** | 4947** | GlobalPack |
*For GlobalPack it is recommended to use the combilabel product code to ensure a faster process. These labels contain a 3S barcode (also used for domestic shipments) and a partner barcode (S10 barcode) that is accepted in the country of destination.The combilabels can be printed when this is accessed by PostNL. Standard a normal GlobalPack label is printed with just one barcode. The labels are printed on A5 paper (two or three forms, depending on the type of goods shipped), just like he standard GlobalPack labels. If the combilabel creation fails for some reason, automatically a standard GlobalPack label is created.
Track and trace and billing for this shipments are based on the 3S barcode.
** These product codes can only be used after consulting your PostNL Pakketten account manager.
Country codes
GlobalPack covers all countries except for the countries as mentioned in previous and Dutch/Belgium domestic sections. Please be aware of the specific exceptions as mentioned in the Parcels EU section.
GlobalPack Combilabel is only available in the following countries:
Destination | Country code ISO2 | Destination | Country code ISO2 | |
China | CN | Israel | IS | |
Brasil | BR | New Zealand | NZ | |
Canada | CA | Russia | RU | |
Hong Kong | HK |
Barcode type
Product code | Barcode type | Barcode length | In field |
4945 | S10 | 13 | Shipment / Barcode |
4947* | 3S | 13 | Shipment / Barcode |
S10 | 13 | Shipment / DownPartnerBarcode |
*If you use combilabels and you send to one of the eight countries (see table above), you must use product code 4947.
GlobalPack barcodes can only be generated via the API, using the Barcode method. Details are mentioned in the Barcode Webservice documentation.
Business rules
- Receiver address fields require
- Company name or last name
- City
- Country code
- GlobalPack product code
- Barcode type must be S10
- Either receiver or sender country code must not be an Parcels EU country
- Customs segment
- For shipments to the USA the contact segment must contain either a phone number or an e-mail address.
- At least one Content segment
- Shipment type (the following types are possible: Gift, Documents, Commercial Sample, Commercial Goods, Returned Goods)
- You must select whether the shipment should be handled as non-deliverable (please refer to the example in the Labelling specifications)
- Currency
- Certificate, License or Invoice (with number). At least one of these fields is required; not in the case of ShipmentType = Gift or Documents.
- GlobalPack combilabel product code
- Downnetwork partner barcode field is required (barcode type S10)
Direct Parcel to China
Product code | Description |
4992 | Direct Parcel to China |
Business rules
- Barcode requirements
- Type must be 3S
- Receiver country must be China
- Receiver address fields required
- Company name or last name
- City
- Region
- Country code
- SMSNr is required. Max. 11 characters, start with '1'.
- Receiver address must contain Chinese characters (al least the fields street, city and region).
- EAN field is required together with HS number.
- ProductURL field is required.
- CustomerOrderNumber is required.
- IDNumber is required in combination with IDType 07.
International Mail & Packets
International Mail & Packets
Service | Productcode | Productname | Required Barcodetype |
Untracked | 6905* | Priority Packet Bulk | UE |
Untracked | 6440 | Priority Letterbox Packet | UE |
Untracked | 6405 | Priority Packet | UE |
Untracked | 6945* | Priority Packet Bulk Boxable | UE |
Tracked | 6350 | Priority Packet Tracked | LA |
Tracked | 6550* | Priority Packet Tracked Bulk | LA |
Tracked | 6942* | Priority Packet Tracked Bulk Boxable | LA |
Registered | 6906 | Priority Packet Extra | RI |
Registered | 6408 | Registered Letter | RI |
Registered | 6605* | Registered Bulk Mail | RI |
Registered | 6908* | Priority Packet Extra Bulk | RI |
Registered | 6040* | Registered Book | RI |
Registered | 6027* | Registered BVO | RI |
* These product codes can only be used after consulting your PostNL International account manager.
The product codes above are the standard PostNL products. It is possible that you received other product codes for tailored solutions.
Note: You have to use the latest version of the Labelling API (2.2).
Cargo products
Cargo products
Cargo products allow you to send pallet shipments to several European countries. PostNL Pakketten offers the following Cargo services:
- Benelux Freight: pallets with destination Belgium, The Netherlands and Luxembourg
- Euro Freight: pallets with destination Europe, except Belgium, The Netherlands and Luxembourg.
- Guaranteed delivery (only domestic shipments)
- Cargo pickup
- Half Europallets
- Roll cage containers
- ADR-shipments
The following conditions applies:
- Pallets can only be sent to B2B addresses, not to Post office boxes or consumers.
Product code * | Description |
3606 | AVG Pallet Pharma&Care 2-8 C |
3607 | AVG Pallet Pharma&Care 15-25 C |
3608 | AVG Cargo Parcel Pharma&Care 2-8 C |
3609 | AVG Cargo Parcel Pharma&Care 15-25 C |
3610 | AVG Pallet NL |
3611 | AVG Pallet NL + COD |
3613 | AVG Pallet NL + ADR |
3616 | AVG Pallet NL + ADR + COD |
3617 | AVG Pallet BE + ADR + COD |
3618 | AVG Pallet BE |
3619 | AVG Pallet BE + COD |
3621 | AVG Pallet BE + ADR |
3622 | AVG Pallet LU |
3623 | AVG Pallet LU + COD |
3625 | AVG Pallet LU + ADR |
3626 | AVG Euro Freight Pallet |
3627 | AVG Euro Freight Parcel Plus |
3630 | AVG Parcel Plus NL |
3631 | AVG Parcel Plus NL + COD |
3633 | AVG Parcel Plus NL + ADR |
3638 | AVG Parcel Plus BE |
3639 | AVG Parcel Plus BE + COD |
3641 | AVG Parcel Plus NL + ADR |
3642 | AVG Parcel Plus LU |
3643 | AVG Parcel Plus LU + COD |
3645 | AVG Parcel Plus LU + ADR |
3657 | AVG Half Europallet NL |
3658 | AVG Half Europallet BE |
3659 | AVG Half Europallet LU |
3677 | AVG Half Europallet NL + COD |
3678 | AVG Half Europallet BE + COD |
3679 | AVG Half Europallet LU + COD |
3696 | AVG Roll Cage container NL |
3697 | AVG Roll Cage container Full BE |
3698 | AVG Roll Cage container Empty NL |
3699 | AVG Roll Cage container Empty BE |
* These products can only be used after consulting your PostNL Pakketten account manager.
** For ADR shipments, see the ADR documentation below.
Country codes Eurofreight
Destination | Country code ISO2 | Destination | Country code ISO2 |
|
Andorra | AD | Austria | AT |
|
Bosnia-Herzegovina | BA | Bulgaria | BG |
|
Switzerland | CH | Czech Republic | CZ |
|
Germany | DE | Denmark | DK |
|
Estonia | EE | Spain | ES |
|
Finland | FI | France | FR |
|
Croatia | HR | Hungary | HU |
|
Italy | IT | Liechtenstein | LI |
|
Lithuania | LT | Luxembourg | LU |
|
Latvia | LV | Monaco | MC |
|
Montenegro | ME | Norway | NO |
|
Poland | PL | Portugal | PT |
|
Romania | RO | Serbia | RS |
|
Sweden | SE | Slovenia | SI | |
Slovakia | SK | San Marino | SM |
|
Vatican City | VA |
|
|
|
Barcode type
Cargo barcodes can be generated via the PostNL API, using the Barcode method. Details are mentioned in the Barcode method documentation. The barcode type is 3S and the barcode length is 15.
Multiple or different items in one shipment
When having a shipment with different load carriers for the same receiver address.(Pallets in combination with a Roll Cage Container in one shipment for example), use the ‘content’ field (in Shipments -> Shipment, String [0-35]) to let us know which load carrier the item will be on. Remark: This is not a necessary field for shipping a standard pallet or parcel plus. Always consult your account manager before implementing the load carriers. The following carriers can be used for with the different product codes:
Load Carrier | Productcode | Description | Country | Special |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3606 | AVG Pallet Pharma&Care 2-8 C | BENELUX | Pharma&Care |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3607 | AVG Pallet Pharma&Care 15-25 C | BENELUX | Pharma&Care |
C, C+, ZAK | 3608 | AVG Cargo Parcel Pharma&Care 2-8 C | BENELUX | Pharma&Care |
C, C+, ZAK | 3609 | AVG Cargo Parcel Pharma&Care 15-25 C | BENELUX | Pharma&Care |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3610 | AVG Pallet NL | NL |
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3611 | AVG Pallet NL + COD | NL | COD (Rembours) |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3613 | AVG Pallet NL + ADR | NL | ADR |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3616 | AVG Pallet NL + ADR + COD | NL | ADR + COD |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3617 | AVG Pallet BE + ADR + COD | BE | ADR + COD
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3618 | AVG Pallet BE | BE |
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3619 | AVG Pallet BE + COD | BE | COD
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3621 | AVG Pallet BE + ADR | BE | ADR |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3622 | AVG Pallet LU | LUX |
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3623 | AVG Pallet LU + COD | LUX | COD
|
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3625 | AVG Pallet LU + ADR | LUX | ADR |
BLK, EUR, EWP, KTF, P, P+, P1X, P2X, P3X | 3626 | AVG Euro Freight Pallet | INT (NOT BENELUX) | All combinations |
C, C+, ZAK | 3627 | AVG Euro Freight Parcel Plus | INT (NOT BENELUX) | All combinations
|
C, C+, ZAK | 3630 | AVG Parcel Plus NL | NL |
|
C, C+, ZAK
| 3631 | AVG Parcel Plus NL + COD | NL | COD |
C, C+, ZAK
| 3633 | AVG Parcel Plus NL + ADR | NL | ADR |
C, C+, ZAK
| 3638 | AVG Parcel Plus BE | BE |
|
C, C+, ZAK
| 3639 | AVG Parcel Plus BE + COD | BE | COD |
C, C+, ZAK
| 3641 | AVG Parcel Plus BE + ADR | BE | ADR |
C, C+, ZAK
| 3642 | AVG Parcel Plus LU | LUX |
|
C, C+, ZAK
| 3643 | AVG Parcel Plus LU + COD | LUX | COD |
C, C+, ZAK
| 3645 | AVG Parcel Plus LU + ADR | LUX | ADR |
HEP, MP | 3657 | AVG Half Europallet NL | NL |
|
HEP, MP | 3658 | AVG Half Europallet BE | BE |
|
HEP, MP | 3659 | AVG Half Europallet LU | LUX |
|
HEP, MP | 3677 | AVG Half Europallet NL +COD | NL | COD |
HEP, MP | 3678 | AVG Half Europallet BE +COD | BE | COD |
HEP, MP | 3679 | AVG Half Europallet LU +COD | LUX | COD |
RC | 3696 | AVG Roll Cage container Full NL | NL |
|
RC | 3697 | AVG Roll Cage container Full BE | BE |
|
RCL | 3698 | AVG Roll Cage container Empty NL | NL |
|
RCL | 3699 | AVG Roll Cage container Empty BE | BE |
|
Remarks for the truck driver
Do you have a specific remark for the truck driver, for example ‘Please ring at the blue gate’, use the ‘Remark’ field (in Shipments -> Shipment, String [0-255]).
Guaranteed delivery Cargo
Combine one of the above product codes with one of the following product options:
- 118;007 for delivery before 10 am
- 118;008 for delivery before 12 am
- 118;013 for delivery before 14 pm
Cargo Pickup
Product code * | Description |
3606 ** | AVG Pallet Pharma&Care 2-8 C |
3607 ** | AVG Pallet Pharma&Care 15-25 C |
3608 ** | AVG Cargo Parcel Pharma&Care 2-8 C |
3609 ** | AVG Cargo Parcel Pharma&Care 15-25 C |
3610 ** | AVG Pallet NL |
3630 ** | AVG Parcel Plus NL |
3657 ** | AVG Half Europallet NL |
3696 ** | AVG Roll Cage container NL |
3696** | AVG Roll Cage container NL |
3618** | AVG Pallet BE |
3638** | AVG Cargo Parcels BE |
3658** | AVG Half Europallet BE |
3697** | AVG Roll Cage container BE |
3622** | AVG Pallet LU |
3642** | AVG Cargo Parcels LU |
3659** | AVG Half Europallet LU |
* 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 135, option 001
These product codes must be combined with a pickup address (type 04)
Business rules
- Customer number is required.
Extra @ home products
Extra @ Home
PostNL Extra@Home has introduced a unique service whereby large and heavy goods, also named XL goods, will be delivered and installed. These XL goods are furniture, televisions, refrigerators and washing machines.
Before the delivery takes place, customers will receive a text message or e-mail informing them of the delivery window (timeframe). On the day of delivery, the customers will receive a second notification with the exact time of delivery. Extra@Home knows 2 kinds of delivery: by one-man or two-men transport, depending on the dimensions of the order.
Specifications of the dimension criteria of Extra@Home products can be requested at eh-logistiek@postnl.nl. Products should only be addressed to private home addresses, so not to P.O boxes or pickup points.
Delivery will be on weekdays (Monday till Friday) between 08:00 and 21:00 and optional on Saturday (with a surcharge).
Product code* | Description | Available destinations |
3628 | Extra@Home Top service 2 person delivery NL | NL |
3629 | Extra@Home Top service Btl 2 person delivery | BE;LU |
3653 | Extra@Home Top service 1 person delivery NL | NL |
3783 | Extra@Home Top service Btl 1 person delivery | BE;LU |
3790 | Extra@Home Drempelservice 1 person delivery NL | NL |
3791 | Extra@Home Drempelservice 2 person delivery NL | NL |
3792 | Extra@Home Drempelservice Btl 1 person delivery | BE; LU |
3793 | Extra@Home Drempelservice Btl 2 persons delivery | BE; LU |
NL: Netherlands, BE: Belgium, LU: Luxembourg
* These articles can only be used after consulting your PostNL Pakketten accountmanager.
Please always choose directly the correct product code for the order to prevent delivery problems.
Combine these product codes with the following product option if you want to send with COD:
- product option: chararteristic 003 option 003
Business rules
- Shipment.Content is required
- Shipment.Reference is required (this should be unique for each shipment as this will be used to generate the Extra@Home order reference)
- Volume is required (approximation suffices)
- Weight is required (approximation suffices)
- Mobile phone number required for text messages with ETA;
- E-mail adress required for link Customer Portal incl. Track &Trace.
Extra @ Home Pickup service
The pickup service allows you to instruct a PostNL Parcels driver to go to a specific address on a specific date to retrieve (a) parcel(s). The parcel(s) will then be delivered to an 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 Extra @ Home Pickup shipment, please refer to the Confirming WebService documentation.
Product code* | Description |
3794 | Extra @ Home Doorstep Service 1 man Pick Up |
3795 | Extra @ Home Doorstep Service 2 men Pick Up |
3781 | Extra @ Home Topservice 1 man Pick Up |
3780 | Extra @ Home Topservice 2 men Pick Up |
3796 | Extra @ Home Doorstep Service 1 man foreign Pick Up |
3797 | Extra @ Home Doorstep Service 2 men foreign Pick Up |
3784 | Extra @ Home Topservice 1 man foreign Pick Up |
3782 | Extra @ Home Topservice 2 men foreign Pick Up |
* These articles can only be used after consulting your PostNL Pakketten accountmanager.
Address type for pick-up
PostNL internal applications validate the receiver address. In case the spelling of addresses should be different according to our PostNL information, the address details will be corrected. This can be noticed in Track & Trace. Please note that the webservice will not add address details. Street and City fields will only be printed when they are in the call towards the labeling webservice.
The element Address type is a code in the request. Possible values for pickup orders:
Code | Description |
---|---|
02 | Sender |
03 | Alternative sender address |
04 | Collection address |