| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Sales (sale_management)
• Discuss (mail) • Invoicing (account) • Inventory (stock) |
| Lines of code | 950 |
| Technical Name |
muk_delivery_dhl_paket |
| License | See License tab |
| Website | http://www.mukit.at |
| Versions | 16.0 17.0 18.0 19.0 |
MuK Delivery DHL Paket
DHL Paket Germany shipping integration for Odoo
MuK IT GmbH - www.mukit.at
Overview
This module integrates the DHL Parcel DE Shipping v2 REST API with Odoo delivery carriers. It supports creating shipments, printing labels in PDF and ZPL format, cancelling shipments and tracking packages directly from the delivery order. The integration is built for DHL Paket business customer accounts in Germany.
DHL Paket is the domestic German parcel product of Post & Parcel Germany. It is not related to DHL Express, which uses the separate MyDHL API.
Shipment Creation
When a delivery order is validated, the module requests an OAuth2 access token from the DHL authentication API and sends the shipment to the Parcel DE Shipping API. Tracking numbers are retrieved automatically and stored on the delivery order. Labels are attached to the chatter as PDF or ZPL files depending on the carrier configuration.
Every package of the delivery order becomes its own parcel, and a remaining bulk weight is shipped as an additional parcel. Each shipment receives a direct tracking link to the DHL tracking page.
Flexible Configuration
The carrier supports the products DHL Paket, DHL Paket International, DHL Europaket, DHL Kleinpaket and Warenpost International, for destinations inside the EU customs union. The document format is configured as PDF or ZPL2, independently of the print format, so every DHL laser and thermal label size is available. Leaving the print format empty uses the format configured in the DHL Business Customer Portal.
Value added services such as premium delivery, bulky goods, named person only, no neighbour delivery, signed for by recipient and a visual check of age are enabled per carrier.
Cancellation
Cancelling a delivery order cancels the shipment at DHL and clears the tracking number, so a parcel that is never handed over does not stay open in your DHL account.
Test Before You Ship
The carrier ships with a test environment toggle. The DHL sandbox is available without a business customer relationship and accepts the shared test user published by DHL, so the whole flow can be verified before the first real parcel. Production access additionally requires an EKP, an account on the DHL Business Customer Portal and a certification of the sandbox usage by DHL.
Help and Support
Feel free to contact us, if you need any help with your Odoo
integration or additional features.
You will get 30 days of
support in case of any issues (except data recovery, migration or
training).
Our Services
Odoo
Development
Odoo
Integration
Odoo
Infrastructure
Odoo
Training
Odoo
Support
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Sales (sale_management)
• Discuss (mail) • Invoicing (account) • Inventory (stock) |
| Lines of code | 950 |
| Technical Name |
muk_delivery_dhl_paket |
| License | See License tab |
| Website | http://www.mukit.at |
MuK Delivery DHL Paket
Integrates the DHL Parcel DE Shipping v2 API with Odoo delivery carriers. Supports creating shipments, printing labels, cancelling shipments and tracking packages for DHL Paket Germany business customer accounts.
This module covers DHL Paket, the domestic German parcel product of Post & Parcel Germany. It is not related to DHL Express, which uses the separate MyDHL API.
Installation
To install this module, you need to:
Download the module and add it to your Odoo addons folder. Afterward, log on to your Odoo server and go to the Apps menu. Trigger the debug mode and update the list by clicking on the "Update Apps List" link. Now install the module by clicking on the install button.
Upgrade
To upgrade this module, you need to:
Download the module and add it to your Odoo addons folder. Restart the server and log on to your Odoo server. Select the Apps menu and upgrade the module by clicking on the upgrade button.
Configuration
Create a new shipping method with the provider DHL Paket. Enter the client ID and client secret of an app registered on the DHL developer portal, together with the user and password of the DHL Business Customer Portal. Add the billing number of the account and select the shipping product, the label format and the additional services.
Test the configuration against the DHL sandbox before going live. The sandbox accepts the shared test user published by DHL and does not require a business customer relationship. Production access requires an EKP, an account on the DHL Business Customer Portal and a certification of the sandbox usage by DHL.
Usage
Assign the shipping method to a delivery order. When the order is validated the shipping label is created automatically and the tracking number is written to the delivery order. Cancelling the delivery order cancels the shipment at DHL.
Known Limitations
Return labels are not supported. The DHL Parcel DE Shipping API only issues a return label together with an outgoing shipment, while standalone return labels require the separate DHL Parcel DE Returns API.
The API offers no rating operation, so the carrier always returns a zero shipping cost.
Shipments that leave the EU customs union need a customs declaration, which this module does not support. Such a delivery order is rejected with an explanatory message instead of being handed over to DHL.
Credits
Contributors
- Mathias Markl <mathias.markl@mukit.at>
Author & Maintainer
This module is maintained by the MuK IT GmbH.
MuK Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from MuK IT GmbH. The above permissions are granted for a single database per purchased license. Furthermore, with a valid license it is permitted to use the software on other databases as long as the usage is limited to a testing or development environment. You may develop modules based on the Software or that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the MuK Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module