PHPackages quellabs/canvas-shipments-dhl - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. quellabs/canvas-shipments-dhl ActiveLibrary quellabs/canvas-shipments-dhl ============================= DHL Parcel NL shipping provider integration for the Canvas PHP framework 1.0.0(today)00MITPHPPHP ^8.2 Since Apr 3Pushed todayCompare [ Source](https://github.com/quellabs/canvas-shipments-dhl)[ Packagist](https://packagist.org/packages/quellabs/canvas-shipments-dhl)[ RSS](/packages/quellabs-canvas-shipments-dhl/feed)WikiDiscussions main Synced today READMEChangelogDependencies (4)Versions (2)Used By (0) DHL Parcel NL Shipping Provider =============================== [](#dhl-parcel-nl-shipping-provider) A DHL Parcel NL shipping provider for the Canvas framework. Installation ------------ [](#installation) ``` composer require quellabs/canvas-shipments-dhl ``` Configuration ------------- [](#configuration) `config/dhl.php` is published automatically when you install the package. Fill in your credentials: ``` return [ 'user_id' => '', // UUID from My DHL Parcel portal → Settings → API Keys 'api_key' => '', // UUID paired with user_id 'user_id_test' => '', // acceptance environment credentials (optional) 'api_key_test' => '', 'account_id' => '', // DHL account number from your contract 'test_mode' => false, 'sender_address' => [ 'company' => 'My Webshop B.V.', 'person' => 'Logistics Dept', 'street' => 'Keizersgracht', 'number' => '123', 'postal_code' => '1015CJ', 'city' => 'Amsterdam', 'cc' => 'NL', 'email' => 'logistics@example.com', 'phone' => '+31201234567' ], ]; ``` `user_id` and `api_key` are generated in the My DHL Parcel portal under **Settings → API Keys**. The key pair is shown only once — generating a new key invalidates the previous one. `account_id` is the DHL account number from your contract. Important behaviours -------------------- [](#important-behaviours) **Tracking code is available at creation time.** `ShipmentResult::$parcelId`, `$trackingCode`, and `$trackingUrl` are all populated immediately after `create()`. DHL assigns the barcode (tracker code) inline in the creation response. **Labels are never returned at creation time.** `ShipmentResult::$labelUrl` is always `null`. Call `getLabelUrl()` on the driver when you need the label — it performs two API calls (resolve label ID, then build the endpoint URL) and returns a Bearer-token-protected URL. Fetch it server-side and proxy the PDF to clients; do not expose the URL directly. **Parcel type is auto-selected from weight.** The driver picks the smallest DHL parcel type that fits `ShipmentRequest::$weightGrams`: Parcel typeMax weightMax dimensions`SMALL`2 kg38 × 26 × 10 cm`MEDIUM`10 kg58 × 38 × 37 cm`LARGE`20 kg100 × 50 × 50 cm`XL`31.5 kg—Shipments exceeding 31.5 kg throw `ShipmentCreationException`. To override, set `ShipmentRequest::$packageType` to the desired type key (`'SMALL'`, `'MEDIUM'`, `'LARGE'`, or `'XL'`) — this bypasses auto-selection entirely. **Cancellation is not supported via the public API.** `cancel()` always throws `ShipmentCancellationException`. Cancel shipments manually via the My DHL Parcel portal, or use the Interventions endpoint if it is enabled on your account. **Delivery options are not available.** `getDeliveryOptions()` always returns an empty array. DHL does not expose a consumer-facing timeslot picker equivalent to the delivery options API. **Pickup options require a recipient address.** Pass a `ShipmentAddress` as the second argument to `getPickupOptions()`. The address is used as the search origin for nearby DHL ServicePoints. Without an address an empty array is returned. **Test mode targets the DHL acceptance environment.** Setting `test_mode => true` switches both the base URL (`https://api-gw-accept.dhlparcel.nl`) and credentials to the test pair. If `user_id_test` / `api_key_test` are not configured, the live credentials are used against the acceptance environment. **Webhooks carry only the barcode.** DHL's Track & Trace Pusher sends `{ "barcode": "..." }` in the webhook payload. The driver calls `exchange()` on every webhook event to fetch the full event history and build a consistent `ShipmentState`. Restrict the webhook endpoint by IP or secret path — DHL does not sign webhook requests. **Authentication tokens are managed transparently.** DHL uses short-lived JWT access tokens (~15 minutes) refreshed automatically using a longer-lived refresh token (~7 days). No token management is required from the caller. Supported modules ----------------- [](#supported-modules) ModuleDHL product keyService`dhl_parcel``PARCEL_CONNECT`Standard domestic NL and cross-border EU`dhl_mailbox``MAILBOX_PACKAGE`Mailbox parcel (brievenbuspakje)`dhl_express``EXPRESS`Express delivery (before 11:00)Not all products are available on every DHL account. Consult your DHL account manager to enable the products you need, and use the DHL capabilities endpoint to verify availability per destination. License ------- [](#license) MIT ### Health Score 39 — LowBetter than 86% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community2 Small or concentrated contributor base Maturity45 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/57e4ab872b3e37536367f2d26b192df3d3bb6a6a1cebec9a104d14a6d2ffe157?d=identicon)[noescom](/maintainers/noescom) --- Tags canvasshippingshipmentdhlcanvas-shipments ### Embed Badge ![Health badge](/badges/quellabs-canvas-shipments-dhl/health.svg) ``` [![Health](https://phpackages.com/badges/quellabs-canvas-shipments-dhl/health.svg)](https://phpackages.com/packages/quellabs-canvas-shipments-dhl) ``` ### Alternatives [shippo/shippo-php A PHP library for connecting with multiple carriers (FedEx, UPS, USPS) using Shippo. 1711.8M2](/packages/shippo-shippo-php)[sauladam/shipment-tracker Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access. 9738.8k](/packages/sauladam-shipment-tracker)[magepsycho/magento2-custom-shipping Magento 2 Custom Shipping 697.5k](/packages/magepsycho-magento2-custom-shipping) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)