Skip to main content
Version: 2.0.0

DPD

DPD connects the store to DPD parcel shipping (SK/CZ region), exposing it as a shipping method at checkout and handling the whole fulfillment side afterwards: creating the parcel with DPD's API when an order ships, generating and storing the shipping label, and tracking the parcel's delivery status from the Craft control panel.

The plugin builds on the shared yStore shipping-plugin base (AbstractShippingSettingsModel/AbstractShippingSettingsController), so it shares the same core shipping method configuration (price, table rates, country/payment restrictions, visibility window) as every other carrier plugin in the ecosystem, plus DPD-specific behavior: API credentials, sandbox mode, a configurable sender/pickup address, automatic shipment creation on order status change, and an optional ParcelShop pickup-point picker at checkout.

Key features​

  • DPD as a selectable shipping method in checkout, with the usual price, weight, country, and payment-method restrictions shared by all yStore shipping plugins.
  • A free-shipping threshold and a default parcel weight used whenever an order doesn't carry its own weight.
  • Automatic shipment creation: when an order reaches a configured order status, DPD generates the parcel and label without any manual step.
  • Manual shipment creation, resynchronisation, tracking refresh, and label download/deletion from the order edit page and the Shipments section of the CP.
  • A per-order label limit (Max labels per order) to stop accidental duplicate parcels.
  • Optional ParcelShop pickup-point selection at checkout, backed by a cached, anonymous site-facing endpoint.
  • A CP dashboard with shipment statistics for the method, shared with the other carrier plugins.
  • Production and sandbox API modes with separate credentials, so integrations can be tested against DPD's test API before going live.
  • License-gated CP navigation (Dashboard, Shipments, Settings, License) via the shared yCore licensing panel.

Requirements​

  • A DPD merchant account and API credentials (username + password) for the SK/CZ DPD REST API.
  • The store's shipping methods module enabled, since DPD registers itself as one shipping method among others.

Installation​

Install through Composer, using the credentials granted by your yStore license:

composer require yui/craft-dpd

Then enable the plugin from Settings → Plugins in the Craft control panel and continue with Settings.

Use cases​

See Use Cases for offering DPD at checkout, automatic vs. manual shipment creation, generating and re-downloading labels, letting customers pick a ParcelShop, and tracking delivery status.

Developer notes​

See Developer / API for the DPD REST API client, the order-status automation hook, the checkout pickup-point widget and its site-facing endpoint, shipping method registration, and a reference table of CP routes.