Bpost Delivery
Integrate Belgian postal service shipping into Odoo
The Delivery Bpost module integrates with the Belgian postal service (bpost), enabling automatic shipping rate calculation, shipment creation and direct label printing from Odoo.
Supports both domestic (within Belgium) and international shipping with package tracking and return label capabilities.
Key Features
Key points
• Automatic shipping rate calculation based on weight and destination
• Create shipments and print shipping labels directly from Odoo
• Track packages through the bpost system
• Create return labels for domestic deliveries
• Support both domestic (within Belgium) and international shipping
• Cancel shipments when needed
Requirements
Key points
• Company/warehouse address must be in Belgium
• Need bpost account with Account Number and Passphrase
• Products must have weight configured
• Delivery address must be complete (street, city, postal code, country)
Key Terminology
| Fields | Trường dữ liệu | Description |
|---|---|---|
| Bpost Account Number | Số tài khoản Bpost | Your bpost account number |
| Passphrase | Chuỗi mật khẩu | API password from bpost |
| Bpost Delivery Nature | Tính chất giao hàng Bpost | Domestic (within Belgium) or International |
| Bpost Package Type | Loại kiện hàng Bpost | Delivery service type (bpack 24h Pro, bpack World Express, etc.) |
| Label Type | Loại nhãn | Label paper size (A4, A6) |
| Label Format | Định dạng nhãn | Label file format (PDF, PNG) |
| Delivery on Saturday | Giao hàng vào Thứ 7 | Allow Saturday delivery (additional fee) |
Configure Bpost Shipping Method
Access Inventory → Configuration → Shipping Methods to create and configure Bpost shipping method.
Steps
1. Go to Inventory → Configuration → Shipping Methods
2. Click New to create new method
3. Fill in Shipping Method (name), select Provider = bpost, select Company
4. Switch to bpost Configuration tab
5. Enter Bpost Account Number and Passphrase from bpost account
6. Select Bpost Delivery Nature: Domestic (within Belgium) or International
7. Select appropriate Bpost Package Type for service type
8. Select Label Type (A4/A6) and Label Format (PDF/PNG)
9. Configure additional options if needed
10. Click Save to save configuration
Domestic Delivery Types
Domestic Package Types
| Service Type | Description |
|---|---|
| bpack 24h Pro | Fast 24h delivery for business |
| bpack 24h business | Standard business delivery |
| bpack Bus | Delivery via bus network |
International Delivery Types
International Package Types
| Service Type | Description |
|---|---|
| bpack World Express Pro | Fast international delivery |
| bpack World Business | International business delivery |
| bpack Europe Business | European region delivery |
Calculate Shipping Rates on Orders
For accurate rate calculation, ensure all products have weight, delivery address is complete, and warehouse/company address is in Belgium.
Steps
1. Create or open Sales Order
2. Fill in complete customer information, delivery address and products
3. Click Add Shipping
4. Select appropriate Bpost method
5. Click Get Rate to calculate shipping cost
6. System displays estimated shipping cost
7. Click Add to add to order
Create Shipment and Print Labels
After confirming the order, the system automatically creates a Delivery Order. From here you can create bpost shipment and print shipping labels.
Steps
1. Confirm Sale Order
2. Open automatically created Delivery Order
3. Check Carrier = bpost, complete delivery address, product weight
4. Click Check Availability if needed, set actual quantity (Quantity Done)
5. Pack if needed (Put in Pack)
6. Click Validate to complete shipment
7. System automatically sends information to bpost API and creates shipment
8. Go to Chatter section, find message "Shipment created into bpost"
9. Click attached file (e.g., Label-001.PDF)
10. Print label and attach to package
Track Shipments
After successful label creation, you can track delivery status via tracking number.
Key points
• Open Delivery Order and view Tracking Reference field
• If multiple packages, tracking numbers are separated by commas
• Click Tracking button on Delivery Order form to open bpost tracking page
• Or go to Chatter section, find message and click tracking link
• URL format: http://track.bpost.be/btr/web/#/search?itemCode=[TRACKING_CODE]&lang=en&postalCode=[ZIP]
Create Return Labels
Only applies to Domestic deliveries. International shipping does not support automatic return label creation.
Key points
• Automatic: Enable Return Label on Delivery in configuration to automatically create return label when validating Delivery Order
• Manual: Open completed Delivery Order, click Return, create Return Picking, validate to create return label
• Portal: Enable Get Return Label from Portal to allow customers to download return labels from portal
• Return labels are attached in chatter with filename like: ReturnLabel-1.PDF
Cancel Shipments
Note: Canceling in Odoo does not automatically cancel shipment on bpost system. You need to contact bpost to cancel actual shipment if needed.
Steps
1. Open Delivery Order to cancel
2. Click Cancel (if not validated) or Action → Cancel Shipment (if validated)
3. Confirm cancellation
4. Tracking Reference is cleared, Carrier Price set to 0
5. Cancellation message recorded in chatter: "Shipment #[tracking] has been cancelled"
Common Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
| Authentication error | Wrong Account Number or Passphrase | Check login credentials, contact bpost to verify account |
| Recipient address incomplete | Missing delivery address information | Update complete Street, City, Zip, Country |
| Address must be in Belgium | Company/warehouse address not in Belgium | Update company/warehouse address to Belgium or use different method |
| Domestic for Belgium only | Using Domestic for delivery outside Belgium | Switch to bpost International method |
| International for outside Belgium | Using International for delivery within Belgium | Switch to bpost Domestic method |
| Weight is missing | Product has no weight | Go to Product → Inventory tab, fill Weight |
| Packages over 30 Kg | Package heavier than 30kg | Split into smaller packages or use different method |
| Service unresponsive | bpost API temporarily unavailable | Wait a few minutes and retry, check internet connection |
Practical Tips
Key points
• Data preparation: Always enter complete customer address, set weight for all products
• Optimize workflow: Create 2 separate methods for Domestic and International, use clear names
• Enable Return Label on Delivery for Domestic to save time
• Order processing: Check carrier before validate, pack carefully, print labels immediately after validate
• Tracking: Send tracking link to customers, monitor delivery status to proactively handle issues
• Cost savings: Optimize package weight, disable Saturday Delivery if not needed, group orders in same area