Einstellungen

DG-Transporte Einstellungen speichern die Zugangsdaten für DG Transporte und steuern, ob der Transportdienst DGTransporte im Versandprozess automatisch Labels erzeugen darf.

Formular öffnen und speichern

Die Einstellungsseite wird über den DG-Transporte-Unterpunkt Einstellungen geöffnet. Beim Öffnen legt das Backend fehlende Konfigurationswerte automatisch an, damit die Standardfelder im Formular vorhanden sind.

• Speichern: Übernimmt die Formularwerte in den Konfigurationsbereich dgtransporte und lädt den DG-Transporte-Bereich danach mit Setup-Bestätigung neu.
• Nicht gesetzte Checkbox: Wird labeldruck beim Speichern nicht übertragen, setzt das Backend den Wert ausdrücklich auf 0.
• Modulvoraussetzung: Die übergeordnete DG-Transporte-Seite wird nur ausgegeben, wenn die DG Transporte-App aktiv ist und die Rechteprüfung den Zugriff erlaubt.

Datenfilter und Tabellen

Diese Unterseite ist eine reine Konfigurationsmaske. Das Backend rendert hier keine Suchmaske, keinen DataFilter, keine Datentabelle und keine Optionsspalte.

• Keine Filter: Es gibt keine Suche, keine aktiven Filter, keine Reset-Funktion und keine Anwenden-Schaltfläche.
• Keine Tabelle: Spalten, Sortierung, Spaltenauswahl und Zeilenaktionen gehören nicht zu dieser Einstellungsmaske.
• Abgrenzung: Die DG-Transporte-Labeltabelle liegt auf der Unterseite Erzeugte Labels; technische Schnittstellenprotokolle liegen auf der Unterseite Logs.

Formularfelder

Das Backend erzeugt im Konfigurationsbereich dgtransporte genau die Standardwerte user_id, password und labeldruck. Weitere vorhandene Werte würden generisch als Eingabefeld ausgegeben, gehören aber nicht zu den aktuell installierten Standardfeldern.

• user_id (Benutzername): Benutzerkennung für den DG-Transporte-Login. Der Wert wird beim Anmelden an der DG-Transporte-Schnittstelle verwendet.
• password (Passwort): Passwort zum hinterlegten Zugang. Zusammen mit user_id wird daraus vor der Labelbuchung ein API-Schlüssel abgerufen.
• labeldruck (Bei Transportdienst DG Transporte - Labeldruck): Aktiviert die Labelerzeugung, wenn der Transportdienst DGTransporte gewählt ist.

Login und Labelbuchung

Beim Erzeugen eines Labels meldet sich das Backend mit Benutzername und Passwort an und verwendet den zurückgegebenen API-Schlüssel für die Buchung.

• API-Schlüssel: Wird vor der Buchung frisch aus den gespeicherten Zugangsdaten ermittelt und anschließend in den Buchungsauftrag übernommen.
• Buchungsdaten: Der Auftrag enthält Absender, Empfänger, Abholdatum, Gewicht und Warenwert aus Bestellung und Versandmaske.
• Fehlerfall: Meldet DG Transporte einen Fehler, übernimmt das Backend die Fehlermeldung und erzeugt kein Label.
• Protokollierung: Jede Buchung schreibt einen Tageslog mit Anfrage und Antwort. Die Logseite maskiert sensible Werte bei der Anzeige.

Labeldruck im Versandprozess

Der Schalter labeldruck entscheidet, ob DG-Transporte-Versandoptionen regulär für automatische Labelprozesse genutzt werden können.

• Aktiv: Die Versandliste kann DG-Transporte-Labels erzeugen, wenn das Modul aktiv ist und der Transportdienst DGTransporte lautet.
• Deaktiviert: Die Versandoptionen zeigen einen Hinweis, dass der DG-Transporte-Labeldruck ausgeschaltet ist.
• Manuelle Ticketerstellung: Einzelne manuelle Versandaktionen können mit eigener Steuerung aus der Bestellung heraus gestartet werden. Die eigentliche Ticketmaske nutzt trotzdem die gespeicherten Zugangsdaten.

Wirkung beim Ticket

Beim Erzeugen eines DG-Transporte-Tickets baut das Backend aus Bestellung, Absenderdaten und DG-Transporte-Zusatzfeldern einen Buchungsauftrag auf.

• abholdatum: Wird im DG-Transporte-Versandoptionsbereich auf den nächsten Tag vorbelegt und an DG Transporte übergeben.
• warenwert: Wird aus dem Brutto-Bestellwert vorbelegt und als Wert der Sendung verwendet.
• weight: Kommt aus den Versanddaten der Bestellung und wird für die Buchung normalisiert.
• Ergebnis: Bei erfolgreicher Buchung speichert das Backend Trackingnummer und PDF-Label in der allgemeinen Labeltabelle.