Overview

PostNL Shipping Connector integrates Odoo Delivery Methods with the PostNL shipment and label API. The module adds PostNL as a delivery carrier provider and lets users create PostNL shipments from the standard Odoo Send to Shipper flow.

The connector is designed for businesses that use Odoo for sales, inventory and delivery operations and want to generate PostNL labels directly from Odoo delivery orders.

Main Features

• Adds PostNL as an Odoo delivery carrier provider.
• Supports PostNL sandbox and production API environments.
• Creates PostNL shipments from Odoo delivery orders.
• Generates and stores PostNL PDF shipping labels.
• Stores shipment ID, barcode, tracking number and tracking URL on the delivery order.
• Adds a Print PostNL Label button for reprinting labels.
• Logs sanitized request and response data in the delivery order and sales order chatter.
• Removes PDF label base64 content from chatter and debug fields.
• Supports parcel and Non-EU credential sets.
• Automatically selects Parcel or Non-EU credentials based on the destination country.
• Uses Odoo delivery method pricing for fixed delivery price and free-over amount.

PostNL Configuration

The module adds a dedicated PostNL configuration tab on the Odoo delivery method form. Configuration includes:

• Environment: Test or Production
• Shipment / Label API URL
• API key
• Customer number
• Collection location
• Parcel customer code
• Parcel barcode series
• Non-EU party code
• Non-EU barcode series
• Product code
• Sender address details

How It Works

1. Create or confirm a sales order in Odoo.
2. Select the PostNL delivery method.
3. Open the generated delivery order.
4. Click Send to Shipper.
5. The module sends the shipment request to PostNL.
6. PostNL returns shipment and label information.
7. The module stores the barcode, tracking number and PDF label on the delivery order.
8. Click Print PostNL Label to download or print the generated label.

Sandbox and Production

The connector supports both sandbox and production API endpoints. Use the sandbox environment for testing your PostNL credentials and label flow before switching to production.

Production mode requires valid production API credentials from PostNL. Sandbox credentials cannot be used for live shipment creation.

Requirements

• Odoo Delivery module.
• Odoo Inventory / Stock module.
• Odoo Sales module.
• Active PostNL business account.
• Valid PostNL API key.
• Valid PostNL customer number, customer code, collection location and product code.

Important Notes

• This module creates PostNL shipments through the PostNL shipment/label API endpoint.
• Labels are generated in PDF format.
• ZPL label output is not included in this version.
• PostNL API credentials are not included with the module.
• Users must request and manage their own PostNL API credentials through PostNL.

Support

For support, configuration assistance or custom extensions, contact: support@fx-commerce.com