CargoLine

Carrierspezifische Einrichtung für CargoLine in Shipping Labels.

Zweck

Diese Seite beschreibt die CargoLine-spezifische Einrichtung in Shipping Labels. Nutzen Sie sie, nachdem die gemeinsame Einrichtung abgeschlossen ist, um den CargoLine-Produktkatalog, die Pakettypen, Zugangsdaten, URL-Zuordnungen und die Eigenschaften für Abholfenster, Labelausgabe und Fallback-Paketdaten zu pflegen.

Voraussetzungen

Die gemeinsame Shipping-Labels-Einrichtung ist abgeschlossen.
CargoLine-Test- oder Produktivendpunkte und das erforderliche Authentifizierungstoken liegen vor.
Der relevante Versandagent und Versandagentendienst sind bereits in Business Central gepflegt.
Artikelattribute für Maße und Gewicht sind möglichst gepflegt oder es steht eine Fallback-Paketdefinition in der Einrichtung zur Verfügung.

Empfohlene Reihenfolge

Legen Sie die CargoLine-Versandagentendienst-Kombination in der gemeinsamen Einrichtung an oder prüfen Sie diese.
Pflegen Sie die CargoLine-Produktliste und die Pakettypenliste.
Ordnen Sie die CargoLine-Test- oder Produktiv-URL sowie das Authentifizierungstoken zu.
Pflegen Sie Abholfenster, Labelgröße und Fallback-Paketeigenschaften.
Testen Sie eine realistische Labelanfrage mit vollständigen Paketdaten.

Einrichtungsbausteine

Zuerst Produkte und Pakettypen pflegen

CargoLine benötigt zwei Referenzkataloge, bevor die endgültige Einrichtungslinie verwendbar ist: die verfügbaren CargoLine-Produkte und die zulässigen Pakettypen. Diese Listen definieren, welche fachlichen Kombinationen später in der eigentlichen Einrichtung ausgewählt werden können.

Für die öffentliche Dokumentation ist die wichtigste Regel einfach: improvisieren Sie keine Produkt- oder Paketcodes. Verwenden Sie die vom Carrier gelieferten Werte und halten Sie Code, Name und Beschreibung konsistent zu den Informationen von CargoLine.

Wenn Artikelattribute bereits gepflegt sind, müssen in diesem Bereich in der Praxis vor allem Pakettypcode, Abholfenster und Labelgröße sauber gesetzt werden. Bei der Labelgröße steht A4 typischerweise für Ausdruck auf normalem Papier, während A6 auf ein klassisches Etikettendruckerszenario zielt.

Zugangsdaten und Endpunktzuordnung vervollständigen

CargoLine benötigt das Authentifizierungstoken sowie den korrekten Test- oder Produktivendpunkt. Diese technischen Werte sollten gepflegt sein, bevor Fachanwender den Dienst in Belegen verwenden.

Trennen Sie die Umgebungen sauber:

Test-URL für Validierung und Onboarding
Produktiv-URL für Live-Anfragen
Authentifizierungstoken für die jeweilige Umgebung

Abhol- und Ausgabeeigenschaften bewusst pflegen

Die Einrichtung enthält operative Eigenschaften, die die Anfrage direkt beeinflussen:

Abholung von
Abholung bis
Labelgröße, typischerweise A4 oder A6
Pakettypcode
Fallback-Länge, -Breite, -Höhe und -Gewicht

Diese Werte sind nicht nur kosmetisch. CargoLine erwartet Angaben zu Paketgrößen auch dann, wenn sie auf dem finalen Label nicht gedruckt werden.

Artikelattribute gegenüber Fallback-Werten bevorzugen

Wenn Artikelattribute für Maße und Gewicht vorhanden sind, übersteuern sie die Fallback-Paketeigenschaften der CargoLine-Einrichtung. Die Fallback-Werte sollten daher als Absicherung für Szenarien betrachtet werden, in denen keine artikelbezogenen Logistikdaten verfügbar sind.

Wenn weder Artikelattribute noch Einrichtungseigenschaften gültige Paketdaten liefern, kann die API-Anfrage fehlschlagen.

Process Wichtige CargoLine-Hinweise Diese Punkte vermeiden typische Einrichtungs- und Anfragefehler.

Pflegen Sie Produkt- und Pakettypenlisten, bevor die endgültige Einrichtungslinie in Belegen verwendet wird.
Halten Sie Test- und Produktiv-URL-Zuordnungen getrennt und prüfen Sie das Token gegen die richtige Umgebung.
Stellen Sie Paketmaße und Gewicht entweder über Artikelattribute oder über die CargoLine-Fallback-Eigenschaften bereit.
Verwenden Sie die vom Carrier gelieferten Einheiten und Produktcodes unverändert.
Testen Sie die Einrichtung erneut, wenn Labelgröße oder Abholfenster geändert werden.