---
title: "How to connect Hermes"
description: "Connect your Hermes Germany account to ShipDock (beta) to create Hermes labels and offer Hermes ParcelShops, as a Self-Service or Key Account customer."
url: https://help.shipdockapp.eu/en/articles/11764777-how-to-connect-hermes
collection: "Couriers"
updated: 2026-11-19
language: en
---

# How to connect Hermes

Connect your Hermes Germany account to ShipDock (beta) to create Hermes labels and offer Hermes ParcelShops, as a Self-Service or Key Account customer.

This guide is for shops that ship from Germany with Hermes: customers choose a Hermes ParcelShop or home delivery, and you create the labels in ShipDock.

> **Info:** **Beta:** this courier is in beta in ShipDock. Double-check labels, COD and shipping details on your first shipments and tell us if something looks wrong.

## Before you start

-   A business account with Hermes Germany and a Hermes HSI **Username** and **Password**. Ask your Hermes contact for HSI access.
    
-   Your account type, **Self-Service** or **Key Account**. It decides the services and whether cash on delivery works.
    
-   Plan: **Lite** to connect Hermes and show ParcelShops, **Full** to create labels.
    
-   No test mode: every label is a real shipment at Hermes.
    

## Connect Hermes

1.  In ShipDock, open **Providers** and click **Create provider**.
    
2.  Choose **Germany** and click **Use in BETA** on the **Hermes - BETA** card.
    
3.  In the **Connection** card, turn on **Connect provider throught API** and choose the **Connection type**: **Self-Service** or **Key Account**.
    
4.  Enter your Hermes HSI **Username** and **Password**.
    
5.  In the **Status** panel, choose **Active** and click **Save**.
    

Hermes has no **Sender details** and no **COD Details** card: ShipDock sends no sender address with Hermes labels.

Then set up the rates on the **Pickup points** and **Home delivery** tabs: see [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md).

## Hermes services

-   Key Account: (Only KA) Domestic and International Parcel, to the 24 countries below.
    
-   Key Account, Germany: (Only KA) Parcel - Parcel next day, (Only KA) Parcel BAG, (Only KA) Parcel BIKE, (Only KA) Parcel LARGE ITEM.
    
-   Self-Service, Germany: (Only SS) Parcel - Parcel class (XS,S,M,L,XL), (Only SS) Parcel - Bulky goods.
    
-   Self-Service parcel class, longest plus shortest side: XS up to 37 cm, S 50 cm, M 80 cm, L 120 cm, XL 150 cm.
    

The 24 countries: DE, AT, BE, BG, CH, CZ, DK, ES, FI, FR, GR, HR, HU, IE, IT, LU, NL, NO, PL, PT, RO, SE, SI, SK.

## Pickup points

Customers can choose Hermes ParcelShops in Germany. There are no pickup point types to exclude.

## What works

-   Home delivery: Yes
    
-   Pickup points: Yes, Germany
    
-   COD: **Key Account** only, in the order currency
    
-   Mark COD as paid automatically: No
    
-   Cancel from the app: No
    
-   Test mode: No
    
-   Age check: Yes, **Ident Service - 18+** and **Ident Service - 16+** on Key Account home delivery rates
    
-   Insurance: No
    
-   Label formats: PDF, **Labels, A6 on A6** and **Labels, A6 on A4, 4pcs/page**
    

Other extra services per home delivery rate: Customer Alert Service (Email, SMS, or both), **Exclude delivery to neighbour** and **Redirection prohibited**.

## Limits

-   **Self-Service** has no COD.
    
-   Self-Service: set up shipping packages with dimensions. An order without a package uses 20 x 20 x 20 cm, class S.
    
-   Self-Service: a package above class XL can be shipped only with **Parcel - Bulky goods**.
    
-   No customs data is sent. Check with Hermes before you ship to Switzerland or Norway.
    
-   Without a separate house number, ShipDock takes it from the end of the street line. Check the label for unusual addresses.
    
-   Deleting a parcel removes it only from ShipDock. Cancel the shipment with Hermes.
    

## Troubleshooting

-   **"Package is too large and can't be shipped (…). Maximum package size is 600x360x610mm."** Self-Service: pick a smaller package, or use **(Only SS) Parcel - Bulky goods**.
    
-   **"COD may not be used for Self-Service account."** Mark the order as paid, or set its COD value to 0 in **Edit order**.
    
-   **"Hermes Parcel issues: …"** Each entry is a Hermes code and reason.
    
-   **"Hermes request has been failed with status: …"** Most often the login. Check **Username**, **Password** and that **Connection type** matches your account.
    

For errors that apply to every courier, see [How to connect a courier](https://help.shipdockapp.eu/en/articles/11764762.md).

## Related articles

-   [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md)
    
-   [How to create and print shipping labels](https://help.shipdockapp.eu/en/articles/11530903.md)
    
-   [How to set up cash on delivery (COD)](https://help.shipdockapp.eu/en/articles/9579888.md)

## Related

- [How to connect a courier](https://help.shipdockapp.eu/en/articles/11764762-how-to-connect-a-courier.md)
- [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763-supported-couriers-and-what-each-one-can-do.md)
- [How to connect Balíkovna and Česká pošta](https://help.shipdockapp.eu/en/articles/11764744-how-to-connect-balikovna-and-ceska-posta.md)
- [How to connect BoxNow](https://help.shipdockapp.eu/en/articles/11764755-how-to-connect-boxnow.md)
- [How to connect DHL Express](https://help.shipdockapp.eu/en/articles/11764765-how-to-connect-dhl-express.md)
