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:

1. 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.
2. (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.
3. 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 antaa SubcarrierConceptID (löytyy lähetyksen luonnin vastauksesta tai Get Stacks -vastauksesta) ja haluttu StackName.
   • Miksi: Luodaksesi tietyn kohteen lähetyksille, jotka haluat siirtää.
   • Tärkeä tulos: Kirjaa ylös uuden stackin StackCSID (yksilöllinen stack-tunniste).
4. 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ä lista ShipmentTags-arvoja (vaiheesta 1) niille lähetyksille, jotka haluat siirtää.
5. 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.