Site Logo

Hermes Germany Guide

Hermes Germany offers shipping solutions for domestic-only shipments within Germany. With ShipEngine, you can also track your Hermes shipments and create Hermes return labels.

To start a new account with this carrier, visit the Hermes Germany webpage.

This guide provides developers with an overview of the shipping services that Hermes Germany offers and the service codes that you will use to create Hermes Germany shipments.

Connect Your Account

ShipEngine API allows you to connect your Hermes Germany accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing Hermes Germany accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect Hermes Germany using the ShipEngine API.

For instructions on connecting Hermes Germany via the ShipEngine dashboard, go to our Hermes Germany help article.

Hermes Germany Account Information Model

nicknameThis is a nickname for you to identify the carrier account in ShipEngine.string, required
usernameUsernamestring, required
passwordPasswordstring, required
pickup_window_slotPickup Window
[ { "enum": [ "BETWEEN_10_AND_13" ],
"title": "Between 10 and 13" },
{ "enum": [ "BETWEEN_12_AND_15" ],
"title": "Between 12 and 15" },
{ "enum": [ "BETWEEN_14_AND_17" ],
"title": "Between 14 and 17" } ],
string, required
api_languageAPI Return Language
"enum": [ "DE", "EN" ],
string, optional
test_credentialsAre these test credentials?boolean, optional

Example POST Call

POST /v1/connections/carriers/Hermes Germany

POST /v1/connections/carriers/hermes_germany HTTP/1.1
Content-Type: application/json
"nickname": "My Hermes Germany Account"

Example POST Response

Your account will now appear in your carriers list with an assigned carrier_id that you will specify when creating Hermes Germany shipments.

"carrier-id": "se-1234567"

Hermes Germany Service Details

ServiceCarrier CodeService API Codes
Hermes Package - StandardHhermes_package_standard
Hermes Package - Next DayH-nextDayhermes_package_next_day
Small Package - StandardSsmall_package_standard
Small Package - Next DayS-nextDaysmall_package_next_day
Medium Package - StandardMmedium_package_standard
Medium Package - Next DayM-nextDaymedium_package_next_day
Large Package - StandardLlarge_package_standard
Large Package - Next DayL-nextDaylarge_package_next_day
Extra Large Package - StandardXLextra_large_package_standard
Extra Large Package - Next DayXL-nextDayextra_large_package_next_day


NameAPI CodePackage Attributes
Bikehermes_germany_bikeInternational, Domestic
Baghermes_germany_bagInternational, Domestic
Large Itemhermes_germany_large_itemInternational, Domestic
Parcelhermes_germany_parcelInternational, Domestic

Return Services

Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Adding Shipment Insurance

Adding shipment insurance is not supported for this carrier.

Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

Advanced Options

To ensure you always have the most up-to-date information, use the List Carrier Advanced Options call.

You are now ready to create shipments using Hermes Germany via ShipEngine!