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:
- Luo osittainen lähetys Checkoutissa (Checkout API).
- 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.
| Tärkeä huomio: Sinulla tulee olla ShipAdvisor Import aktivoituna Ship-asetuksissasi, jotta voit viimeistellä osittaisia lähetyksiä Checkoutista. Ilman tätä Ship ei pysty yhdistämään orderID:tä Checkoutin osittaiseen lähetykseen. ShipAdvisor Import -asetus tulee aktivoida nShift Customer Service -tiimin toimesta API- ja Cloud-asiakkaille. |
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: