Einführung

Shadow Booking ist eine Funktion, die es Benutzern ermöglicht, Sendungsdaten in nShift Track abzurufen, ohne eine Sendung über nShift Ship zu buchen. Kunden können Sendungen mit dem alleinigen Zweck erstellen, Rückgabedaten zu erhalten und die Funktionen von nShift Track zu nutzen. Diese Funktionen umfassen das Erstellen von Berichten über alle Sendungen und die Verwendung von nShift Track als reines Statusprodukt. nShift Track bietet je nach verwendetem Spediteur auch Funktionen wie Benachrichtigungen und die Anreicherung von Sendungen mit Spediteurereignissen.

Implementierung

Wenn eine Sendung als Shadow-Sendung markiert ist, wird nShift Ship sie direkt mit dem Status „übermittelt“ in den Bereich „gesendet“ einstellen. Dies ermöglicht dem System, die gesamte Logik, die während der Übermittlungs- und Sendungsprozesse abläuft, zu umgehen und verhindert das Auslösen von API- oder Routing-Aufrufen. Da Sendungen direkt in die Datenbank eingefügt werden, erfolgt keine Prüfziffernberechnung, Präfixhinzufügung usw.

Mit der Methode POST ShadowShipments erstellen Sie eine Kopie einer bestehenden Sendung, die außerhalb von nShift gebucht wurde. Alle Spediteurprüfungen werden deaktiviert und es werden keine Etiketten erstellt.

Mindestens müssen Sie im Datenobjekt Folgendes angeben:

• Sendungsnummer, Paketnummer oder beides.
• SubmitDate
• TransmitDate
• PickupDate 

Während das Obige für einige Spediteure ausreichend ist, ist es üblicherweise erforderlich, dieselben Daten zu senden, die für eine vollständige Sendung benötigt werden, einschließlich des verwendeten Services – siehe Informationen zum Sendungsdatenobjekt hier. 

Anfrage

POST {{URL}}/ShipServer/{{ID}}/ShadowShipments 

• ID – die ID des Akteurs, gegen den die Anfrage ausgeführt wird

Anfragetext

Der Anfragetext erwartet ein application/json-Objekt mit den folgenden Schlüsseln: data & options

{ 
   "data": {}, 
   "options": {} 
}

Gehen Sie zu unserer API-Dokumentation für weitere Informationen sowie Links zur Postman-Sammlung und Swagger.

Gehen Sie zum Artikel über das Datenobjekt.

Einschränkungen

Um Ihre Shadow-Sendungen erfolgreich mit Spediteurereignissen zu aktualisieren, müssen Sie genau die Informationen angeben, die der Spediteur verwendet, um Sendungen in seinen Rückgabedaten abzugleichen.

• Sie müssen den korrekten Barcode angeben. Wenn der Spediteur für Ereignisse Paketnummer oder einen anderen Wert verwendet und Sie die Sendungsnummer angeben, können wir die Spediteur-Daten nicht mit Ihrer Sendung abgleichen. Beachten Sie, dass Spediteure manchmal Werte hinzufügen oder Barcodes ohne Prüfziffer senden. Sie müssen genau dasselbe Barcode-Format angeben, das der Spediteur für Ereignisse verwendet.
   
• Einige Spediteure verwenden andere Parameter, um Sendungen abzugleichen, wie Bestellnummer, Kontonummer oder andere Parameter. In diesen Fällen müssen Sie diesen Wert im Feld PortalBarcode1 (ReferenceKind 279) oder PortalBarcode2 (ReferenceKind 280) senden. Wenn Sie nicht denselben Parameter wie der Spediteur angeben, kann nShift die Spediteurereignisse nicht zuordnen.
   
• Manchmal erhalten Kunden Rückgabedaten in Formaten, die von nShift nicht unterstützt werden. Dies kann der Fall sein, wenn ein Spediteur kundenspezifische Rückgabedaten nur in einem Format gleichzeitig bereitstellt. Kundenspezifische oder alte Formate, die von anderer Buchungs- und Drucksoftware verwendet werden, werden möglicherweise von nShift nicht unterstützt, selbst wenn der Spediteur Teil unserer Spediteurbibliothek ist. Wenn der Spediteur nicht in der Lage ist, verschiedene kundenspezifische Formate gleichzeitig zu senden, muss der Kunde manchmal die Rückgabedaten weiterleiten, was möglicherweise nicht mit der Plattform von nShift kompatibel ist.

Wenn Sie weitere Fragen haben, zögern Sie bitte nicht, unser Support-Team zu kontaktieren.