Setup Card (Reference)
The Hermes Setup Card is the central configuration page for the Hermes Shipment Connector. It is used to configure API credentials, sender address, default formats, and tracking options.
Opening the Page
- Search: Hermes Setup
- Alternatively: Via the merchantCENTRAL Shipment Provider Dashboard → Hermes → Setup
Fields
Group: General
| Field | Description |
|---|---|
| Environment | Selects between Sandbox (test) and Production (live). The API URL is automatically adjusted. |
| API Base URL | The base URL of the Hermes API. Automatically set based on the selected environment. Sandbox: https://api-sandbox.2mdc.de/, Production: https://api.2mdc.de/ |
| Partner ID | Your Hermes Partner ID. Sent as the sender identification during shipment creation. |
| Active | Enables or disables the connector. Shipments are only created when the connector is active. Requires a valid license (Demo or Full). |
Group: Credentials
| Field | Description |
|---|---|
| Client ID | The OAuth2 Client ID from the Hermes API portal. Click the field to enter or change the value. Status: Configured (green) or Not configured (red). |
| Client Secret | The OAuth2 Client Secret from the Hermes API portal. Click the field to enter or change the value. The stored value is never displayed in plain text. |
Security
Client ID and Client Secret are stored encrypted in the Credential Store (IsolatedStorage). They are not visible in the database and cannot be exported via RapidStart or configuration packages.
Group: Sender Address
The sender address is printed on all shipping labels as the sender.
| Field | Description |
|---|---|
| Sender Name | Name of the sender (company name). |
| Sender Street | Street name of the sender address. |
| Sender House No. | House number of the sender address. |
| Sender Post Code | Postal code of the sender. |
| Sender City | City of the sender. |
| Sender Country Code | ISO country code (e.g., DE for Germany). |
| Sender Email | Email address for notifications. |
| Sender Phone | Phone number for inquiries. |
Group: Default Settings
| Field | Description |
|---|---|
| Default Parcel Class | The preset parcel class for new shipments (S, M, L, XL, XXL). Can be overridden per shipment. |
| Default Product | The preset product for new shipments (PARCEL, PARCELSHOPDELIVERY, PROFIPAKET). |
| Label Format | The default print format for shipping labels (e.g., PDF A6, ZPL 100×150mm). |
| Retoure Label Format | The print format for return labels. Can differ from the shipping format. |
| Doc Format | The document format for outbound shipments (PDF or ZPL2). |
| Retoure Doc Format | The document format for return labels. Can differ from the shipping format. |
Format Combination
Typical configuration: Shipping labels as ZPL on the thermal printer (fast, professional) and return labels as PDF on the laser printer (to include in the parcel).
Group: Tracking
| Field | Description |
|---|---|
| Tracking Enabled | Enables automatic shipment tracking. When active, open shipments are periodically queried from the Hermes API. |
| Tracking Poll Interval (Min.) | The interval in minutes between automatic tracking queries. Recommended: 60–120 minutes. |
Group: License
| Field | Description |
|---|---|
| License Status | Shows the current license status: Active (green), Demo (yellow), Unregistered (red), Expired (red). |
Actions
Processing
| Action | Description |
|---|---|
| Test Connection | Tests the API connection with the configured credentials. Attempts to retrieve an OAuth2 token. On success: "Connection successful". On failure: "Connection failed" — check Client ID, Client Secret, and environment. |
License
| Action | Description |
|---|---|
| Register Demo | Starts the demo registration wizard for a free 30-day trial license. Company data is collected. |
| Refresh License | Queries the current license status from the license server and updates the display. |
Notes
Environment Switch
When switching environments (Sandbox ↔ Production), the API URL and credentials are not automatically transferred. Ensure you have the correct credentials configured for the respective environment.
Activation
The connector can only be activated when:
- At least a demo license has been registered
- Client ID and Client Secret are configured
- The sender address is fully filled in