Shipping Integration
One Shipping System for All Carriers
In a classic multi-channel scenario, you create shipping labels via the portal of each carrier β DHL Business Customer Portal, DPD MyDPD, GLS ShipIT, UPS Worldship, and so on. With five carriers, that means five different logins, five different interfaces, and tracking numbers must be manually assigned to orders.
merchantCENTRAL unifies this: One dialog, all carriers.
The Label Creation Process
Step 1: Request Label
The Create Label dialog is opened from the sales order (or via the Shipping Label List). The hub automatically populates:
- Delivery address from the sales order
- Weight from the item master data
- Carrier based on configuration or last usage
Step 2: Hub Delegates to Connector
The hub fires the event OnCreateShipmentLabel. The responsible carrier connector responds:
| Carrier | Connector | Technology |
|---|---|---|
| DHL | ALN MCDHL | REST API v2 |
| DPD | ALN MCDPD | SOAP/XML |
| GLS | ALN MCGLS | REST API v3 |
| UPS | ALN MCUPS | REST API (OAuth 2.0) |
| Rhenus | ALN MCRH | BORD512 Flat-File via SFTP |
Step 3: Receive and Store Label
The connector calls the carrier API and receives: - Tracking number (shipment number) - Label data (PDF or ZPL as Blob) - Optionally return labels, customs documents, COD labels
Everything is stored in the central table ALN MC Shipment Label.
Step 4: Auto-Link Tracking
The hub automatically creates a Tracking Entry in the Marketplace Order. The marketplace connectors detect new tracking entries and send the shipping confirmation back to the respective marketplace API.
Supported Features per Carrier
| Feature | DHL | DPD | GLS | UPS | Rhenus |
|---|---|---|---|---|---|
| Create Label | β | β | β | β | β |
| Bulk Labels | β (up to 30) | β | β | β | β |
| Cancel Label | β | β | β | β | β |
| Return Label | β | β | β | β | β |
| End of Day | β | β | β | β | β |
| PDF Label | β | β | β | β | β |
| ZPL Label | β | β | β | β | β |
| Customs Documents | β | β | β | β | β |
| Cash on Delivery | β | β | β | β | β |
| Connection Test | β | β | β | β | β |
Carrier Products
Each carrier offers different shipping products:
DHL
- V01PAK β DHL PAKET (domestic)
- V53WPAK β DHL PAKET International
- V54EPAK β DHL Europaket
- V62KP β DHL Kleinpaket (small parcel)
- V66WPI β Warenpost International
DPD
- CL β DPD Classic
- E830 / E12 / E18 β DPD Express
- IE2 β DPD International Express
- PL β DPD ParcelShop
GLS
- PARCEL β BusinessParcel (domestic/EU/international)
- EXPRESS β ExpressParcel
UPS
- 11 β UPS Standard
- 07 β UPS Express
- 65 β UPS Express Saver
Rhenus
- LTL (Less Than Truckload) via BORD512 format
- Multiple packages (colli) per shipment
Automatic Carrier Mapping
The hub automatically recognizes the associated carrier based on tracking number patterns:
| Carrier | Tracking No. Pattern | Example |
|---|---|---|
| DHL | Starts with 00, 12-20 digits |
00340434161094042557 |
| DPD | 14 digits numeric | 01234567890123 |
| GLS | Starts with a digit, 11-12 digits | 12345678901 |
| UPS | Starts with 1Z |
1Z999AA10123456784 |
| Hermes | 12-16 digits, various formats | H1234567890123456 |
This mapping is used when a tracking number comes from an external source (e.g., dropshipping) and the correct carrier needs to be assigned.
Print Service (Optional)
If the optional app merchantCENTRAL Print Service is installed, labels can be automatically printed after creation:
| Label Format | Print Path |
|---|---|
| HTTP POST β ECIService β Windows Printer | |
| ZPL | HTTP POST β ECIService β Zebra Thermal Printer (TCP/IP) |
The Print Service reacts to the hub event OnAfterCreateShipmentLabel and automatically sends the label to the configured printer.
Related Pages
- The Hub Model β Overview of the hub architecture
- Order Management β How orders are imported
- Shipping Providers β Manage all carriers
- Provider Card β Configure a carrier
- Create Label β The label creation dialog
- Shipping Labels β View all labels
- Package Tracking β Monitor tracking status