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 generates barcodes for a given customer using the PostNL API. It is useful in scenarios where you need to create shipping or tracking barcodes programmatically, such as automating label printing or integrating barcode generation into order fulfillment workflows. For example, an e-commerce platform can use this node to generate unique barcodes for each shipment based on customer codes and specific barcode types.

Properties

Name	Meaning
Customer Code	The customer code for which you want a barcode to be generated. Example: "DEVC".
Customer Number	The customer number associated with the customer code. Example: "11223344".
Type	The barcode type to generate. Options include: 2 S, 3 S, CC, CP, CD, CF, LA, RI, UE. These represent different barcode formats supported by PostNL.
Serie	Barcode series in the format '###000000-###000000', e.g., "100000000". The range must have a minimum difference of 100,000. Leading zeros are allowed. See Guidelines for details.
Range	Used only for International Mail and Packet products (types LA, RI, UE). Identifies the issuing postal administration's country (e.g., "NL").

Output

The node outputs JSON data containing the generated barcode(s) information returned from the PostNL API. This typically includes barcode strings that can be used for labeling shipments or tracking purposes. The output does not include binary data.

Dependencies

Requires an API key credential for authenticating with the PostNL API.
The node uses the PostNL environment URL configured in credentials.
Depends on the @devlikeapro/n8n-openapi-node package and the bundled OpenAPI specification for request building.

Troubleshooting

Invalid Customer Code or Number: Ensure the customer code and number are correct and registered with PostNL.
Incorrect Barcode Type: Use one of the supported barcode types listed in the properties.
Serie Format Errors: Follow the required format and range rules for the serie property; otherwise, the API may reject the request.
Range Usage: Only specify the Range property when generating barcodes for international mail types (LA, RI, UE).
Authentication Failures: Verify that the API key credential is valid and has the necessary permissions.
API Endpoint Issues: Check the configured environment URL and network connectivity to PostNL services.