Introduktion
Shadow Booking er en funktion, der gør det muligt for brugere at få adgang til forsendelsesdata i nShift Track uden at booke en forsendelse gennem nShift Ship. Kunder kan oprette forsendelser med det eneste formål at modtage returdata og få adgang til nShift Track-funktionerne. Disse funktioner inkluderer generering af rapporter over alle forsendelser og brug af nShift Track som et status-only produkt. nShift Track tilbyder også funktionalitet som notifikationer og berigelse af forsendelser med transportørhændelser, afhængigt af hvilken transportør der benyttes.
Implementering
Hvis en forsendelse markeres som en shadow-forsendelse, sender nShift Ship den direkte til den sendte sektion med status som transmitteret. Dette gør det muligt for systemet at omgå al logik, der sker under indsendelses- og transmissionsprocesserne, og undgår at udløse API- eller routingkald. Fordi forsendelser indsættes direkte i databasen, vil der ikke være nogen kontrolcifrekalkulation, præfiks-tilføjelse osv.
Ved brug af metoden POST ShadowShipments opretter du en kopi af en eksisterende forsendelse booket uden for nShift. Alle transportørvalideringer vil være deaktiveret, og der vil ikke blive oprettet nogen labels.
Som minimum skal du angive følgende i Data-objektet:
- Forsendelsesnummer, pakkesnummer eller begge dele.
- SubmitDate
- TransmitDate
- PickupDate
Selvom ovenstående er tilstrækkeligt for nogle transportører, kræves det normalt at sende de samme data som for en fuld forsendelse, inklusive den anvendte service - se information om forsendelsesdataobjektet her.
Forespørgsel
POST {{URL}}/ShipServer/{{ID}}/ShadowShipments
- ID - id'et for aktøren, som forespørgslen skal køres imod
Request body
Request body skal være et application/json-objekt med følgende nøgler: data & options
{
"data": {},
"options": {}
}
Gå til vores API-dokumentation for mere information og links til Postman-samling og Swagger.
Gå til artiklen om Data-objektet.
Begrænsninger
For at kunne opdatere dine shadow-forsendelser med transportørhændelser skal du levere den nøjagtige information, som transportøren bruger til at matche forsendelser i deres returdata.
- Du skal angive den korrekte stregkode. Hvis transportøren bruger pakkesnummer eller en anden værdi til hændelser, og du angiver forsendelsesnummeret, vil vi ikke kunne matche transportørdata til din forsendelse. Bemærk, at transportører nogle gange tilføjer værdier eller sender stregkoder uden kontrolcifre. Du skal levere præcis det samme stregkodeformat, som transportøren bruger til hændelser.
- Nogle transportører bruger andre parametre til at matche forsendelser, såsom ordrenummer, kontonummer eller andre parametre. I disse tilfælde skal du sende denne værdi i feltet PortalBarcode1 (ReferenceKind 279) eller PortalBarcode2 (ReferenceKind 280). Hvis du ikke leverer den samme parameter som transportøren, vil nShift ikke kunne matche transportørhændelserne.
- Nogle gange modtager kunder returdata i formater, som ikke understøttes af nShift. Dette kan være tilfældet, hvis en transportør kun leverer kundespecifikke returdata i ét format ad gangen. Kundespecifikke eller gamle formater, der bruges af anden book og print-software, understøttes muligvis ikke af nShift, selvom transportøren er en del af vores transportørbibliotek. Hvis transportøren ikke er i stand til at sende forskellige kundespecifikke formater samtidig, kan kunden nogle gange være nødt til at videresende returdataene, og dette kan være inkompatibelt med nShifts platform.
Hvis du har yderligere spørgsmål, er du velkommen til at kontakte vores supportteam.