> 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/gls-connector/einrichtung.md).

# Einrichtung

Den Einrichtungsassistenten GLS Connector Einrichtung in fünf Schritten durchlaufen und die Verbindung zu GLS testen.

Der Assistent **GLS Connector Einrichtung** führt Sie in fünf Schritten durch die Grundeinrichtung. Danach ist der Mandant mit Ihrem GLS-Zugang verbunden und bereit für den ersten Testversand. Sie benötigen den Berechtigungssatz **GLS Super User**.

{% hint style="info" %}
Die Abbildungen vom 20.10.2026 zeigen unsere Demo-Sandbox mit GLS Connector 26.13.40.1015 auf Basis von 26.13.40. Zugangsdaten sind bereinigt; die Kontakt-ID ist geschwärzt. Je nach Fenstergröße kann die Anordnung bei Ihnen abweichen.
{% endhint %}

## Assistent öffnen

* Suchen Sie nach **Unterstützte Einrichtung** und wählen Sie **GLS Connector einrichten**, oder
* öffnen Sie **GLS Etiketten-Konfiguration** und wählen Sie die Aktion **Unterstützte Einrichtung**.

Mit **Weiter** und **Zurück** wechseln Sie zwischen den Schritten. Wenn nicht alle Felder sichtbar sind, scrollen Sie innerhalb des Assistenten nach unten. Über die Suche (Alt+Q) erreichen Sie ihn auch direkt mit **GLS Connector Einrichtung**.

## Die fünf Schritte

{% stepper %}
{% step %}

#### Willkommen beim GLS Connector

Der Assistent erklärt, was eingerichtet wird. Halten Sie Ihre GLS-Zugangsdaten bereit.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F16RorsJAapm1IJXPnC8k%2Fgls-einrichtung-20261020-01-assistent-willkommen.png?alt=media" alt="Willkommensseite des GLS-Connector-Assistenten mit der Schaltfläche „Weiter“."><figcaption><p>Der Assistent beginnt mit der Seite „Willkommen beim GLS Connector“. Klicken Sie auf „Weiter“, um zu beginnen.</p></figcaption></figure>
{% endstep %}

{% step %}

#### API-Verbindung

1. Wählen Sie im Feld **Umgebung** zuerst die Sandbox. Die **API Basis-URL** wird passend zur Umgebung gesetzt.
2. Tragen Sie **Client-ID**, **Client-Geheimnis** und **Kontakt-ID** aus Ihrem GLS-Sandbox-Zugang ein.
3. Wählen Sie **Verbindung testen**.

**Verbindung testen** speichert Ihre Eingaben und versucht anschließend eine Anmeldung bei GLS. Es wird kein Etikett und keine Sendung erzeugt. Die Aktion ist nur in diesem Schritt sichtbar.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2Fv3ilAvnA2dp1a59LJkAG%2Fgls-einrichtung-20261020-02-api-verbindung.png?alt=media" alt="Seite API-Verbindung mit Umgebung Sandbox, API Basis-URL, leeren Feldern Client-ID und Client-Geheimnis sowie geschwärzter Kontakt-ID."><figcaption><p>Tragen Sie auf der Seite „API-Verbindung“ Ihre eigenen Zugangsdaten ein. In der Aufnahme sind Client-ID und Client-Geheimnis leer und die Kontakt-ID ist geschwärzt.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Alternative Versenderadresse

