Tämä työnkulku esittelee API-kutsut, joita tarvitaan tiettyjen lähetysten erottamiseen määriteltyyn stackiin. Luomalla lähetyksiä, luomalla kohde-stackin ja käyttämällä PATCH-endpointia oikeilla tunnisteilla (ShpTag, StackCSID) voit hallita lähetysten ryhmittelyä tehokkaasti ennen jatkokäsittelyä, kuten EDI:n generointia.
Edellytykset:
- Pääsy Ship API:in voimassa olevilla tunnuksilla (Client ID/Secret tai käyttäjätunnus/salasana).
- Postman-kokoelma "Ship API - 2.0 Examples".
- Konfiguroitu ympäristö. Katso Postman-artikkeli ympäristön määrittämiseksi:
Postman Collection - Onnistunut autentikointi (suorita oikea pyyntö "Authorization"-kansiossa).
Työnkulun vaiheet:
-
Luo testilähetykset (pyynnöt:
1. Create Test Shipment 1,2. Create Test Shipment 2):-
Toiminto: Luo uusia lähetyksiä käyttämällä
POST /shipServer/{{ID}}/shipments-endpointia. - Miksi: Tarvitset olemassa olevia lähetyksiä siirtääksesi niitä. Luonnin jälkeen ne sijoitetaan yleensä oletus-stackiin, joka liittyy valittuun tuotteeseen/alikuljetusliikkeeseen.
-
Tärkeä tulos: Kirjaa ylös
ShpTag(yksilöllinen lähetyksen tunniste), joka palautetaan jokaiselle lähetykselle.
-
Toiminto: Luo uusia lähetyksiä käyttämällä
-
(Valinnainen) Hae käytettävissä olevat stackit (pyyntö:
3. Get Available Stacks (Optional Check)):-
Toiminto: Hae lista kaikista olemassa olevista stackeista käyttämällä
GET /shipServer/{{ID}}/stacks. -
Miksi: Näet nykyiset stackit ja niiden
StackCSID-tunnukset ennen uuden luomista tai olemassa olevan kohde-stackin valintaa.
-
Toiminto: Hae lista kaikista olemassa olevista stackeista käyttämällä
-
Luo uusi kohde-stack (pyyntö:
4. Create New Target Stack):-
Toiminto: Luo uusi, tyhjä stack käyttämällä
POST /shipServer/{{ID}}/stacks. Sinun tulee antaaSubcarrierConceptID(löytyy lähetyksen luonnin vastauksesta tai Get Stacks -vastauksesta) ja haluttuStackName. - Miksi: Luodaksesi tietyn kohteen lähetyksille, jotka haluat siirtää.
-
Tärkeä tulos: Kirjaa ylös uuden stackin
StackCSID(yksilöllinen stack-tunniste).
-
Toiminto: Luo uusi, tyhjä stack käyttämällä
-
Siirrä lähetykset (pyyntö:
5. Move Test Shipments to New Target Stack):-
Toiminto: Päivitä stack-määritys tietyille lähetyksille käyttämällä
PATCH /shipServer/{{ID}}/stacks/shipments. - Miksi: Tämä on keskeinen vaihe, jossa lähetykset siirretään.
-
Tärkeät syötteet: Anna kohde-
StackCSID(vaiheesta 3) sekä listaShipmentTags-arvoja (vaiheesta 1) niille lähetyksille, jotka haluat siirtää.
-
Toiminto: Päivitä stack-määritys tietyille lähetyksille käyttämällä
-
Siivous (pyynnöt:
6. Cleanup...,7. Cleanup...,8. Cleanup...):-
Toiminto: Poista testilähetykset (
DELETE /shipServer/{{ID}}/shipments/:shipmentTag) ja uusi stack (DELETE /shipServer/{{ID}}/stacks/:stackCSID). - Miksi: Poistaaksesi väliaikaiset testitiedot järjestelmästä siirron varmistamisen jälkeen.
-
Toiminto: Poista testilähetykset (