README

DPD Connect for Magento 2

Integrate DPD parcel shipping directly into your Magento 2 store. Generate labels, offer Parcelshop pickup at checkout, and monitor async batches — all from the Magento admin.

Features · Requirements · Installation · Configuration · Development]

📦 Features

🏷️ Label Generation

🗺️ Delivery Options

⚡ Processing & Downloads

🔧 Admin & Integration

✅ Requirements

🚀 Installation

composer require dpdconnect/magento2-shipping

After installation run the standard Magento upgrade sequence:

php bin/magento module:enable DpdConnect_Shipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Upgrade

composer update dpdconnect/magento2-shipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

⚙️ Configuration

Navigate to Stores → Configuration → Sales → DPD Parcelservice.

Account Settings

Carrier Settings

Navigate to Stores → Configuration → Sales → Shipping Methods. Each DPD carrier (DPD, DPD Pickup, DPD Predict, DPD Saturday, etc.) has its own section with price, rate type, and allowed countries.

Advanced

🛠️ Development

Module structure

DpdConnect_Shipping/
├── Api/                    # Interfaces (ApiCallbackInterface)
├── Block/                  # Admin and frontend blocks
├── Config/Source/          # Dropdown source models
├── Controller/             # Admin + frontend controllers
├── etc/                    # XML configuration (di, events, webapi, system)
├── Helper/                 # DPDClient, DpdSettings, Data, OrderConvertService
├── Model/                  # Carriers, ResourceModels, CheckoutConfigProvider
├── Observer/               # Order, shipment and config event observers
├── Plugin/                 # Order API extension attribute plugins
├── Services/               # AuthenticationService, BatchManager, ShipmentManager
├── Setup/                  # UpgradeSchema, UpgradeData
├── Ui/                     # UI component providers
├── ViewModel/              # CheckShipment view model
├── i18n/                   # Translations (EN, NL, DE, ES, FR, IT, PL)
└── view/                   # Layout XML, templates, JS, CSS

Useful commands

# Flush cache during development
php bin/magento cache:flush

# Recompile dependency injection
php bin/magento setup:di:compile

# Reindex
php bin/magento indexer:reindex

# Run PHP linter
vendor/bin/phplint .

Webhook endpoint

DPD calls back on this endpoint after async label generation:

POST /rest/V1/dpd-shipping/callback

No Magento authentication is required (<resource ref="anonymous"/>). The callback payload contains the job ID, parcel numbers, label data (fetched separately), and error information.

❓ FAQ

I get a "Bad credentials" error when printing a label.

If you use env.php to specify credentials, use bin/magento config:sensitive:set to set the password — it must be stored encrypted.

bin/magento config:sensitive:set dpdshipping/account_settings/password "yourpassword"

DPD Fresh / Freeze orders fail when creating a shipment.

Fresh and Freeze products can only be shipped through the DPD order overview or the packages screen. Standard Magento shipment creation is blocked by design to ensure expiration dates and product descriptions are filled in correctly.

Labels are not appearing after async batch processing.

Check Sales → DPD → Batches for the job status. If jobs show failed, verify the webhook URL is publicly accessible: https://your-store.com/rest/default/V1/dpd-shipping/callback

Saturday delivery is not showing at checkout.

The Saturday carrier has a configurable display window. Go to Stores → Configuration → Sales → Shipping Methods → DPD Saturday and check the "Shown from" and "Shown till" day/time settings.