Käyttö StoreOrder-menetelmällä tilausten tallentamiseen tuontia varten – nShift Ship Help Center

StoreOrder-menetelmän tarkoituksena on pystyä tallentamaan virtuaalinen tilaus/toimitus pilveen ja käyttää tietoja uudelleen muissa nShift Ship -asennuksissa ilman, että kaikkia tietoja tarvitsee välittää muiden järjestelmien kautta.

StoreOrder-menetelmä on saatavilla Shipment Serverin kautta. Se tallentaa toimitustiedot JSON-muodossa, jotka voidaan myöhemmin tarvittaessa hakea. Ratkaisu on erityisen hyödyllinen, jos käytät ShipAdvisor 2.0:aa kassaratkaisussa ja tuotat toimituksia nShift On-premises -järjestelmän kautta, esim. Klarna-integraation kanssa. Tiedot voidaan sitten tuoda vaivattomasti käyttämällä OrderId:tä tuontitiedostossa.

Tässä artikkelissa opit seuraavista aiheista:

Käyttö ShipAdvisor 2.0:n kanssa
Käyttö nShift Checkoutin kanssa
Shipment Serverin pyyntö- ja vastausesimerkit
Asetukset nShift On-premises -järjestelmässä

Käyttötapaus - ShipAdvisor 2.0

Tässä osiossa kuvataan tyypillinen käyttötapaus StoreOrder-toiminnallisuudelle.

Olet asiakas, jolla on verkkokauppa ja kassaratkaisu, joka käyttää ShipAdvisor 2.0:aa:

Kuluttaja siirtyy verkkokauppasi kassalle. Yksi tai useampi GetShipAdvise-pyyntö lähetetään kassalta ShipAdvisor 2.0:aan. (ShipAdvisoria käytetään näyttämään toimitusvaihtoehtoja, toimitusaikoja, hintoja jne. Lue lisää).
Kun kuluttaja on suorittanut maksun, StoreOrder-pyyntö lähetetään Shipment Serverille tallentamaan tietoja tilauksesta OrderStorage-verkkopalveluun. Pyynnössä annetaan OrderId, ja suosittelemme luomaan GUID:n tätä tarkoitusta varten. Tallenna se tilaukseen ERP-/WMS-järjestelmässäsi, jotta voit myöhemmin tuoda sen nShift On-premises -järjestelmään. Jos käytät nShiftin Klarna-integraatiota prosessissasi, StoreOrder-pyyntö tapahtuu Klarna "vahvistus" -pyynnön yhteydessä.
Katso esimerkkipyyntö ja vastaus alla.
Tuontitiedostossa, joka lähetetään nShift On-premises -järjestelmään toimituksen tuottamista varten, on sisällytettävä clientId kenttään ShipAdvisor Reference->Reference. Tämä laukaisee tallennettujen tilaustietojen tuonnin nShift On-premises -järjestelmään. Huomaa, että tuontitiedoston tiedot ohittavat aina tallennetut tiedot. Jos sama kenttä on läsnä StoreOrder-menetelmällä tallennetuissa tiedoissa, se korvataan tuontitiedoston vastaavan kentän tiedoilla.

Esimerkki 1: StoreOrder-pyynnössä on vastaanottajan nimi 1 arvolla “John”. Tuontitiedoston vastaanottajan nimi 1 on “Bill” => toimituksessa käytetään “Bill”.

Esimerkki 2: StoreOrder-pyynnössä on vastaanottajan nimi 1 arvolla "John". Tuontitiedoston vastaanottajan nimi 1 on tyhjä => toimituksessa käytetään “John”.

Käyttö Delivery Checkoutin kanssa

Kun tallennat tilauksen Delivery Checkoutissa, annat tilaukselle prepareid:n. Tätä prepareid:tä käytetään tilauksen paikantamiseen nShift Shipissä. Katso esimerkkipyyntö toimitusten luomiseksi Delivery Checkoutista.

Siirry Delivery Checkoutin dokumentaatioon

Shipment Serverin pyyntö- ja vastausesimerkki

HTTP-menetelmä: POST

Sisältötyyppi: multipart/form-data.

Orderid vaihtoehdoissa tulisi olla jokin seuraavista:

- prepareid nShift Checkoutista

- tms_reference Klarna-integraatiosta

Esimerkkipyyntö: 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"
}

Vastaus:

Huom: Tavaralinjatiedot hallitaan usein varastossa. Siksi ei ole suositeltavaa tallentaa tavaralinjatietoja (Shipment.Lines) OrderStorageen. Näiden tallentaminen ja tavaralinjatietojen tuonti aiheuttaa kaksoiskappaleita toimituksen tavaralinjoissa.

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

“clientId” tulisi käyttää ShipAdvisor Import -asetuskohteessa; katso seuraava osio lisätietoja varten.

Suosittelemme, ettet tallenna lähettäjää ja linjoja OrderStorageen. OrderStorageen tallennetut linjat lisätään toimitukseen tavaralinjojen tuonnin yhteydessä.

Esimerkki:

Tallennat StoreOrderissa linjan, jossa on 1 paketti, 2 kg.
Pakkaamisen jälkeen ERP/WMS lähettää 1 paketin, 0,5 kg tuonnin kautta, jolloin toimituksessa on 2 pakettia, painot 2 kg ja 0,5 kg.

Tuontia käytettäessä sinun tulee antaa kuljetuskoodi, joka vastaa StoreOrderissa olevaa ProdCSid:tä.

Esimerkkipyyntö: 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
            }
         ]
      }
   ]
}

Asetukset nShift On-premises -järjestelmässä

Avaa nShift On-premises -järjestelmässä asetuskohde kohdasta Setup > ShipAdvisor Import.

Asiakas-ID ShipAdvisor 2 -välilehdellä tulisi olla sen toimijan asennustunnus, jota ShipAdvisor 2.0 käyttää.

Tuontiasetuksissasi sinun on sisällytettävä kenttä ShipAdvisor Reference->Reference ja käytettävä sitä sisällyttämään OrderId tuontitiedostoon.

Ship Help Center