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

Property	Description	Type
`nickname`	This is a nickname for you to identify the carrier account in ShipEngine.	string, required
`username`	Username	string, required
`password`	Password	string, required
`pickup_window_slot`	Pickup Window "oneOf": [ { "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_language`	API Return Language "enum": [ "DE", "EN" ],	string, optional
`test_credentials`	Are these test credentials?	boolean, optional

Example POST Call

POST /v1/connections/carriers/Hermes Germany

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v1/connections/carriers/hermes_germany HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "nickname": "My Hermes Germany Account"
  "username":"YourUserName",
  "password":"pa55word",
  "pickup_window_slot":"your_pickup_window_slot_here",
  "api_language":"your_api_language_here",
  "test_credentials":"your_test_credentials_option_here",
}

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.

1
2
3
{
  "carrier-id": "se-1234567"
}

Hermes Germany Service Details

Service	Carrier Code	Service API Codes
Hermes Package - Standard	H	`hermes_package_standard`
Hermes Package - Next Day	H-nextDay	`hermes_package_next_day`
Small Package - Standard	S	`small_package_standard`
Small Package - Next Day	S-nextDay	`small_package_next_day`
Medium Package - Standard	M	`medium_package_standard`
Medium Package - Next Day	M-nextDay	`medium_package_next_day`
Large Package - Standard	L	`large_package_standard`
Large Package - Next Day	L-nextDay	`large_package_next_day`
Extra Large Package - Standard	XL	`extra_large_package_standard`
Extra Large Package - Next Day	XL-nextDay	`extra_large_package_next_day`

Packages

Name	API Code	Package Attributes
Bike	`hermes_germany_bike`	International, Domestic
Bag	`hermes_germany_bag`	International, Domestic
Large Item	`hermes_germany_large_item`	International, Domestic
Parcel	`hermes_germany_parcel`	International, 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!