PostNL is only available in the Netherlands and Belgium. For more information click here.

With the PostNL integration you give your customers extra shipping options. For example, you can specify the delivery date and time, or have the package delivered to the Post Office (PakjeGemak). You can also easily send parcels within and outside Europe.

The integration uses your customer's country entered during checkout and product weights to display the corresponding shipping services configured by you in the eCom back office. With a paid subscription to PostNL you can also print PostNL shipping labels from the order and send shipping details to your PostNL account.

Use this article to:

Start with Setting up PostNL
Learn more about each setting by reading the PostNL settings guide.

Setting up PostNL

To enable PostNL on your website, take the following steps:

1. Go to PostNL settings-

  1. In the eCom Back Office, click Settings.

  2. Click on Shipping Methods.

  3. Click on Configure PostNL.

2. Set the origin address

  1. Scroll to the ORIGIN ADDRESS section and enter your store's address.

3. Set price

  1. In the LOGIN INFORMATION section, click Activate this integration and make sure the switch is On.

  2. Scroll to the PRICE section and click Add prices.

  3. Select a shipping method from the drop-down menu.

  4. Click on Save.

  5. In the SHIPPING METHOD section, turn on the switch Enable this shipping method .

  6. Scroll to the CONFIGURATION section:

    1. For Free shipping above , enter the smallest amount customers must spend to receive free shipping. Leave this field blank to disable the feature.

    2. For Tax rate , select the tax rate of your shipping method.

  7. Scroll to the WEIGHTS section and click Add Weight.

  8. Enter the minimum weight, maximum weight and price in the pop-up.

  9. Click on Save.

  10. Scroll to the COUNTRIES section and click Change country selection. Select the countries for which this shipping method is available.

  11. Click on Save.

  12. Repeat steps 1-12 until you've created all the shipping methods your business needs.

4. Make PostNL rates visible at check-out

  1. To the right of Mode, set the mode to Live.

5. Enable PostNL shipping labels (optional)

  1. Fill in the form here (only in Dutch).

  2. Wait 3-10 working days to receive the login details from PostNL.

  3. Once you have received confirmation of your company account, you will receive your PostNL login details, including your:

    1. Customer Number - Six Digit Number

    2. Customer code - Four letter code

    3. Location Code - Six Digit Number

    4. PostNL API key - You can use this step-by-step plan (only in Dutch) .

  4. In the eCom Back Office, click Settings.

  5. Click on Shipping Methods.

  6. Click on Configure PostNL.

  7. In the LOGIN INFORMATION section, enter the login details you have obtained from PostNL in the respective fields.

  8. Click on Save. New orders with PostNL as the shipping method will receive a printable shipping label. For more information about printing shipping labels, click here.

6. Check PostNL settings

  1. Scroll to the next section and enable or disable the settings as required. For more information about the settings in each section, click one of the following:

    1. Shipping Methods

    2. Additional shipping options

    3. Settings

    4. Delivery time

PostNL settings guide

You can configure PostNL under Settings > Shipping methods > Configure PostNL . You will then be taken to a page where you can set the following options:

Login Information

Login information is not required to display the rates in your check-out. To print PostNL shipping labels, login information is required. See the step-by-step instructions here. for instructions on how to create shipping labels.

  • Enable this integration - activate PostNL by ticking the checkbox.

  • Mode - set to Test if you want to link the shop to a PostNL test account (staging). Set to Live if you want to link the shop to a PostNL live account.

  • Customer number - this is the unique number of your account. This is provided by PostNL.

  • Customer code - this is the unique number provided by PostNL.

  • Location Code - this is a number that represents your shipping location. This is provided by PostNL.

  • Mode - set to Test if you want to link the shop to a PostNL test account (staging). Set to Live if you want to link the shop to a PostNL live account.

  • API Key - enter your personal PostNL API key here, which you can find in the PostNL API manager portal. You can use this step-by-step plan to find your API key.

Shipping Methods

