n8n-nodes-ppl

This is an n8n community node for PPL CZ (CPL API).

PPL CZ is a Czech parcel delivery service (part of DHL Group). This node allows you to interact with the PPL CPL API directly from your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Credentials

To use this node, you need PPL CPL API credentials:

1. Client ID and Client Secret – provided by PPL after signing a contract
2. Choose between Production and Test (Dev) environment
3. The node handles OAuth 2.0 Bearer token authentication automatically

Contact your PPL sales representative or ithelp@ppl.cz for API access.

Supported Operations

Shipment

• Track – Get tracking information for shipments (by shipment number, invoice number, customer reference, etc.)
• Cancel – Cancel a shipment (if not yet physically dispatched)
• Redirect – Add redirect information to a shipment
• Upload Documents – Upload customs documents to a shipment

Shipment Batch

• Create – Create shipments with full customization (product type, recipient, sender, COD, insurance, services, etc.)
• Get Status – Poll the import status of a shipment batch (Accepted → InProcess → Complete)
• Get Label – Download generated labels for a shipment batch
• Update Label Format – Change the output format of labels (PDF, ZPL, JPEG, PNG, SVG)
• Connect Set – Connect shipment sets

Order

• Get – Get order status information
• Cancel – Cancel a collection order or transport order

Order Batch

• Create – Create collection orders (pickup) or transport orders
• Get Status – Check the status of created orders

Access Point

• List – List PPL Parcelshops and access points with filtering

Address Whisper

• Search – Address autocomplete/suggestion service

Codelist

• Products – Available product types (BUSS, BUSD, PRIV, PRID, CONN, COND, etc.)
• Countries – Supported countries with COD permissions
• Currencies – Allowed currencies
• Services – Additional services for shipments
• Shipment Phases – Shipment lifecycle phases
• Statuses – Shipment status codes
• Age Check – Age verification options
• External Numbers – External number type codes
• Service Price Limits – Min/max values for services
• Validation Messages – Error message codes
• Proof of Identity Types – Identity document types
• Document File Types – Document types for customs

Customer

• Get Info – Customer information and allowed currencies
• Get Addresses – Customer registered addresses
• Create Number Range – Create a shipment number range

Label

• Download – Download a label file by data GUID (returns binary data)

Routing

• Get – Get routing information for shipment labeling

Info

• Get – General API info
• Get Version Info – API version news and planned maintenance

API Reference

• API Documentation: https://ppl-cpl-api.apidog.io/
• Sandbox: https://sandbox.ppl.cz/
• Production Base URL: https://api.dhl.com/ecs/ppl/myapi2
• Test Base URL: https://api-dev.dhl.com/ecs/ppl/myapi2

Typical Workflow

1. Create shipment → Shipment Batch > Create (returns batchId)
2. Poll status → Shipment Batch > Get Status (wait for Complete)
3. Download label → Shipment Batch > Get Label or Label > Download
4. Track shipment → Shipment > Track

License

MIT