外掛說明

The Shipping Labels for DHL eCommerce APAC plugin, developed by Algoleap Technologies Pvt Ltd, automates your shipping workflow by connecting your WooCommerce store to DHL eCommerce APAC services — with full support for WooCommerce HPOS and now automatic tracking status updates via Webhooks.

Key Features

Generate and print shipping labels directly from WooCommerce admin.
Automatically track shipments and update order status via Webhooks.
Offer DHL shipping options at checkout.
Calculate accurate shipping rates based on destination, weight, and dimensions.
Supports WooCommerce HPOS (High-Performance Order Storage).
Easy-to-use interface for generating and printing shipping labels.
Seamless integration with WooCommerce checkout process.
Detailed documentation and support available.

New in Version 1.1.9

Improved: Shipping Phone Number Handling
- Shipping labels now prioritize the Shipping Phone Number when generating the consignee address.
- If the Shipping Phone Number is unavailable, the plugin automatically falls back to the Billing Phone Number.
- Ensures consignee contact information matches the shipping address entered during checkout while maintaining backward compatibility for stores that only use billing contact details.
Improved: Consignee Address Mapping
- Enhanced consignee phone mapping logic during both Create Label and Update Label operations.
- Prevents incorrect billing phone numbers from being used when a shipping phone number is available.

Configuration

Enter your DHL eCommerce APAC API credentials.
Configure your default package dimensions and shipping preferences.
Enable Webhook tracking updates (enabled automatically).
Enable debug logging if needed.

Usage

Creating Shipping Labels

Go to WooCommerce Orders.
Open any order and find the “DHL eCommerce APAC” panel.
Fill in shipping details and click Generate Label.
Download and print the generated label.

Bulk Label Creation

Go to WooCommerce Orders.
Select multiple orders.
Choose Create DHL eCommerce APAC Labels from the Bulk Actions dropdown.

Automatic Tracking Updates

DHL’s ELR system automatically sends tracking updates to your webhook endpoint.
The WooCommerce order table updates the Tracking Status automatically.

WooCommerce HPOS Compatibility

Fully compatible with WooCommerce High-Performance Order Storage.

Privacy & Logging

Webhook and API logs are stored securely in WooCommerce Status Logs (when enabled).

Disclaimer

This plugin is an independent DHL eCommerce APAC integration and is not officially endorsed by DHL.

Support

Contact the WordPress plugin support forum or plugins@wordpress.org.

螢幕擷圖

安裝方式

Upload the plugin to /wp-content/plugins/shipping-labels-dhl-ecommerce-apac, or install via the WordPress plugin screen.
Activate it via Plugins > Installed Plugins.
Go to WooCommerce Settings Shipping DHL eCommerce APAC to configure.

Note: Always back up your site before updating the plugin.

常見問題集

Does this plugin support automatic tracking updates?: Yes — tracking updates are pushed directly by DHL to your webhook endpoint.
Do I need to manually configure the webhook?: No — it is registered automatically when the plugin is activated.
Does this work with HPOS?: Yes, the plugin is fully compatible.

使用者評論

annabakes 2024 年 8 月 9 日

The plugin does not with WooCommerce’s HPOS, which is supposed to be the current feature of WooCommerce. I contacted DHL’s support. They said they have no immediate update or a promised timeline. Quite disappointing for such a reputable logistic company with such low ecommerce support. The app has not been updated for 10 months. Hope they will roll out not only a new update, but regular updates.

inspired888 2023 年 11 月 6 日

