Hermes

Carrier-specific setup for Hermes in Shipping Labels.

Purpose

This page describes the Hermes-specific setup in Shipping Labels. It focuses on parcel class, output format, ZPL handling, and the separate authentication and shipping URLs that Hermes requires for test and productive operation.

Prerequisites

The shared Shipping Labels setup is complete.
The Hermes authentication and shipping URLs are created in the shared URL setup.
The required Hermes credentials are available for the productive environment.
The business scenario is clear about parcel class and output format.

Recommended sequence

Maintain the shared URL entries for Hermes authentication and shipping access.
Maintain the Hermes credentials for the relevant environment.
Choose parcel class and output format.
If ZPL is used, maintain the required resolution.
Validate the setup with the target output format and printer scenario.

Setup components

Treat authentication URL and shipping URL separately

Hermes uses separate URL concepts for authentication and the actual shipping service. These entries should be maintained explicitly in the shared URL setup before the Hermes line itself is completed.

Treat the authentication URL as the login or token endpoint and the shipping URL as the actual label service. Both entries must belong to the same environment; mixed test and live URLs create errors that are hard to diagnose.

Choose parcel class and output format deliberately

The main business choices in Hermes are the parcel class and the file format. The setup can generate PDF or ZPL, and the selected format should match the downstream printing process.

Choose the parcel class only from the Hermes-approved classes, typically XS to XL, and align it to the real shipment profile. If ZPL is chosen, the resolution becomes a technical required field; with PDF, that fine-grained setting has no practical effect.

Maintain credentials with environment awareness

The Hermes setup may require username, password, client ID, client secret, authentication URL, and main shipping URL for the respective environment. Keep these values consistent and avoid mixing productive and nonproductive entries.

Re-check the current onboarding information with Hermes

Confirm current credential availability and endpoint naming with Hermes before relying on older onboarding material.

Process Important Hermes notes Hermes setup is driven mainly by URL preparation, file format, and environment-specific credentials.

Create the required authentication and shipping URLs in the shared setup before the Hermes line is finalized.
Choose PDF or ZPL based on the real downstream print process.
Maintain ZPL resolution only when ZPL output is actually used.
Confirm current credential availability with Hermes if older onboarding material is inconsistent.