Kun asiakas suorittaa checkoutin, voit luoda partial shipment -lähetyksen nShift Checkoutissa. Osittainen lähetys sisältää toimitusvalinnan (kuljetusliike/palvelu, noutopiste jne.), mutta se täytyy vielä viimeistellä (varata) nShift Shipissä, jotta saadaan lähetysnumero ja tulostettavat osoitelaput.

Yleiskatsaus

Tämä on tyypillinen päästä päähän -prosessi:

1. Luo osittainen lähetys Checkoutissa (Checkout API). 
2. Varaa lähetys nShift Shipissä käyttämällä Post Shipment ‑pyyntöä etikettien ja lähetysumeron luomiseksi.

Vaihe 1: Luo osittainen lähetys Checkoutissa

Kun asiakas on valinnut toimitustavan, luo osittainen lähetys Checkout API -dokumentaation avulla: Create Partial Shipment.

Tärkeää: Varmista, että tallennat tunnisteen, jota käytät myöhemmin tilauksen/lähetyksen hakemiseen. Tämä on yleensä orderID.
 

Vaihe 3: Viimeistele lähetys varaamalla se nShift Shipissä

Osittaisen lähetyksen viimeistelemiseksi varaa se käyttämällä Post Shipment -menetelmää Ship API:ssa. Tämä luo/varaa lähetyksen ja palauttaa osoitelapun. 
 

Mitä sinun tulee sisällyttää onnistuneeseen varaukseen

Varattu lähetys vaatii täydellisen lähetyksen “data object” -rakenteen (vastaanottaja, kuljetusliikkeen tuote/palvelu, paketit/painot jne.). Seuraavat tiedot vaaditaan, mutta vain ne tiedot, joita ei ole mukana osittaisessa lähetyksessä, tarvitaan lähetyksen viimeistelyyn. Käytännössä osittainen lähetys (Checkoutista) ei yleensä sisällä kaikkea tarvittavaa tietoa varauksen viimeistelyyn.

• OrderID: lisätään Options-osioon, hakee tiedot Checkoutin osittaisesta lähetyksestä
• Carrier service: ProdConceptID
• Order number: OrderNo
• Addresses: vastaanottaja (Kind: 1) ja lähettäjä (Kind: 2)
• Packages / lines: esimerkiksi painot/mitat kohdassa Lines
• Goodstypes: vaaditaan joillakin kuljetusliikkeillä
• Label format options: esimerkiksi "Labels": "ZPLGK"
• Customs details: tarvitaan tullirajojen ylittävissä lähetyksissä

Jokaisella kuljetusliikkeellä on omat vaatimuksensa - lue lisää täältä: Vaadittujen kenttien tunnistaminen lähetysten varaamisessa

Lisätietoja lähetyksen varaamisesta löytyy täältä: How to - Book a Shipment

Esimerkkipyyntö (yksi paketti)

Tämä esimerkki näyttää lähetyksen, joka sisältää osoitetiedot. Yleensä osoitetiedot ovat osa Checkoutin osittaista lähetystä eikä niitä tarvita, mutta jotkin kuljetusliikkeet saattavat vaatia lisätietoja.

curl -s -X POST "{{URL}}/ShipServer/{{ACTOR_ID}}/Shipments" \
  -H "Authorization: {{TOKEN}}" \
  -H "Content-Type: application/json" \
  --data-raw "{
    \"data\": {
      \"OrderNo\": \"Test Shipment 1\",
      \"Addresses\": [{
        \"Kind\": 1,
        \"Name1\": \"Test Receiver Name1\",
        \"Street1\": \"Test Road 1\",
        \"PostCode\": 7400,
        \"City\": \"Herning\",
        \"CountryCode\": \"DK\",
        \"Phone\": \"12341234\",
        \"Mobile\": \"12341234\",
        \"Email\": \"noreply@nshift.com\",
        \"Attention\": \"Test Attention\"
      },{
        \"Kind\": 2,
        \"Name1\": \"Test Sender Name1\",
        \"Street1\": \"Test Road 1\",
        \"PostCode\": 6400,
        \"City\": \"Sønderborg\",
        \"CountryCode\": \"DK\",
        \"Phone\": \"12341234\",
        \"Mobile\": \"12341234\",
        \"Email\": \"noreply@nshift.com\",
        \"Attention\": \"Test Attention\"
      }],
      \"Lines\":[{
        \"Number\": 1,
        \"PkgWeight\": 10000,
        \"Height\": 100,
        \"Length\": 100,
        \"Width\": 100,
        \"GoodsTypeID\": 13
      }]
    },
    \"options\": { \"Labels\": \"ZPLGK\" \"OrderID\":\"order123\" }
  }"

Mitä saat takaisin

Vastaus sisältää lähetyksen tunnisteet (esim. lähetysnumero) sekä osoitelappu-/dokumenttisisällön, jonka voit tulostaa tai välittää eteenpäin muihin järjestelmiin.

Kaavio, joka havainnollistaa Checkout-integraatiota nShift Shipin kanssa: