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 operation retrieves pickup locations near specified geographic coordinates using the PostNL API. It is useful for scenarios where you want to find nearby parcel lockers or retail points for package drop-off based on latitude and longitude. For example, an e-commerce platform could use this node to suggest convenient pickup points to customers during checkout.

Properties

Name	Meaning
Latitude	The latitude coordinate of the location around which to search for pickup points.
Longitude	The longitude coordinate of the location around which to search for pickup points.
Country Code	The country code (e.g., NL or BE) indicating the country for which the coordinates are provided.
Delivery Date	The earliest delivery date in `dd-MM-yyyy` format. This date cannot be in the past; otherwise, an error will occur.
Opening Time	A time filter in `hh:mm:ss` format to exclude locations that are closed at the specified time.
Delivery Options	Filters the types of pickup locations returned: by default includes retail points and parcel lockers (`PG`). Can be set to only parcel lockers (`PA`) or exclude parcel lockers (`PG_EX`).

Output

The node outputs JSON data containing details about the pickup locations found near the given coordinates. This typically includes information such as location names, addresses, opening hours, and available delivery options. There is no indication that binary data is output by this operation.

Dependencies

Requires an API key credential for authenticating with the PostNL API.
The base URL for the API is configured via credentials/environment variables.
The node uses the PostNL OpenAPI specification internally to build requests.

Troubleshooting

Invalid Date Error: If the Delivery Date is set to a past date, the API will return an error. Ensure the date is today or in the future.
No Locations Found: If no pickup locations appear, verify that the coordinates and country code are correct and that the filters (like Opening Time and Delivery Options) are not too restrictive.
Authentication Errors: Make sure the API key credential is correctly configured and has the necessary permissions.
Incorrect Parameter Format: Dates must be in dd-MM-yyyy and times in hh:mm:ss format; incorrect formatting may cause request failures.