PostNL

Interact with PostNL API

Actions17

Shipping Status Actions
Confirming Actions
- Confirm Shipment
Labelling Actions
- Generate Label
Shipment Actions
- Generate Label
Barcode Actions
- Generate Barcode
Checkout Actions
- Checkout
Deliverydate Actions
- Calculate Delivery Date
- Calculate Shipping Date
Locations Actions
Postalcode Check Actions
- Checkout Postalcode Check
Timeframes Actions
- Retrieve Delivery Timeframes

Overview

This node calculates the expected delivery date for a shipment using PostNL's delivery date calculation service. It is useful in logistics, e-commerce, and shipping workflows where you need to estimate when a parcel will be delivered based on shipping details and options.

Typical use cases include:

Determining the delivery date before dispatching a package.
Providing customers with an estimated delivery date.
Planning logistics and inventory management around expected delivery times.

For example, if you have a shipment prepared on a certain date with a known shipping duration and destination, this node can calculate the exact delivery date considering cut-off times and availability per weekday.

Properties

Name	Meaning
Shipping Date	Date/time when the shipment is prepared for sending. Format: `dd-MM-yyyy hh:mm:ss`. Example: "29-05-2022 14:00:00".
Shipping Duration	Number of days it takes for the shipment to be delivered to PostNL. `1` means same day delivery to PostNL, `2` means next day, etc.
Cut Off Time	Default daily cutoff time (e.g., "17:00:00") after which shipments are processed the next day.
Postal Code	Zipcode of the destination address. Example: "2132WT".
Country Code	ISO2 code of the destination country. Options: `NL`, `BE`.
Origin Country Code	ISO2 code of the origin country. Options: `NL`, `BE`.
City	City of the destination address. Example: "Hoofddorp".
Street	Street name of the destination address. Example: "Siriusdreef".
House Number	House number of the destination address. Example: 42.
House Nr Ext	House number extension of the delivery address. Example: "A".
Options	JSON array specifying delivery options to consider when calculating the expected delivery date.
Cut Off Time Monday	Overrides default cutoff time specifically for Mondays.
Available Monday	Boolean indicating if shipping to PostNL is available on Mondays.
Cut Off Time Tuesday	Overrides default cutoff time specifically for Tuesdays.
Available Tuesday	Boolean indicating if shipping to PostNL is available on Tuesdays.
Cut Off Time Wednesday	Overrides default cutoff time specifically for Wednesdays.
Available Wednesday	Boolean indicating if shipping to PostNL is available on Wednesdays.
Cut Off Time Thursday	Overrides default cutoff time specifically for Thursdays.
Available Thursday	Boolean indicating if shipping to PostNL is available on Thursdays.
Cut Off Time Friday	Overrides default cutoff time specifically for Fridays.
Available Friday	Boolean indicating if shipping to PostNL is available on Fridays.
Cut Off Time Saturday	Overrides default cutoff time specifically for Saturdays.
Available Saturday	Boolean indicating if shipping to PostNL is available on Saturdays.
Cut Off Time Sunday	Overrides default cutoff time specifically for Sundays.
Available Sunday	Boolean indicating if shipping to PostNL is available on Sundays.

Output

The node outputs JSON data containing the calculated delivery date and related information returned by the PostNL API. The exact structure depends on the API response but typically includes fields such as:

The expected delivery date.
Any relevant status or error messages.
Additional metadata about the shipment timing.

No binary data output is indicated.

Dependencies

Requires an API key credential for authenticating with the PostNL API.
The node uses the PostNL API endpoint configured via credentials/environment variables.
The node depends on the @devlikeapro/n8n-openapi-node package for OpenAPI integration.

Troubleshooting

Invalid Date Format: Ensure the Shipping Date follows the required format dd-MM-yyyy hh:mm:ss.
Missing Required Fields: All required properties like Shipping Date, Shipping Duration, Cut Off Time, Postal Code, Country Code, and Options must be provided.
API Authentication Errors: Verify that the API key credential is correctly set up and has necessary permissions.
Unavailable Shipping Days: If the specified day is marked unavailable (AvailableMonday etc.), the delivery date calculation might shift; check these flags carefully.
Incorrect Country Codes: Use only supported ISO2 codes (NL, BE) for origin and destination countries.
Network Issues: Ensure the n8n instance has internet access to reach the PostNL API endpoint.