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 interacts with the PostNL API to retrieve pickup locations within a specified geographic area. It is useful for scenarios where you need to find available parcel pickup points or lockers in a defined rectangular region, such as for e-commerce platforms offering customers options to select convenient pickup locations.

For example, an online store could use this node to display all nearby parcel lockers and retail points within a customer's delivery area, filtered by opening hours and delivery date availability.

Properties

Name	Meaning
Latitude North	The northernmost latitude coordinate of the search area (required).
Longitude West	The westernmost longitude coordinate of the search area (required).
Latitude South	The southernmost latitude coordinate of the search area (required).
Longitude East	The easternmost longitude coordinate of the search area (required).
Country Code	The country code to filter locations by; options are "NL" (Netherlands) or "BE" (Belgium) (required).
Delivery Date	The earliest delivery date for which pickup locations should be available, formatted as `dd-MM-yyyy`. This date cannot be in the past.
Opening Time	Filter locations by their opening time, formatted as `hh:mm:ss`. Locations closed at this time will be excluded.
Delivery Options	JSON array specifying types of pickup locations to include: "PG" for retail points and parcel lockers (default), "PA" for parcel lockers only, or "PG_EX" to exclude parcel lockers.

Output

The node outputs JSON data containing details about the pickup locations found within the specified area and filters. Each location typically includes information such as its address, type (retail point or parcel locker), opening hours, and availability based on the delivery date and time filters.

If the API supports binary data (e.g., images or documents related to locations), it would be included in the binary output, but this node primarily returns structured JSON data describing locations.

Dependencies

Requires an active connection to the PostNL API.
Needs an API authentication token or key configured in n8n credentials.
The base URL for the API environment must be set in the node's credential configuration.
The node uses the PostNL OpenAPI specification internally to build requests.

Troubleshooting

Invalid Date Error: If the Delivery Date is set in the past, the API will return an error. Ensure the date is today or later.
No Locations Found: Check that the coordinates define a valid area and that the Country Code matches the region of interest.
Authentication Errors: Verify that the API key or token is correctly configured and has sufficient permissions.
Time Format Issues: The Opening Time must be in hh:mm:ss format; otherwise, filtering may not work as expected.
Delivery Options Filtering: Using incorrect values in Delivery Options may result in empty responses; use only the documented options ("PG", "PA", "PG_EX").