[28-02-2024] Upgrade generation of shipping labels
Per 19 march, the application for the generation of shipping labels will be upgraded. As a result, Printertype-responses in the categy Zebra|Generic ZPL II have adjustments in the buildup of the ZPL-code. Users of this printer type output are advised to evaluate the ZPL-output on compatibility with application(s) and/or hardware.
Adjustments to the ZPL output are as follows:
- The resolution command (^JM) is now set within a label format (^XA, ^XZ block)
- The documentation command (^FX) containing the form name is no longer generated.
- The ZPL header value in the default configuration file was changed to an empty value instead of "^MMT". If the original value (^MMT) is used, it is replaced by "^XA^MMT^XZ" to match the ZPL reference.
- Some ZPL commands like (^LS, ^LT etc.) are now generated only once before the first label and no longer on every label.
The new Zebra|Generic output-types are retrievable via the sandbox-environment of either Labelling- or Shipment-API.
[09-01-2024] Update API-management portal
Per January 10th, the API-management portal has been deactivated and can no longer be used for retrieving your API-credentials. Please contact Chanel integrations via the support form and provide your customer number and username of the API-management portal for assistance.
If you use the API key for Data Solutions and you are unable to locate your API key in the module 'Manage API keys', please reach out to our support team at datasolutions@postnl.nl.
[26-10-2023] Update Woocommerce PostNL plugin
It's time to take action if you are still using a version lower than 5.0.0 of the PostNL plugin for WooCommerce. The outdated versions will be disabled starting from November 1, 2023. How do I install the latest version?
First, close your existing orders. Please close all existing orders before installing the new plugin. If this step is omitted, shipping labels for these orders will not be generated. If you forget to do this, you can manually create the shipping labels later through your My PostNL environment.
The installation steps for the latest version can be found in the guide. Make sure to have your PostNL customer number and API details ready beforehand. Please note that the API details are different from what you are currently using. You can find these in your My PostNL environment under "My Account > Manage API."
Need assistance? Feel free to ask your question via the support form
You will receive a response within two business days.
[14-07-2023] New product portfolio for sending from Belgium to the Netherlands
On 01-01-2024 PostNL will launch a new product portfolio for sending from Belgium to the Netherlands. For customers this implies some technical changes in confirming shipments. 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 use
For more information, please visit this page where you will find all technical instructions for each of our IT connections.
[11-04-2023] Technical documentation portal
PostNL has introduced a new portal for technical API documentation. This new website is based on the OpenAPI specification of our collection of API's for e-commerce processes. Via https://docs.api.postnl.nl you can find an easy-to-navigate documentation portal extended with up-to-date API specifications, references and code samples.
From now on PostNl offers a three-panel, responsive layout for the technical documentation:
• The left panel contains a search bar and navigation menu.
• The central panel contains the documentation.
• The right panel contains request and response examples.
The current Developer Portal will still be the entry point for information about the APIs for commercial information. Commercial information such as explanation of API usage and Use cases are still listed here. On the updated documentation pages, developers are now redirected to the technical documentation.
[13-02-2023] Renewed International product portfolio available
The renewed international product portfolio is available per the 1st January 2023. This makes 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.
New product codes have been added and the ‘old’ product codes can still be used until further notice. The renewed International product portfolio has been added to the responses of the most recent versions of the Shipping and Labelling API. Please note preferable method is via REST (JSON).
Take a look at the Productinformation | Parcel EU, Parcel Non EU and International Mail & Packets of the API’s for more information. Example requests are also available in the postman collection.More information about the portfolio can be found on our website
[20-09-2022] Sustainable delivery options
[18-08-2022] Labelling 2.1 improvements
[10-06-2022] – Truncate search queries to the Shippingstatus API
[30-05-2022] Removed Food products
PostNL stops its food network. The market has developed differently than expected, so PostNL is closing the network.
The productcodes are no longer displayed at the Products page.
[04-04-2022] Phase out 4947 Parcel Non EU – combilabel
As of April 1st 2022 the International product ‘Parcels Non EU – combilabel’ productcode 4947 should no longer be used. Shipments to destinations outside the EU can be send via the product ‘Parcels non EU – Single label’ productcode 4945.
Benefits of the ‘Parcels non EU – single label’ product are that it contains a single Internationally recognized S10 barcode. Instead of an S10 barcode and a domestic 3S barcode. This makes the API request easier because only the S10 barcode is sufficient for requesting tracking, labels and the use of shippingstatus webservice. A single barcode on an item improves quality and the tracking of International shipments.
For more information contact your Account Manager.
[27-11-2020] Renewed product portfolio for parcels shipping to Belgium
[19-10-2020] Brexit - PostNL changes
[25-04-2020] Shipments to Croatia, Cyprus of Malta (HR, CY of MT)
As of May 18th, Croatia, Cyprus and Malta will be covered by product 4944 (Parcels EU – formerly known as EPS), instead of 4945 (Parcels non-EU – formerly known as Globalpack). Label requests via API for these countries dated May 18th and later will result in an error.
[22-04-2020] Extra sorting indication Mailbox parcels
A letter from the receiving sorting center will be printed on the label of Mailbox parcels (Brievenbuspakjes). In this way, customers and PostNL employees within the operation can more quickly see to which sorting center the package should be sent.
The letter appears on the label of you use the Labelling 2.2 or Shipping v1 API. If you are not yet using one of this webservices, the advise is to update/upgrade as soon as possible.
Letter A Amsterdam
Letter R Rotterdam
Letter H 's Hertogen Bosch
Letter N Nieuwegein
Letter Z Zwolle
[15-01-2020] Validation changes Labelling v2.2 and Confirming API v2
-An validation has been added on the Shipment.Customs.Content.Content.Weight attribute. According to the documentation this already had to be an integer; this is now being enforced.
-For International shipments (EU and Rest of Word), a validation for a maximum weight in the Shipment.Dimension.Weight attirbute has been added. This is now at 999 kg for now. This can be adjusted in the future to guarantee that we can process the shipments.
[21-11-2019] Cash on Delivery (COD)
It will soon no longer be possible to use the Cash on Delivery product codes. PostNL has decided to stop the cash on delivery service (rembours) in the Netherlands and Belgium from January 1, 2020.
The following product codes have been removed from the Product documentation page:
3086 COD
3091 COD + Extra cover
3093 COD + Return when not home
3097 COD + Extra cover + Return when not home
Belgium productcodes
4964 Belgium COD + Return when not home
4966 Belgium COD + Extra cover + Return when not home
[18-11-2019] PostNL Belgium retailnetwork
[27-08-2019] Technical newsletter
PostNL is sending technical information nowadays. With this bi monthly newsletter PostNL inform tech savvy customers through API updates, integrated services, Tips & Tricks, new functions, plugins and partner channels. Also useful information about new functionalities in MyPostnl and the Developer Center can be read in this newsletters.
You can subscribe here for this newsletter.
Archive newsletter:
June 2019
Augustus 2019