Einstellungen

Die GLS-Einstellungen steuern Contact-ID, Zugangsdaten, API-Endpunkt, Kontaktuebermittlung und automatischen Labeldruck fuer GLS-Versandlabels.

Zweck und Voraussetzungen

Das Formular speichert die Konfiguration fuer den Transportdienst GLS. Die Werte werden beim Erzeugen und Stornieren von GLS-Labels verwendet, sofern die GLS-App aktiv ist und eine Versandart den Transportdienst GLS nutzt.

• Beim Aufruf des GLS-Bereichs legt das Backend fehlende GLS-Konfigurationswerte automatisch an.
• Alle aktuell installierten GLS-Konfigurationswerte werden im Formular angezeigt. Das Formular blendet keine Token- oder OAuth-Felder aus.
• Nach dem Speichern wird die Einstellungsseite erneut geoeffnet und zeigt bei erfolgreichem Speichern eine Erfolgsmeldung.

Zugang und Endpunkt

• 0_contact_id: GLS-Contact-ID fuer den Absender. Beim Erzeugen eines Labels setzt das Backend diesen Wert als Shipper-Contact-ID.
• 10_username: Benutzername fuer den GLS-Zugang. Zusammen mit dem Passwort wird daraus der Basic-Authorization-Header fuer GLS-Anfragen gebildet.
• 20_password: Passwort fuer den GLS-Zugang. Der Wert wird nicht einzeln an die Labeldaten geschrieben, sondern fuer die Authentifizierung der REST-Anfrage verwendet.
• 30_endpoint: Basis-Endpunkt der GLS-Schnittstelle. Labelerstellung, Storno und Paketshop-Suche nutzen diesen Endpunkt als Zielbasis.

Kontaktuebermittlung

• 40_use_notification: Radio-Auswahl fuer die Uebermittlung der Kunden-E-Mail an GLS.
• ja: Die E-Mail-Adresse wird beim Labelaufbau an GLS uebergeben.
• nein: Die E-Mail-Adresse wird nicht wegen dieser Einstellung uebergeben.
• je nach Zustimmung des Kunden: Die E-Mail-Adresse wird nur uebergeben, wenn in der Bestellung die passende Zustimmung vorhanden ist.
• Ausnahmen: Bei FlexDelivery oder Paketshop-Zustellung uebergibt die Versandlogik die E-Mail-Adresse ebenfalls, weil diese Services eine Benachrichtigung benoetigen koennen.

Automatischer Labeldruck

• labeldruck: Checkbox fuer den GLS-Labeldruck bei Versandarten mit Transportdienst GLS.
• Wenn die Checkbox beim Speichern nicht im Formularpost enthalten ist, setzt das Backend den Wert auf 0.
• Ist der Labeldruck deaktiviert, zeigt die Versandoption nur einen Hinweis, dass GLS-Labeldruck deaktiviert ist. Die eigentlichen GLS-Versandoptionen werden dann nicht angezeigt, solange keine Sonderlogik den Check ausdruecklich ignoriert.
• Ist der Labeldruck aktiv, koennen im Versandprozess GLS-Optionen wie FlexDelivery, Letterbox, Guaranteed24, Tyre, Nachnahme, Express, Paketshop und Retoure in die Labeldaten einfließen.

Auswirkung auf Label und Storno

• Beim Erzeugen eines Labels verwendet das Backend Bestellnummer, Empfaengeradresse, Paketgewicht, Contact-ID und die ausgewaehlten GLS-Services.
• Express-Auswahl aendert das Produkt von Paket auf Express und setzt den gewaehlten Express-Service.
• Nachnahme setzt Betrag, Grund und Waehrung in den ShipmentUnit-Services.
• Paketshop-Zustellung sucht vorher passende Paketshops zur Lieferadresse und speichert die ausgewaehlte Paketshop-ID im Service.
• Die erfolgreiche GLS-Antwort liefert Track-ID und PDF-Labeldaten. Diese werden als Versandlabel gespeichert.
• Die Stornoaktion der Label-Unterseite verwendet die gespeicherte Ticketnummer und ruft die GLS-Stornofunktion auf.

Speichern

1. Contact-ID, Benutzername, Passwort und API-Endpunkt eintragen oder pruefen.
2. Kontaktuebermittlung passend zur Versand- und Datenschutzlogik waehlen.
3. Labeldruck aktivieren, wenn GLS-Labels im Versandprozess erstellt werden sollen.
4. Mit dem Standard-Speichern-Button sichern.
5. Nach dem Speichern eine Testsendung oder eine kontrollierte Labelerstellung durchfuehren und bei Fehlern die GLS-Logs pruefen.