Introduksjon

Shadow Booking er en funksjon som lar brukere få tilgang til forsendelsesdata i nShift Track uten å booke en forsendelse gjennom nShift Ship. Kunder kan opprette forsendelser med det eneste formålet å motta returdata og få tilgang til nShift Track-funksjonene. Disse funksjonene inkluderer å generere rapporter over alle forsendelser og bruke nShift Track som et status- kun produkt. nShift Track tilbyr også funksjonalitet som varsler og berikelse av forsendelser med transportørhendelser, avhengig av hvilken transportør som brukes. 

Implementering

Hvis en forsendelse er merket som en shadow-forsendelse, vil nShift Ship sende den direkte til sendt-seksjonen med statusen overført. Dette gjør at systemet kan omgå all logikk som skjer under innsending og overføringsprosesser, og unngår å utløse API- eller rutingskall. Fordi forsendelser injiseres direkte i databasen, vil det ikke være noen sjekksifrekalkulasjon, prefiks-tillegg osv. 

Ved å bruke metoden POST ShadowShipments oppretter du en kopi av en eksisterende forsendelse booket utenfor nShift. Alle valideringer fra transportør vil være deaktivert, og ingen etiketter vil bli opprettet. 

Som et minimum må du oppgi følgende i Data-objektet:

• Forsendelsesnummer, pakkenummer eller begge deler.
• SubmitDate
• TransmitDate
• PickupDate 

Mens ovennevnte er tilstrekkelig for noen transportører, kreves det vanligvis at du sender samme data som trengs for en full forsendelse, inkludert tjenesten som brukes – se informasjon om forsendelsesdataobjektet her. 

Forespørsel

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

• ID – ID-en til aktøren forespørselen skal kjøres mot

Forespørselskropp

Forespørselskroppen tar et application/json-objekt med følgende nøkler: data & options

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

Gå til vår API-dokumentasjon for mer informasjon og lenker til Postman-samling og Swagger.

Gå til artikkelen om Data-objektet.

Begrensninger

For å kunne oppdatere dine shadow-forsendelser med transportørhendelser, må du oppgi nøyaktig den informasjonen transportøren bruker for å matche forsendelser i deres returdata.

• Du må oppgi riktig strekkode. Hvis transportøren bruker pakkenummer eller en annen verdi for hendelser, og du oppgir forsendelsesnummeret, vil vi ikke kunne matche transportørdata til din forsendelse. Merk at transportører noen ganger legger til verdier eller sender strekkoder uten sjekksiffer. Du må oppgi nøyaktig samme strekkodeformat som transportøren bruker for hendelser. 
   
• Noen transportører bruker andre parametere for å matche forsendelser, som ordrenummer, kontonummer eller andre parametere. I disse tilfellene må du sende denne verdien i feltet PortalBarcode1 (ReferenceKind 279) eller PortalBarcode2 (ReferenceKind 280). Hvis du ikke oppgir samme parameter som transportøren, vil ikke nShift kunne matche transportørhendelsene.
   
• Noen ganger mottar kunder returdata i formater som ikke støttes av nShift. Dette kan være tilfelle hvis en transportør kun leverer kundespesifikke returdata i ett format om gangen. Kundespesifikke eller gamle formater brukt av annen book- og print-programvare kan ikke støttes av nShift, selv om transportøren er en del av vår transportørbibliotek. Hvis transportøren ikke kan sende forskjellige kundespesifikke formater samtidig, må kunden noen ganger videresende returdataene, og dette kan være inkompatibelt med nShift sin plattform. 

Hvis du har flere spørsmål, ikke nøl med å kontakte vårt supportteam.