Introductie

Shadow Booking is een functie die gebruikers in staat stelt om toegang te krijgen tot verzendgegevens in nShift Track zonder een zending te boeken via nShift Ship. Klanten kunnen zendingen aanmaken met als enig doel het ontvangen van retourgegevens en het gebruik van de nShift Track-functies. Deze functies omvatten het genereren van rapporten van alle zendingen en het gebruik van nShift Track als een status-only product. nShift Track biedt ook functionaliteiten zoals meldingen en het verrijken van zendingen met vervoerdergebeurtenissen, afhankelijk van de gebruikte vervoerder. 

Implementatie

Als een zending wordt gemarkeerd als een shadow-zending, zal nShift Ship deze direct doorsturen naar de verzonden sectie met de status 'verzonden'. Dit stelt het systeem in staat om alle logica die plaatsvindt tijdens het indienen en verzenden te omzeilen en voorkomt het activeren van API- of routeringsoproepen. Omdat zendingen direct in de database worden geïnjecteerd, zal er geen controlecijferberekening, prefix-toevoeging, etc. plaatsvinden. 

Met de methode POST ShadowShipments maakt u een kopie van een bestaande zending die buiten nShift is geboekt. Alle vervoerdervalidaties worden uitgeschakeld en er worden geen labels aangemaakt. 

Minimaal moet u het volgende aanleveren in het Data-object:

• Zendingnummer, pakketnummer, of beide.
• SubmitDate
• TransmitDate
• PickupDate 

Hoewel het bovenstaande voor sommige vervoerders voldoende is, is het meestal vereist om dezelfde gegevens te sturen als voor een volledige zending, inclusief de gebruikte service - zie informatie over het shipment data object hier. 

Verzoek

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

• ID - de id van de actor waarop het verzoek wordt uitgevoerd

Request body

De request body bevat een application/json-object met de volgende sleutels: data & options

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

Ga naar onze API-documentatie voor meer informatie en links naar de Postman-collectie en Swagger.

Ga naar het artikel over het Data Object.

Beperkingen

Om uw shadow-zendingen succesvol bij te werken met vervoerdergebeurtenissen, moet u de exacte informatie aanleveren die de vervoerder gebruikt om zendingen te koppelen in hun retourgegevens.

• U moet de correcte barcode aanleveren. Als de vervoerder pakketnummer of een andere waarde gebruikt voor gebeurtenissen, en u levert het zendingnummer aan, kunnen we de vervoerdergegevens niet koppelen aan uw zending. Houd er rekening mee dat vervoerders soms waarden toevoegen of barcodes zonder controlecijfers versturen. U moet exact hetzelfde barcodeformaat aanleveren als dat de vervoerder gebruikt voor gebeurtenissen. 
   
• Sommige vervoerders gebruiken andere parameters om zendingen te koppelen, zoals ordernummer, klantnummer of andere parameters. In deze gevallen moet u deze waarde sturen in het veld PortalBarcode1 (ReferenceKind 279) of PortalBarcode2 (ReferenceKind 280). Als u niet dezelfde parameter aanlevert als de vervoerder, kan nShift de vervoerdergebeurtenissen niet koppelen.
   
• Soms ontvangen klanten retourgegevens in formaten die niet door nShift worden ondersteund. Dit kan het geval zijn als een vervoerder alleen klant-specifieke retourgegevens in één formaat tegelijk levert. Klant-specifieke of oude formaten die door andere boek- en printsoftware worden gebruikt, worden mogelijk niet ondersteund door nShift, zelfs als de vervoerder deel uitmaakt van onze vervoerdersbibliotheek. Als de vervoerder niet in staat is om verschillende klant-specifieke formaten tegelijk te verzenden, moet de klant soms de retourgegevens doorsturen en dit kan mogelijk niet compatibel zijn met het platform van nShift. 

Als u nog verdere vragen heeft, aarzel dan niet om contact op te nemen met ons supportteam.