Odoo-PostNl-Integration

Odoo – PostNL Shipping Integration

Real-time shipping, label generation, and tracking with PostNL inside Odoo

1. Overview

The Odoo – PostNL Shipping Integration module connects your Odoo system with the PostNL shipping carrier, enabling a complete shipping workflow directly inside Odoo.

It provides real-time shipping rates, automated shipping label generation, tracking number management, and shipment status updates. This allows businesses to streamline logistics operations without leaving the Odoo environment.

This integration removes the need to manually use the PostNL dashboard and automates key parts of the shipping and fulfilment process.

2. Core Features

  • Connect Odoo with PostNL via API

  • Fetch real-time shipping rates based on customer address and warehouse location

  • Generate shipping labels directly from Odoo delivery orders

  • Automatically retrieve and store PostNL tracking numbers

  • Track and trace shipment status from inside Odoo

  • Support multiple packages per shipment

  • Automatically update delivery orders with PostNL shipment data

3. Dependencies

  • stock – Inventory and warehouse operations

  • sale_management – Sales order processing

  • delivery – Delivery carrier framework

  • account – Invoicing and billing

  • base – Core Odoo framework

4. Installation

  1. Download or clone the repository into your Odoo custom addons directory
    git clone https://github.com/devhassan17/Odoo-PostNl-Integration.git

  2. Update the Apps List in Odoo (Apps → Update Apps List)

  3. Install the module “PostNL Shipping Integration”

  4. Restart the Odoo server if required

5. Configuration

After installation, configure PostNL inside Odoo:

  1. Go to Inventory → Configuration → Delivery Methods

  2. Create a new delivery method and select PostNL as the provider

  3. Enter your PostNL API credentials (API key, account number, etc.)

  4. Configure pricing rules, package defaults, and service options

  5. Save and publish the delivery method

Once configured, PostNL becomes available as a delivery method on sales orders and eCommerce checkouts.

6. How It Works

  • Select PostNL as the delivery method on a Sales Order or Website Order

  • Retrieve live shipping rates and apply shipping costs

  • Confirm the delivery order to generate a shipping label using the PostNL API

  • Tracking numbers are automatically stored in the delivery order

  • Shipment progress can be tracked directly from Odoo or via the PostNL tracking page

All shipment data remains synchronized in Odoo, allowing you to manage the complete shipping lifecycle from order creation to final delivery.

7. Benefits

  • Reduce manual logistics operations and save time

  • Improve accuracy in shipping cost calculations

  • Gain real-time visibility into shipment status

  • Offer customers real-time delivery options and tracking information

8. Security

  • Secure storage of PostNL API credentials

  • Encrypted HTTPS communication with PostNL APIs

  • Role-based access control for delivery and configuration screens

9. Support and Contribution

If you encounter issues, want to request features, or would like to contribute, please open an issue or submit a pull request on the GitHub repository.

10. License

This module is open source. Please refer to the repository for full license details.