Skip to content

Create Shipping Labels

Overview

The Hermes Connector creates shipping labels through the merchantCENTRAL platform. Label creation is triggered centrally via the Hub — either manually through the shipment list or automatically via Job Queue Entries.

Workflow

flowchart LR
    A[Sales Shipment] --> B[Hub: Request Label]
    B --> C[Hermes API: Create Shipment]
    C --> D[Determine Routing Code]
    D --> E[Receive Label PDF/ZPL]
    E --> F[Print Label]
  1. A Sales Shipment is created
  2. The Hub triggers label creation via the Shipment Provider
  3. The Hermes Connector calls the Hermes API (Order endpoint)
  4. Hermes automatically determines the Routing Code for the destination
  5. The label is returned as PDF or ZPL
  6. The label can be printed immediately

Create Label Manually

Via the Shipment List

  1. Open the merchantCENTRAL Shipment List
  2. Select the desired shipment
  3. Click Create Label
  4. The Hub automatically selects the configured Shipment Provider (Hermes)
  5. The label is created and ready to print

Via the Sales Shipment

  1. Open a Posted Sales Shipment
  2. Click Create Shipping Label (action in the ribbon)
  3. The label is created via the assigned Shipment Provider

Required Data for Label Creation

Data Source Description
Recipient Name Ship-to Address Name of the recipient
Street + House No. Ship-to Address Delivery address
Post Code + City Ship-to Address Destination
Country Code Ship-to Address Must be DE (domestic shipping only)
Parcel Class Setup / Shipment S, M, L, XL, or XXL
Product Setup / Shipment PARCEL, PARCELSHOPDELIVERY, or PROFIPAKET
Sender Address Setup Card Taken from the Hermes Setup

Parcel Classes

Select the parcel class matching the parcel size:

Class Typical Weight Usage
S up to 5 kg Small goods, books
M up to 10 kg Standard parcels
L up to 20 kg Larger orders
XL up to 25 kg Heavy parcels
XXL up to 31.5 kg Maximum size

Default Value

If no parcel class is explicitly specified, the system uses the default value from the Hermes Setup.

PaketShop Delivery

For delivery to a Hermes PaketShop:

  1. Select the product PARCELSHOPDELIVERY
  2. Provide the PaketShop ID (can be found via the PaketShop search)
  3. The label is created with the PaketShop address as the destination

Find a PaketShop

The PaketShop search finds nearby Hermes PaketShops based on postal code or coordinates.

Error Handling

Error Cause Solution
401 Unauthorized Invalid credentials Check Client ID / Secret
400 Bad Request Invalid address or missing required fields Check delivery address, validate postal code
422 Unprocessable Invalid combination (e.g., PaketShop without Shop ID) Check product and additional data
500 Server Error Hermes-side issue Retry later

All errors are displayed with structured error messages (title, details, context, solution hints).

Result

After successful label creation:

  • The Tracking Number is stored on the shipment
  • The Label is available as PDF/ZPL for printing
  • The Routing Code is stored (for internal logistics)
  • The shipment status changes to "Label created"