In addition to the standard home delivery method where you can deliver on a day and time of your choice, with PostNL Checkout, you can also offer additional shipping methods with the PostNL integration.

  • Same Day Delivery - Customers can opt for same day delivery if they order before 12 noon.

  • Cash on delivery - customers can pay packages at the door by means of cash on delivery.

  • Mailbox delivery (Letterbox package) - packages that fit through the letterbox.

  • Pick up at a parcel machine (PakjeGemak) - in addition to punctual home delivery, PostNL also has a national network of collection points. Your customers have the choice to pick up their order at one of the many Post Offices. Among others at Albert Heijn, Bruna, Jumbo and Primera.

  • Extra Early Pickup and Evening Delivery - With the Extra Early Pickup option, your customers can pick up their package themselves at 400 locations in the Netherlands. This is possible from Tuesday to Saturday from 8.30 am. With evening deliveries, parcels are delivered in the evening between 18.00 and 21.30.

  • Europe delivery (Eu-Pack) - send parcels to countries within the European Union, Click here for more information.

  • Worldwide delivery (Global-Pack) - send packages to countries outside the European Union. Click here for more information..

Shipping options

  • Insured shipping (Increased liability) - you can insure the package if you want to send valuable goods. Click here for more information.

  • Return in case of no answer - the package will be returned if there is no answer and can be given a new delivery address through MijnPakket.

  • Signature on receipt - the recipient of the package confirms receipt with a signature and his name in block letters. This gives you certainty that the package has also been delivered to the customer. Click here for more information..

  • Do not allow delivery to neighbors - the package will not be delivered to the neighbors if the addressee is not at home.

  • Notification - allow PostNL to send notifications about the shipment via SMS or e-mail.


  • Barcode type - the system generates this for you and is provided by PostNL.

  • GlobalPack barcode type - the type of barcodes the system will generate for you on a worldwide shipment (GlobalPack). This is provided by PostNL.

  • GlobalPack barcode range - a unique number that PostNL provides.

  • Let customers choose a delivery time - activate this option to let customers choose a date for delivery of the package.

  • Tax - the tax rate for all PostNL shipping method.

  • Allow Sunday Delivery - Allow customers to choose Sunday as the delivery day at checkout. Please contact your PostNL account manager.

  • Allow delivery on Monday - Let customers choose Monday as the delivery day. This does not affect evening deliveries. Contact your PostNL account manager

  • Order before this time to offer Monday delivery -Choose until what time customers can order to allow the following Monday as the delivery day.

Sender Address

Shipping days affect delivery times at check-out. You can indicate on which days you deliver packages to PostNL. You can also configure the time it takes to ship the order to determine the earliest delivery date.

Origin address

Use this section to define the return address as shown on the labels. This section is required for the shipping costs to appear at checkout. Click here for setup instructions.


Use this section to determine what your customers should pay for shipping. This section is required for the shipping costs to appear at checkout. For instructions on the settings, click here.

You can set the price per weight class per delivery option. For more information about classifying weights, see Shipping Methods.

  • Allow shipping method - activate this status if you want to use the shipping method.

  • Free shipping above - enter here from which order amount (in euros including VAT) your customers do not have to pay shipping costs. Do you always charge shipping costs? Then leave this field empty.

  • Tax - indicate here the VAT rate that you charge on the shipping costs. If you do not see any values โ€‹โ€‹in the drop-down menu, you must first create them via Settings > PAYMENT SETTINGS > Taxes in the left menu of the back office.

  • Weights - enter the minimum and maximum weight here, in grams per class and give this class a price.

  • Price - Enter the price for this shipping method, including tax.

  • Countries - Select the customers to whom these weight classes and prices apply. Pay attention! Do you want higher shipping costs to Germany than within the Netherlands, but then 2 price matrixes for the same shipping method (in this case 2x Service point)

  • Steps PostNL API migration.pdf
    1 MB Download

Did this answer your question?