DACHSER

Zweck

Diese Seite beschreibt die DACHSER-spezifische Einrichtung in Shipping Labels. Sie umfasst die Referenzlisten für Produkte, Niederlassungen und Pakettypen sowie die API-Schlüssel, Endpunkte, Divisionen, Depotauswahl und Fallback-Paketeigenschaften, die für produktive Labelanfragen benötigt werden.

Voraussetzungen

• Die gemeinsame Shipping-Labels-Einrichtung ist abgeschlossen.
• DACHSER-Test- und Produktivendpunkte liegen vor.
• Die erforderlichen API-Schlüssel für die jeweilige Umgebung sind verfügbar.
• Produkte, Niederlassungen und Pakettypen sind aus dem DACHSER-Onboarding bekannt.

Empfohlene Reihenfolge

1. Pflegen Sie die DACHSER-Produktliste.
2. Pflegen Sie die DACHSER-Niederlassungsliste und die Pakettypen.
3. Ordnen Sie Test- oder Produktivendpunkt sowie API-Schlüssel zu.
4. Wählen Sie Division, Depot, Produkt, Labelanzahl und Fallback-Paketeigenschaften.
5. Validieren Sie die Einrichtung zunächst im Testmodus und wechseln Sie erst zum Go-live in den Produktivmodus.

Einrichtungsbausteine

Zuerst die DACHSER-Referenzlisten aufbauen

DACHSER ist nicht nur eine Zugangsdaten-Einrichtung. Bevor die eigentliche Einrichtungslinie verwendbar wird, sollten die unterstützenden Listen für Produkte, Niederlassungen und Pakettypen gepflegt sein.

Diese Listen liefern die fachlichen Werte, die später in der endgültigen Einrichtung ausgewählt werden:

• Produkte mit DACHSER-Division und Produktidentität
• Niederlassungen mit Niederlassungsnummer, Organisation und Ort
• Pakettypen mit Code und Beschreibung

Für die Niederlassungsliste sollten Sie nur die von DACHSER veröffentlichten Werte verwenden. Die Niederlassungsnummer ist ein achtstelliger numerischer Wert und beginnt typischerweise mit führenden Nullen. Organisation und Ort gehören unverändert zu diesem Depotdatensatz. Bei CSV-Importen prüfen Sie Spaltenfolge und Zellformat sorgfältig; mehrzeilige Zellen oder ein unbedachtes Ersetzen bestehender Einträge können die laufende Einrichtung beeinträchtigen.

API-Zugang und Endpunktzuordnung vervollständigen

Pflegen Sie den DACHSER-API-Schlüssel zusammen mit der passenden Test- oder Produktiv-URL. Behandeln Sie dies als umgebungsspezifische Einrichtung und vermeiden Sie, Sandbox- und Live-Daten auf einer Linie zu mischen.

Wenn der Produktivmodus zu früh aktiviert wird, können Anfragen gegen die Live-Integration gesendet werden, bevor die fachlichen Werte vollständig validiert wurden.

Division, Depot und operative Eigenschaften bewusst wählen

Die eigentliche DACHSER-Einrichtung enthält die Werte, die steuern, wie die Anfrage interpretiert wird:

• Division wie Transport oder Food Logistics
• Depot- oder Speditionsauswahl
• Produktauswahl
• Anzahl der Labels
• Fallback-Paketmaße und -Gewicht

Diese fachlichen Felder sollten nur aus validierten Referenzdaten ausgewählt werden, nicht näherungsweise.

Die Division bildet DACHSER-interne Fachbereiche wie Transport oder Food Logistics ab. Auch das Depot beziehungsweise der Forwarder ist kein freier Beschreibungstext, sondern ein von DACHSER vorgegebener Niederlassungswert. Dieses Depot erscheint zwar nicht auf dem Label, ist für die interne Verarbeitung der Anfrage aber verpflichtend.

Niederlassungsnummern und Paketdaten konsistent halten

Die Behandlung der Niederlassungen ist bei DACHSER besonders sensibel. Niederlassungsnummern können führende Nullen enthalten und sollten exakt so gespeichert werden, wie sie geliefert wurden. Zusätzlich müssen Paketdaten weiterhin entweder über Artikelattribute oder über die DACHSER-Fallback-Eigenschaften bereitgestellt werden.

Wenn Artikelattribute für Länge, Breite, Höhe und Gewicht bereits gepflegt sind, muss in der Praxis mindestens noch der passende Pakettyp vollständig gesetzt sein. Wenn keine Artikelattribute vorhanden sind, pflegen Sie die Fallback-Eigenschaften auf der DACHSER-Einrichtung vollständig. Fehlen beide Quellen, führt die Anfrage zu Fehlern.