> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-lager/versender/gls.md). # GLS GLS in VARIO Cloud einrichten: Voraussetzungen, Versender und Versandart konfigurieren und Paketaufkleber direkt aus Belegen drucken. Mithilfe der **VARIO GLS-App** kannst Du eine direkte Verbindung zu GLS herstellen. Dadurch können beim Bearbeiten von Belegen direkt Paketaufkleber mit den entsprechenden **Paketeinstellungen** und den relevanten **Angaben aus dem Beleg** gedruckt werden. Um VARIO Cloud mit GLS zu verbinden, sind einige **vorbereitende Schritte** notwendig. Diese werden in den **folgenden Abschnitten** beschrieben. ## Voraussetzungen Um die GLS-Anbindung nutzen zu können, benötigst Du: * eine **Client ID**, ein **Client Secret** und eine **Contact ID** von GLS * die **VARIO-GLS-App**, die über das **Admin-Center** installiert werden kann. Eine Schritt-für-Schritt-Anleitung zur Installation von Apps findest Du [**hier.**](https://help.vario-software.de/vario-cloud-handbuch/system/apps/#Installation-von-Apps) {% stepper %} {% step %} ### Versender GLS einrichten Um Paketaufkleber von GLS automatisch für den Versand innerhalb von VARIO Cloud zu verwenden, muss zunächst einen **Versender** mit dem **Versendertyp “GLS App”** eingerichtet werden. Gehe dafür folgendermaßen vor: * Öffne den **Menüpunkt Einstellungen/Lager** und wechsele in den **Reiter “Versender”**. * Klicke auf den **Button “+Versender”**, um einen neuen Versender anzulegen. * Gib dem Versender eine **Bezeichnung** und wähle im **Feld “Versendertyp”** den Eintrag **“GLS App”** aus. Nach dem Erstellen öffnet sich automatisch die Detailansicht des Versenders.
* Trage im **Bereich** **"GLS** **Einstellungen"** die bei GLS eingeforderte **API-Zugangsdaten** für die **ShipIT-Farm-Schnittstelle** ein. Diese weichen von Deinen GLS-Portal-Logindaten ab. * **Client ID -** Die Client-ID Deines GLS-Schnittstellenzugangs. * **Client Secret** - Das zugehörige Client Secret. * **Contact ID** - Deine Kennung (*Shipper.ContactID*), die Dein GLS-Versenderkonto identifiziert. * Wenn auf dem Etikett eine andere Absenderanschrift erscheinen soll, aktiviere **Alternative Versandadresse** und fülle die Felder **Name**, **Landeskennzeichen**, **Stadt**, **Postleitzahl**, **Straße** und **Straßennummer** aus. Verwende einen zweistelligen Ländercode, zum Beispiel `DE`, und speichere die Einstellungen. {% hint style="warning" %} GLS muss die abweichende Absenderadresse für Deinen Account freischalten. Wende Dich dafür an Deinen GLS-Ansprechpartner. Ohne Freischaltung kann die Etikettenerstellung fehlschlagen. Die alternative Adresse ersetzt ausschließlich die Absenderangabe auf dem Etikett. **Abholung und Rücksendungen erfolgen weiterhin über die Adresse, die bei GLS zu Deiner Contact ID hinterlegt ist.** {% endhint %}
{% endstep %} {% step %} ### Versandart mit GLS anlegen Um den Versender mit GLS zu verwenden, muss dieser als nächstes mit einer **Versandart** verknüpft werden. Um eine **neue Versandart** mit dem entsprechenden Versender anzulegen, gehe folgendermaßen vor: * Innerhalb des **Menüpunkts Einstellungen/Lager** wechsele in den **Reiter “Lieferungsmodalitäten“**. * Klicke auf den **Button “+Versandart”** und fülle die benötigten Angaben aus. Im **Feld “Versender”** wähle den **zuvor angelegten Versender** mit der **GLS App** als **Versendertyp**.
* Mit einem Klick auf **Anlegen** öffnet sich automatisch die Detailansicht der Versandart. Über dem **Button “Bearbeiten”** kannst Du die Angaben nachträglich bearbeiten. * Durch die Anbindung an GLS stehen Dir im **Bereich “Verwaltung GLS”** zusätzliche Optionen zur Verfügung, darunter: * **Angaben zum Paket**, wie z. B. das Produkt, das Etikettenformat, Empfängerkategorie und Etikettenvorlage, * die verfügbaren **Services von GLS**, die je nach Bedarf über die Toggles aktiviert werden können
#### Etikettenformat und Vorlage einstellen 1. Öffne die gewünschte Versandart in den Einstellungen unter **Versandarten**. 2. Öffne **Verwaltung GLS** und aktiviere den Bearbeitungsmodus. 3. Wähle im Feld **Etikettenformat** das gewünschte Ausgabeformat. 4. Wähle, sofern das Feld angezeigt wird, eine **Etikettenvorlage (TemplateSet)** passend zu Deinem Drucker. 5. Speichere die Einstellungen. Die Auswahl der Etikettenvorlagen richtet sich nach dem Etikettenformat. Es werden nur Vorlagen angeboten, die die Anbindung für dieses Format zulässt. | Etikettenformat | Verfügbare Etikettenvorlagen | | --------------- | ------------------------------------------------------------- | | PDF | Keine manuelle Vorlagenauswahl; intern wird `NONE` verwendet. | | PNG | Keine manuelle Vorlagenauswahl; intern wird `NONE` verwendet. | | PNG\_200 | Keine manuelle Vorlagenauswahl; intern wird `NONE` verwendet. | | ZEBRA | Die unten aufgeführten ZPL-Vorlagen. | | INTERMEC | `PF_4_I`, `PF_4_I_200`, `PF_4_I_300`, `PF_8_D_200` | | DATAMAX | `D_200` | | TOSHIBA | `T_200_BF`, `T_300_BF` | Für **ZEBRA** stehen diese Vorlagen zur Verfügung: | Vorlagengruppe | Vorlagen | | -------------- | ----------------------------------------------------------------------------------------------------------------- | | ZPL\_200 | `ZPL_200`, `ZPL_200_TRACKID_EAN_128`, `ZPL_200_TRACKID_CODE_39`, `ZPL_200_REFNO_EAN_128`, `ZPL_200_REFNO_CODE_39` | | ZPL\_300 | `ZPL_300`, `ZPL_300_TRACKID_EAN_128`, `ZPL_300_TRACKID_CODE_39`, `ZPL_300_REFNO_EAN_128`, `ZPL_300_REFNO_CODE_39` | **Beim Formatwechsel:** Ist die bisherige Vorlage auch für das neue Format zulässig, bleibt sie ausgewählt. Andernfalls setzt VARIO Cloud die erste zulässige Vorlage des neuen Formats ein. Prüfe die Vorlage deshalb nach jedem Formatwechsel. Bei PDF, PNG und PNG\_200 wird das Vorlagenfeld ausgeblendet. #### Barcode für ZEBRA konfigurieren Die Felder zur Barcode-Konfiguration werden nur beim Etikettenformat **ZEBRA** angezeigt. 1. Wähle in **Verwaltung GLS** das Etikettenformat **ZEBRA** und die passende Etikettenvorlage. 2. Wähle im Feld **Barcode-Inhalt** den gewünschten Inhalt. 3. Wähle im anschließend angezeigten Pflichtfeld **Barcode-Typ** entweder **EAN-128** oder **Code 39**. 4. Speichere die Einstellungen. | Barcode-Inhalt | Bedeutung | | ------------------------ | ----------------------------------------------------------------------- | | Sendungsnummer (TrackID) | Übermittelt die Sendungsnummer als gewünschten Barcode-Inhalt an GLS. | | Sendungsreferenz | Übermittelt die Sendungsreferenz als gewünschten Barcode-Inhalt an GLS. | Der Barcode-Inhalt ist optional. Wenn Du die Auswahl im Feld **Barcode-Inhalt** entfernst, wird auch der Barcode-Typ gelöscht. Die Anbindung übermittelt dann keine eigene Barcode-Konfiguration an GLS. **Achtung beim Formatwechsel:** Wenn Du von ZEBRA zu einem anderen Etikettenformat wechselst, werden Barcode-Inhalt und Barcode-Typ gelöscht. Wenn Du später wieder ZEBRA auswählst, musst Du die gewünschten Barcode-Einstellungen erneut setzen. **Beispiel mit Sendungsnummer und Code 39** Wähle **ZEBRA** als Etikettenformat und eine für Deinen Drucker geeignete Vorlage. Wähle anschließend **Sendungsnummer (TrackID)** als Barcode-Inhalt und **Code 39** als Barcode-Typ. Speichere die Einstellungen und kontrolliere bei der nächsten vorgesehenen Etikettenerstellung das Ergebnis auf Deinem Drucker. #### Zusätzliche GLS Services aktivieren Unter **Verwaltung GLS** in der Versandart stehen zusätzlich folgende Schalter zur Verfügung: | Service | Einstellung | | ---------------------------- | --------------------------------------------------------------- | | Privatzustellung | Aktiviert den GLS-Service für Privatzustellung. | | Samstagszustellung bis 09:00 | Aktiviert den GLS-Service für Samstagszustellung bis 09:00 Uhr. | Aktiviere im Bearbeitungsmodus den gewünschten Service und speichere die Versandart. Für diese beiden Services sind keine zusätzlichen Eingabefelder erforderlich. Die Verfügbarkeit der GLS-Services hängt vom Versand- und Empfangsstandort ab. Ob die gewählten Services für eine konkrete Sendung verfügbar sind, wird bei der Erstellung der Sendung abschließend geprüft. Ein aktivierter Schalter allein bestätigt noch keine Verfügbarkeit. {% endstep %} {% step %} ### Paketaufkleber ausdrucken Jetzt, dass Du den Versender und die Versandart eingerichtet hast, kannst Du **von einem Beleg** **aus** direkt die entsprechende **Paketaufkleber ausdrucken**. Dazu stehen Dir nach dem Speichern eines **Lieferscheins** oder **Lieferschein/Rechnung** mit der entsprechende Versandart in der **Belegzusammenfassung** zwei Optionen zur Verfügung:
* **Paketaufkleber drucken**: Mit dieser Option wird der Paketaufkleber direkt mit den Einstellungen aus der Versandart gedruckt * **Paket erzeugen und bearbeiten**: Der Paketaufkleber kann noch nachträglich bearbeitet werden bevor er ausgedruckt wird. Die Bearbeitung wird im **Reiter “Sendungsübersicht”** des Belegs gespeichert und kann solange bearbeitet und gelöscht werden bis der Beleg veröffentlicht wurde. Weitere Informationen zur **Sendungsübersicht**. {% hint style="info" %} ## Paket stornieren Nach dem Erzeugen eines Pakets kannst Du es in der **Sendungsübersicht** wieder stornieren. Klicke dafür im **Bereich „Pakete“** auf das entsprechende Paket. Klicke unter **„Paketeinstellungen“** auf **„Paket intern stornieren“**. {% endhint %} {% endstep %} {% endstepper %} ## Etikettenablage und Fehlerbehebung Die von GLS zurückgegebenen Etiketten werden im Dokumentenmanagementsystem beim jeweiligen Paket abgelegt. Etiketten im Format **PNG\_200** erhalten dabei die Dateiendung **.png**. | Situation | Vorgehen | | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | Eine gewünschte Vorlage fehlt in der Auswahl. | Prüfe das Etikettenformat. Die Auswahl enthält nur die für dieses Format zulässigen Vorlagen. | | Für PDF oder PNG wird kein Vorlagenfeld angezeigt. | Das ist vorgesehen. Für PDF, PNG und PNG\_200 wird intern `NONE` verwendet. | | Nach der Auswahl eines Barcode-Inhalts lässt sich die Einstellung nicht speichern. | Prüfe, ob auch ein Barcode-Typ ausgewählt ist. Bei gewähltem Barcode-Inhalt ist er Pflicht. | | Die Barcode-Einstellungen sind nach einem Formatwechsel leer. | Wähle erneut ZEBRA und setze Barcode-Inhalt und Barcode-Typ neu. | | Die Etikettenerstellung mit alternativer Versandadresse schlägt fehl. | Prüfe die Vollständigkeit der Adresse und lasse die Freischaltung Deines Accounts durch GLS bestätigen. | | Ein aktivierter GLS-Service wird bei der Sendung abgelehnt. | Prüfe anhand der Fehlermeldung die Verfügbarkeit für den Versand- und Empfangsstandort. | | Die Meldung nennt eine unzulässige Kombination aus Format und Vorlage. | Öffne die Versandart, wähle das Etikettenformat erneut und kontrolliere die danach gesetzte Vorlage. Speichere die passende Kombination. | GLS-Fehlermeldungen aus den Antwort-Headern werden bei der Fehlerverarbeitung vorrangig berücksichtigt. Beachte bei einem Fehler den angezeigten Meldungstext. --- # 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://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-lager/versender/gls.md?ask=&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.