Bruke StoreOrder for å lagre ordre for import – nShift Help Center

Formålet med StoreOrder-metoden er å kunne lagre en virtuell ordre/forsendelse i skyen og gjenbruke dataene i andre nShift Ship-installasjoner uten å måtte sende all data via andre systemer.

StoreOrder-metoden er tilgjengelig gjennom Shipment Server. Den lagrer forsendelsesdata som JSON, som deretter kan hentes senere ved behov. Løsningen er spesielt nyttig hvis du bruker ShipAdvisor 2.0 i en utsjekksløsning og produserer forsendelser via nShift On-premises, f.eks. har en Klarna-integrasjon. Data kan da importeres enkelt ved bruk av OrderId i importfilen.

Lær om følgende emner i denne artikkelen:

Bruk med ShipAdvisor 2.0
Bruk med nShift Checkout
Eksempler på forespørsler og svar fra Shipment Server
Oppsett i nShift On-premises

Brukstilfelle - ShipAdvisor 2.0

Denne seksjonen beskriver en typisk flyt for bruk av StoreOrder-funksjonaliteten.

Du er en kunde som har en nettbutikk og en utsjekksløsning som bruker ShipAdvisor 2.0:

En forbruker går til utsjekk i nettbutikken din. En eller flere GetShipAdvise-forespørsler sendes fra utsjekken til ShipAdvisor 2.0. (ShipAdvisor brukes for å vise fraktalternativer, leveringstider, priser, osv. Les mer).
Når forbrukeren har fullført betalingen, sendes en StoreOrder-forespørsel til Shipment Server for å lagre data om ordren i OrderStorage-webtjenesten. Du oppgir OrderId i forespørselen, og vi anbefaler å generere en GUID til dette formålet. Lagre den på ordren i ditt ERP/WMS slik at du kan importere den til nShift On-premises senere. Hvis du bruker nShifts Klarna-integrasjon i flyten din, skjer StoreOrder-forespørselen på Klarna "confirm"-forespørselen.
Se eksempel på forespørsel og svar nedenfor.
I importfilen som sendes til nShift On-premises for å produsere forsendelsen, må du inkludere clientId i feltet ShipAdvisor Reference->Reference. Dette vil utløse import av lagrede ordredata til nShift On-premises. Merk at data i importfilen alltid vil overstyre eventuelle lagrede data. Hvis samme felt finnes i dataene lagret med StoreOrder-metoden, vil det bli overskrevet av dataene i det tilsvarende feltet i importfilen.

Eksempel 1: StoreOrder-forespørselen har verdien “John” i Mottaker navn 1. Mottaker navn 1 i importfilen har verdien “Bill” => “Bill” vil bli brukt på forsendelsen.

Eksempel 2: StoreOrder-forespørselen har verdien "John" i Mottaker navn 1. Mottaker navn 1 i importfilen har ingen verdi => “John” vil bli brukt på forsendelsen.

Bruk med Delivery Checkout

Når du lagrer ordren i Delivery Checkout, tilordner du en prepareid til ordren. Denne prepareid brukes deretter for å finne ordren i nShift Ship. Se eksempel på forespørsel for å opprette forsendelser fra Delivery Checkout.

Gå til dokumentasjonen for Delivery Checkout

Eksempel på forespørsel og svar fra Shipment Server

HTTP-metode: POST

Content-Type: multipart/form-data.

Orderid i options bør være en av følgende:

- prepareid fra nShift Checkout

- tms_reference fra klarna

Eksempel på forespørsel: StoreOrder

{
  "data": {
    "Kind": 1,
    "Addresses": [
      {
        "Kind": 1,
        "Name1": "Test Name1",
        "Street1": "Test Address 1",
        "PostCode": "11825",
        "City": "Stockholm",
        "Phone": "004612341234",
        "Mobile": "004612341234",
        "Email": "noreply@dmain.com",
        "Attention": "Test Attention",
        "CountryCode": "SE"
      }
    ],
  },
  "options": {
    "OrderId": "9f8dc56b-5c33-4bfe-9d41-6a49a5f705cd"
    
  },
  "key": "sample",
  "actor": "1234",
  "command": "StoreOrder"
}

Svar:

Merk: Informasjon om varelinjer håndteres ofte i lageret. Det anbefales derfor ikke å lagre varelinjeinformasjon (Shipment.Lines) i OrderStorage. Å lagre dette og importere varelinjedata vil føre til dupliserte varelinjer på forsendelsen.

{
    "clientId": "3200123456",
    "orderGuid": "5e9dc1ae-d170-455e-8305-fd489b1e5ea3",
    "responseStatus": {
        "code": "Success",
        "messages": []
    }
}

“clientId” skal brukes i ShipAdvisor Import-oppsettpunktet; se neste seksjon for flere detaljer.

Vi anbefaler at du ikke lagrer avsender og linjer i OrderStorage. Linjer lagret i OrderStorage vil bli lagt til forsendelsen når varelinjer importeres.

Eksempel:

Du lagrer en linje i StoreOrder med 1 pakke, 2 kg.
Etter pakking sender ditt ERP/WMS 1 pakke, 0,5 kg gjennom Import, du vil da ende opp med 1 forsendelse med 2 pakker på 2 og 0,5 kg.

Når du bruker Import, må du oppgi en transportørkode som tilsvarer ProdCSid i StoreOrder.

Eksempel på forespørsel: SubmitShipment

{
   "Kind": 1,
   "ActorCSID": "1234",
   "OrderNo": "SomeOrderNumber",
   "ProdConceptID": 1782,
   "References": [
      {
         "Kind": 12,
         "Value": "SomeReference"
      }
   ],
   "Lines": [
      {
         "PkgWeight": 2000,
         "Height": "150",
         "Length": "150",
         "Width": "150",
         "References": [
            {
               "Kind": 23,
               "Value": "Hats"
            }
         ],
         "PkgVol": 0,
         "GoodsTypeKey1": "",
         "Pkgs": [
            {
               "ItemNo": 1
            }
         ]
      }
   ]
}

Oppsett i nShift On-premises

I nShift On-premises åpner du oppsettpunktet under Oppsett > ShipAdvisor Import.

Client ID under fanen ShipAdvisor 2 skal være installasjons-ID-en til aktøren som ShipAdvisor 2.0 bruker.

I ditt Importoppsett må du inkludere feltet ShipAdvisor Reference->Reference og bruke dette for å inkludere OrderId i importfilen din.

nShift Help Center