Optional erfassen Sie eine abweichende Versenderadresse: **Name**/**Name 2**, **Straße**/**Hausnr.**, **PLZ**/**Ort**/**Ländercode** sowie **E-Mail**/**Telefonnr.** Nutzen Sie diesen Schritt, wenn Ihre Ware nicht von der Firmenadresse aus verschickt wird.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FhMPoNms9wxhMCN80ASTB%2Fgls-einrichtung-20261020-03-versenderadresse.png?alt=media" alt="Oberer Bereich der optionalen alternativen Versenderadresse mit leeren Eingabefeldern für Name und Anschrift."><figcaption><p>Erfassen Sie bei Bedarf Name und Anschrift Ihrer alternativen Versenderadresse. Die Aufnahme zeigt leere Eingabefelder.</p></figcaption></figure>

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FiTPBW48ggbkdWXhzUbGk%2Fgls-einrichtung-20261020-03b-versender-kontakt.png?alt=media" alt="Nach unten gescrollter Adressbereich mit leeren Feldern für Ländercode, E-Mail und Telefonnr."><figcaption><p>Scrollen Sie nach unten, um Ländercode, E-Mail und Telefonnr. anzugeben. In der Aufnahme sind alle Felder leer.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Etikettenoptionen und Funktionen

Wählen Sie **Etikettenformat** (PDF, PNG oder Zebra), **Vorlagensatz** sowie Standardprodukt und -service. Aktivieren Sie nur Funktionen, die Ihr GLS-Vertrag tatsächlich abdeckt, zum Beispiel **Gefahrgut aktivieren**, **Retouren aktivieren** oder **Abholung aktivieren**. Die Schalter stehen unter **Optionale Funktionen**.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2Fhn22HcTvFjqnQ3unDkzA%2Fgls-einrichtung-20261020-04-etiketten-und-funktionen.png?alt=media" alt="Etiketteneinstellungen mit den Beispielwerten PNG und NONE, Standardprodukt Parcel und Standardservice Kein."><figcaption><p>Legen Sie die Etiketteneinstellungen sowie Standardprodukt und Standardservice fest. Die gezeigten Werte PNG, NONE, Parcel und Kein sind nur ein Beispiel.</p></figcaption></figure>

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2F8mtLLYqEaBD5vcNRSXTA%2Fgls-einrichtung-20261020-04b-optionale-funktionen.png?alt=media" alt="Bereich Optionale Funktionen mit Schaltern für ShopDelivery, Retouren, Abholung, Gefahrgut, Internationaler Versand und Direktversand."><figcaption><p>Scrollen Sie zum Bereich „Optionale Funktionen“, um einzelne Funktionen ein- oder auszuschalten. Die Schalter ersetzen keine vertragliche Freigabe durch GLS.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Alles erledigt!

Mit **Fertigstellen** speichern Sie die Einrichtung. Die unterstützte Einrichtung wird als abgeschlossen markiert.

<figure><img src="https://2941164653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2zeHzYeLtNZxQTFlgpC%2Fuploads%2FdxW7U92sm3mx9zcZnN19%2Fgls-einrichtung-20261020-05-assistent-abschluss.png?alt=media" alt="Letzte Seite des Assistenten mit der Meldung „Alles erledigt!“ und der Schaltfläche „Fertigstellen“."><figcaption><p>Auf der letzten Seite steht „Alles erledigt!“. Mit „Fertigstellen“ speichern Sie Ihre Einstellungen und schließen den Assistenten ab.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Ergebnis prüfen

* Der Verbindungstest war erfolgreich.
* In **GLS Etiketten-Konfiguration** stehen Umgebung, Etikettenformat und Standardprodukt wie gewählt.
* In der **Unterstützten Einrichtung** ist **GLS Connector einrichten** als erledigt gekennzeichnet.

## Wenn der Verbindungstest fehlschlägt

1. Prüfen Sie, ob die Zugangsdaten zur gewählten Umgebung gehören. Sandbox-Daten funktionieren nicht in Produktion und umgekehrt.
2. Prüfen Sie Client-ID und Client-Geheimnis auf Leerzeichen am Anfang oder Ende.
3. Prüfen Sie die HTTP-Freigabe in den Erweiterungseinstellungen. Falls im **API-Aufrufprotokoll** ein passender Eintrag vorhanden ist, lesen Sie die Rückmeldung von GLS.
4. Wenden Sie sich bei weiter bestehenden Anmeldefehlern an GLS, um den Zugang bestätigen zu lassen.

## Sandbox, Produktion und gespeicherte Zugangsdaten

* Verwenden Sie für Sandbox und Produktion **getrennte GLS-Zugänge**.
* Beim Wechsel der Umgebung setzt die App die passende API-Adresse und warnt, dass bisherige Zugangsdaten weiterverwendet würden.
* **Leere Eingaben bei Client-ID oder Client-Geheimnis behalten die bisher gespeicherten Werte.** Tragen Sie nach einem Umgebungswechsel deshalb immer die neuen Werte ein.
* Zugangsdaten werden pro Mandant in einem geschützten Speicher der App abgelegt.

## Weiter in der Einrichtung

* [Feldreferenz der Einrichtung](https://docs.solutioo.de/gls-connector/einrichtung/feldreferenz.md): die wichtigsten Felder der Konfiguration
* [Kartons und Artikel vorbereiten](https://docs.solutioo.de/gls-connector/einrichtung/kartons-und-artikel.md): Voraussetzung für sinnvolle Pakete
* [Tarife und Versandkosten](https://docs.solutioo.de/gls-connector/einrichtung/tarife.md): optional, für lokale Versandkostenberechnung

Danach: [Schnellstart](https://docs.solutioo.de/gls-connector/schnellstart.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/gls-connector/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.
