> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/hermes/einrichtung.md).

# Einrichtung

Ziel ist eine Anmeldung an der vereinbarten Hermes-Umgebung. Sie benötigen **Hermes Administrator**, den freigegebenen Hermes-Zugang und vollständige Absenderdaten. Beginnen Sie mit der Integrationsumgebung und geeigneten Testdaten.

### Zugang und Verbindung

1. Öffnen Sie über die Suche **Hermes Einrichtung**.
2. Wählen Sie **Umgebung = Integration**. Kontrollieren Sie **Auth Basis-URL** `https://authme-int.myhermes.de` und **API Basis-URL** `https://de-api-int.hermesworld.com/services/hsi`. Die URLs und **Client ID** werden passend zur Umgebung vorgegeben und sind nicht bearbeitbar.
3. Wählen Sie das zu Ihrem Konto passende **Kundensegment**. Tragen Sie **Ressource Owner Username** und **Ressource Owner Password** ein. Verwenden Sie den mit solutioo vereinbarten **OAuth Grant Type**.
4. Hinterlegen Sie das von solutioo bereitgestellte Secret über **Vermittler-Secret setzen**. Kundenpasswort und Vermittler-Secret sind unterschiedliche Zugangsdaten.
5. Kontrollieren Sie **Kundenpasswort hinterlegt** und **Vermittler-Secret hinterlegt**. Die Eingabefelder werden nach der Übernahme geleert; das bedeutet nicht, dass die gespeicherten Werte fehlen.
6. Wählen Sie **Verbindung testen**. Bei erfolgreicher Anmeldung erscheint **Verbindung erfolgreich. Access Token wurde gespeichert.** Prüfen Sie **Token gültig bis**.

Die Anmeldung bestätigt den Tokenabruf. Ob Labels und einzelne Services für Ihr Konto verfügbar sind, prüfen Sie anschließend anhand des [Schnellstarts](/hermes/schnellstart.md).

### Versandvorgaben

1. Füllen Sie unter **Absender / Retourenempfänger** die Felder **Absender Name**, **Absender Straße**, **Absender Hausnr.**, **Absender PLZ**, **Absender Ort** und **Absender Land**. Prüfen Sie auch E-Mail und Telefon, wenn Sie Benachrichtigungen nutzen möchten.
2. Wählen Sie für den ersten Ablauf **Standard Label-Format = PDF** und die vereinbarte **Standard Produktart**.
3. Prüfen Sie **Standard Gewicht (g)** und **Standard Volumen (dl)**. Für Selfservice sind außerdem **Standard Paketklasse** und das Volumen relevant. Kontrollieren Sie die tatsächlich verwendeten Paketdaten vor jedem Labelauftrag. Die Paketklasse richtet sich nach den Außenmaßen der Verpackung und nicht nach dem Gewicht; Klasse und Volumen müssen zusammenpassen. Ein Deziliter entspricht 0,1 Litern.
4. Entscheiden Sie nach Ihrem Datenschutz- und Aufbewahrungsprozess über **API-Aufrufe protokollieren**. Anfrage und Antwort können personenbezogene Versanddaten enthalten. Eine automatische Aufbewahrungsfrist ist nicht eingerichtet.

### Umgebung wechseln und Fehler klären

Beim Umgebungswechsel werden die URLs angepasst und der Token-Cache geleert. Hinterlegen und prüfen Sie die für die neue Umgebung vorgesehenen Zugangsdaten. Nehmen Sie einen Wechsel auf **Produktion** erst nach Abstimmung und Freischaltung vor.

Wenn die Meldung **Vermittler-Secret fehlt. Lassen Sie es von einem Hermes-Administrator sicher in der Einrichtung hinterlegen.** erscheint, lassen Sie das Secret ergänzen. Ersetzen Sie es nicht durch Ihr Kundenpasswort. Bei anderen Anmeldefehlern prüfen Sie Umgebung, Segment und Zugang nach der [Fehlerhilfe](/hermes/uberwachung-und-fehlerbehebung.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.solutioo.de/hermes/einrichtung.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.