Actions17
- Shipping Status Actions
- Confirming Actions
- Labelling Actions
- Shipment Actions
- Barcode Actions
- Checkout Actions
- Deliverydate Actions
- Locations Actions
- Postalcode Check Actions
- Timeframes Actions
Overview
This node operation allows you to retrieve pickup locations based on a recipient's address. It is useful when you want to find nearby parcel lockers or retail points where parcels can be collected. Typical scenarios include e-commerce platforms offering customers the option to pick up their orders at convenient locations, or logistics services providing location suggestions for parcel drop-off.
For example, given a postal code and city, the node can return all available pickup points in that area, filtered by opening times or specific types of pickup locations (e.g., parcel lockers only).
Properties
| Name | Meaning |
|---|---|
| Country Code | The country of the recipient's address. Options: "NL" (Netherlands), "BE" (Belgium). |
| Postal Code | The postal/zipcode of the recipient's address. |
| City | The city of the recipient's address. Optional but helps narrow down the search. |
| Street | The street name of the recipient's address. Optional detail to refine location search. |
| House Number | The house number of the recipient's address. Optional detail to refine location search. |
| House Number Extension | Additional extension to the house number (e.g., apartment or unit number). Optional. |
| Delivery Date | The earliest delivery date at the pickup location in format dd-MM-yyyy. Cannot be in the past; if omitted, defaults to the current day. |
| Opening Time | Filter locations by opening time in format hh:mm:ss. Only locations open at this time will be returned. If omitted, all locations are returned regardless of opening hours. |
| 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 output JSON contains an array of pickup locations matching the provided address and filters. Each location typically includes details such as:
- Location identifier
- Address information
- Type of pickup location (retail point, parcel locker)
- Opening hours
- Availability on the specified delivery date
If binary data were involved (e.g., images or documents), it would be summarized here, but this operation returns structured JSON data only.
Dependencies
- Requires an API key credential for authenticating with the PostNL API.
- The node uses the PostNL API endpoint configured via environment credentials.
- No additional external dependencies beyond the PostNL API and n8n core modules.
Troubleshooting
- Invalid or missing required parameters: Ensure that mandatory fields like Country Code and Postal Code are provided and correctly formatted.
- Delivery Date in the past: The API rejects requests with a delivery date earlier than the current date. Use today's date or a future date.
- No locations found: This may occur if the address is incomplete or too restrictive filters are applied (e.g., opening time outside all locations' hours).
- Authentication errors: Verify that the API key credential is valid and has proper permissions.
- API rate limits or downtime: Temporary failures might happen due to API limits or service issues; retry after some time.
Links and References
- PostNL Developer Portal
- PostNL Pickup Locations API Documentation (for detailed API parameters and responses)