PostNL icon

PostNL

Interact with PostNL API

Actions17

Overview

This node calculates the shipping date based on a given expected delivery date and shipping duration. It is useful for logistics, e-commerce, or shipping workflows where you need to determine when a shipment must be sent out to meet a specified delivery deadline. For example, if you know the final delivery date and how long it takes for the package to reach the carrier (PostNL), this node helps calculate the latest possible shipping date.

Properties

Name Meaning
Delivery Date The expected delivery date of the shipment to the final destination. Format is a string representing a date (e.g., "30-05-2022").
Shipping Duration Number of days it takes for the shipment to be delivered to PostNL. A value of 1 means same-day delivery to PostNL, 2 means next day, etc.
Postal Code Zipcode of the destination address.
Country Code ISO2 code of the destination country. Options: "NL" (Netherlands), "BE" (Belgium).
Origin Country Code ISO2 code of the origin country. Options: "NL" (Netherlands), "BE" (Belgium).
City City of the destination address. Optional string.
Street Street name of the destination address. Optional string.
House Number House number of the destination address. Optional number.
House Nr Ext House number extension of the destination address. Optional string.

Output

The node outputs JSON data containing the calculated shipping date information. This typically includes the date by which the shipment should be sent to PostNL to meet the expected delivery date, considering the shipping duration and address details. The exact structure depends on the API response but generally provides the computed shipping date and possibly additional metadata related to 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 sends query parameters corresponding to the input properties to the PostNL API to perform the calculation.

Troubleshooting

  • Invalid Date Format: Ensure the "Delivery Date" is provided in the correct format expected by the API (likely "DD-MM-YYYY").
  • Missing Required Fields: The node requires at least Delivery Date, Shipping Duration, Postal Code, Country Code, and Origin Country Code. Missing these will cause errors.
  • API Authentication Errors: Verify that the API key credential is correctly set up and has necessary permissions.
  • Unsupported Country Codes: Only "NL" and "BE" are supported for country codes; using others may result in errors.
  • Network Issues: Connectivity problems to the PostNL API endpoint can cause request failures.

Links and References

Discussion