Can’t really comment on the functionality of the plug-in, as it only works in Malaysia and Thailand. It would be nice if the developers actually mentioned that in the description somewhere. As for the limited testing I was able to do on the plug-in, I’ll have the following observations: It does not integrate into the WooCommerce shipping zones system. In my opinion, It’s not organised well in terms of its back-end aspects. It creates two new top level menus in the sidebar. One for the plug-ins settings (menu called DHLeCS), and another called “Manage Account pickup”. This one is for managing Pickup Locations associated with the DHL account.I would suggest having only one top-level menu item. Even better, I would suggest that since this is a WooCommerce plug-in it should add its menus not to the main Wordpress sidebar, but to the WooCommerce settings (like most other shipping and WooCommerce related plug-ins). To me, these two points show a lack of implementation planning (and user consideration) on the part of the developers. As does their ommitting to mention that it’s only of use to sites based in Thailand and Malaysia.

閱讀全部 2 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Shipping Labels for DHL eCommerce APAC〉的開發相關工作。

DHL eCommerce Asia

將〈Shipping Labels for DHL eCommerce APAC〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

1.1.8
Fixed: Fatal “Call to a member function get_data() on bool” error on order edit screen (line 108).
Fixed: Fatal “Call to a member function get_total() on null” error on Cash on Delivery field (line 434).
Fixed: Removed all redundant wc_get_order() calls inside meta box render — $dhl_order reused directly.
Fixed: Restored missing $dhl_order_id assignment that was incorrectly commented out.
Improved: Order guard strengthened to instanceof WC_Order check for permanent type safety.
Improved: Reduced database queries on order edit screen by eliminating duplicate order fetches.

1.1.7
Fixed: Shipment ID now uses WooCommerce displayed order number instead of internal order ID.
Improved: Better compatibility with HPOS and sequential order numbering plugins.
Enhanced: Shipment reference now matches admin order display for improved consistency.

1.1.6
Fixed: Expired token issue by implementing automatic token generation and refresh.
Improved: Removed dependency on manual “Test Connection”.
Improved: Bulk label creation reliability without prior authentication.
Enhanced: Token validation to prevent empty token API requests.
Refactored: Centralized token handling logic across all label operations.

1.1.5
Added: Automatic webhook endpoint for real-time tracking updates from DHL.
Added: Dynamic webhook registration during plugin activation.
Improved: Automatic update of “Status” in WooCommerce Orders.
Enhanced: Logging for webhook requests and responses.
Tested: WooCommerce 9.1.0 & WordPress 6.6
Added: Company Name field now supports 60 characters.
Updated: Address Line 1 (60 chars) & Address Line 2 (120 chars) limits.
Improved: User login redirection to DHL Configuration page.

1.1.4
Fixed: Replaced all error_log() calls with him_dhl_bulk_order_log_msg().
Improved: Bulk label API requests and responses logging.
Fixed: Ensured API responses save metadata only after proper validation.
Improved: Return address fallback logic to prevent invalid API data.

1.1.3
Fixed: Shipper address handling during bulk label creation.
Improved: Unified bulk label logging system.
Fixed: Missing error details in bulk creation logs.

1.1.2
Improved: Stability and bug fixes.
Enhanced: Full compatibility with HPOS.
Added: Support for bulk label ZIP download.
Updated: Metadata handling for HPOS tables.
Improved: Session management during label creation.

1.1.1
Fix: Added messageSource parameter in API requests.

1.1.0
Fix: Weight calculation adjustments.

1.0.9
Fix: Company name is now optional.

1.0.8
Fix: Limited package description to 50 characters.

1.0.7
Fix: Copied shipping details from billing details when only billing exists.
Fix: Shipping details now populate correctly.

1.0.6
Fix: Conflict with Sequential Order Numbers plugin.

1.0.5
New: Cash on Delivery support improvements.

1.0.4
Fix: Corrected Address Line 1 mapping.

1.0.3
Fix: Populated Remark field with Package Description.
Fix: Updated tracking URL.

1.0.2
Fix: CSS improvements.

1.0.1
New: Shipper address change implementation.
New: Error logging for label creation.
Fix: CSS issues.

1.0.0
Initial release.

Note: Before updating the plugin, we strongly recommend backing up your site (files and database) to avoid data loss in case of compatibility issues.

Doesn’t Work with HPOS. No updates soon.

Only works in Malaysia and Thailand