Introduktion

Shadow booking är en funktion som tillåter användare att få tillgång till sändningsdata i nShift Track utan att boka en sändning via nShift Ship. Kunder kan skapa sändningar med det enda syftet att ta emot returdata och använda nShift Tracks funktioner. Dessa funktioner inkluderar att generera rapporter över alla sändningar och använda nShift Track som en statusendast-produkt. nShift Track erbjuder även funktioner som aviseringar och berikning av sändningar med transportörshändelser, beroende på vilken transportör som används. 

Implementering

Om en sändning markeras som en shadow-sändning, kommer nShift Ship att skicka den direkt till skickat-sektionen med statusen överförd. Detta gör att systemet kan kringgå all logik som sker under inskicknings- och överföringsprocesserna och undviker att utlösa API- eller routningsanrop. Eftersom sändningarna injiceras direkt i databasen kommer det inte att ske någon kontrollsiffra, prefixtillägg, etc. 

Genom att använda metoden POST ShadowShipments skapar du en kopia av en befintlig sändning bokad utanför nShift. Alla transportörsvalideringar kommer att inaktiveras och inga etiketter kommer att skapas. 

Som minimum måste du ange följande i Data-objektet:

• Sändningsnummer, paketnummer eller båda.
• SubmitDate
• TransmitDate
• PickupDate 

Även om ovanstående räcker för vissa transportörer, krävs det vanligtvis att skicka samma data som behövs för en fullständig sändning, inklusive den använda tjänsten – se information om sändningsdataobjektet här. 

Förfrågan

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

• ID – id för aktören som förfrågan ska köras mot

Begäransinnehåll

Begäransinnehållet tar ett application/json-objekt med följande nycklar: data & options

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

Gå till vår API-dokumentation för mer information och länkar till Postman-kollektion och Swagger.

Gå till artikeln om Data-objektet.

Begränsningar

För att framgångsrikt uppdatera dina shadow-sändningar med transportörshändelser måste du ange exakt den information som transportören använder för att matcha sändningar i deras returdata.

• Du måste ange korrekt streckkod. Om transportören använder paketnummer eller ett annat värde för händelser, och du anger sändningsnumret, kommer vi inte att kunna matcha transportörens data med din sändning. Observera att transportörer ibland lägger till värden eller skickar streckkoder utan kontrollsiffror. Du måste ange exakt samma streckkodformat som transportören använder för händelser. 
   
• Vissa transportörer använder andra parametrar för att matcha sändningar, såsom ordernummer, kontonummer eller andra parametrar. I dessa fall måste du skicka detta värde i fältet PortalBarcode1 (ReferenceKind 279) eller PortalBarcode2 (ReferenceKind 280). Om du inte anger samma parameter som transportören kommer nShift inte att kunna matcha transportörshändelserna.
   
• Ibland får kunder returdata i format som inte stöds av nShift. Detta kan vara fallet om en transportör endast tillhandahåller kundspecifik returdata i ett format åt gången. Kundspecifika eller gamla format som används av annan boknings- och utskriftsprogramvara kan sakna stöd i nShift, även om transportören ingår i vårt transportörsbibliotek. Om transportören inte kan skicka olika kundspecifika format samtidigt, måste kunden ibland vidarebefordra returdata, vilket kanske inte är kompatibelt med nShifts plattform. 

Om du har ytterligare frågor, tveka inte att kontakta vårt supportteam.