Bei der Integration eines neuen Frachtführers, wie DHL, UPS oder FedEx, in nShift Ship stellt sich häufig die Frage, welche Felder ausgefüllt werden müssen, um eine Sendung erfolgreich zu buchen. Die Antwort ist jedoch nicht allgemeingültig.
Abschnitte in diesem Artikel:
- Frachtführer- und kundenspezifische Anforderungen
- Empfohlene Vorgehensweise für Shipment Server API-Kunden
- Empfohlene Vorgehensweise für On-premises-Kunden
- Fehlermeldungen von API-Frachtführern verstehen
- nShift Customer Service kontaktieren
Frachtführer- und kundenspezifische Anforderungen
Jeder Frachtführer hat eigene Spezifikationen, und die Anforderungen können je nach Folgendem variieren:
- Dem Service-Typ des Frachtführers (z. B. Express, Economy, Gefahrgut)
- Der Art der Sendung (z. B. national vs. international, erforderliche Zolldokumentation, spezielle Zusatzleistungen wie "Saturday Delivery", "Heavy", "Parcel Shop")
- Ihrer individuellen Geschäftsstruktur und Ihren Präferenzen
Aufgrund dieser Variabilität gibt es keine einheitliche Spezifikation, die für alle Kunden oder Frachtführer gilt.
Empfohlene Vorgehensweise für Shipment Server API-Kunden
Um festzustellen, welche Felder für Ihre spezielle Einrichtung erforderlich sind, empfehlen wir die Verwendung des nShift Portal mit aktiviertem Developer Tools. Dies ermöglicht es Ihnen, eine Sendung zu testen und in Echtzeit zu beobachten, welche Felder obligatorisch sind.
- Melden Sie sich beim nShift Portal an und gehen Sie zu Ship > Configuration > Settings.
- Scrollen Sie nach unten und aktivieren Sie Show developer tools unter der Überschrift New Booking.
- Sie haben jetzt Zugriff auf die Developer Tools am unteren Rand aller relevanten Seiten unter New.
- Gehen Sie zu New und erstellen Sie eine Sendung mit dem neuen Frachtführer und den neuen Services. Wenn Sie auf die Schaltfläche Print klicken, sehen Sie einen Validation Bildschirm, wenn Informationen fehlen.
Beispiel:
Note: Einige Validierungsmeldungen kommen direkt von der API des Frachtführers und können schwerer zu interpretieren sein (siehe den Abschnitt zu API-Frachtführern für weitere Informationen).
- Das Feld Data im Abschnitt Developer Tools spiegelt alle Daten wider, die Sie eingegeben haben, und zeigt Ihnen, wie die Anfrage an die Shipment Server API aussieht,
including all the fields you have filled in.
Füllen Sie alle fehlenden Informationen aus, bis Sie ein Label erhalten. Sie wissen nun, welche Felder für Ihren spezifischen Carrier und Geschäftsablauf gemappt werden müssen.
Empfohlene weiterführende Lektüre:
- Inspect the data object with the Developer Tools - erklärt, wie Sie die vollständige Payload für jede von Ihnen erstellte Sendung abrufen können.
- Using Customs Details (Paperless invoice) - erklärt die Verwendung der Felder für Zolldaten für papierlose Rechnungen und gibt einen Überblick über die am häufigsten benötigten Felder.
Empfohlene Vorgehensweise für On‑premises‑Kunden
- Gehen Sie zu Main >Production und erstellen Sie eine manuelle Testsendung mit Ihrem neuen Frachtführer und den relevanten Services.
- Bewegen Sie den Mauszeiger über die Schaltfläche Print , um alle fehlenden Daten gemäß den in Ship implementierten Validierungen zu sehen. Wenn Sie auf die Schaltfläche Print klicken, informiert Sie ein Dialogfenster, falls Pflichtangaben fehlen, einschließlich Fehlermeldungen, die direkt von der API des Frachtführers kommen. (Weitere Informationen finden Sie im Abschnitt zu API-Frachtführern).
Beispiel:
-
Füllen Sie alle fehlenden Daten aus, bis Sie ein Label erhalten.
Fehlermeldungen von API-Frachtführern verstehen
Wenn Sie Sendungen über API-verbundene Frachtführer buchen, können in unserer Software gelegentlich Fehlermeldungen auftreten. Bitte beachten Sie, dass diese Meldungen direkt vom System des Frachtführers und nicht von nShift erzeugt werden. Sie spiegeln daher die aktuellen Anforderungen und Validierungen des Frachtführers wider, die außerhalb unseres Einflussbereichs liegen.
Die Anforderungen der Frachtführer und deren Fehlermeldungen werden regelmäßig aktualisiert und können sich ohne Vorankündigung ändern. Wenn Sie eine Fehlermeldung erhalten, die unklar oder schwer zu interpretieren ist, empfehlen wir, sich an unser Customer Service Team zu wenden. Wir können Sie unterstützen, indem wir den Frachtführer in Ihrem Namen kontaktieren, um das Problem zu klären und dabei zu helfen zu identifizieren, welche Informationen eventuell fehlen oder falsch formatiert sind.
nShift Customer Service kontaktieren
Wenn Sie Probleme haben, eine Sendung erfolgreich zu erstellen, senden Sie bitte eine Anfrage an nShift Customer Service, der Ihnen gerne weiterhilft.
Teilen Sie uns Folgendes mit:
- Name des Frachtführers, product/services und Zusatzservices.
- Die Fehlermeldung, die Sie erhalten – ein Screenshot kann die Fehlerbehebung beschleunigen.
- Eine Correlation ID oder Bestellnummer ist ebenfalls hilfreich.
Mit diesen Informationen können wir Ihnen helfen herauszufinden, welche Daten in Ihrer Sendung fehlen.