Denne arbeidsflyten demonstrerer API-kallene som kreves for å isolere spesifikke forsendelser i en bestemt stack. Ved å opprette forsendelser, opprette en mål-stack og bruke PATCH-endepunktet med riktige identifikatorer (ShpTag, StackCSID), kan du effektivt administrere gruppering av forsendelser før videre behandling, som for eksempel generering av EDI.

Forutsetninger:

• Tilgang til Ship API med gyldige legitimasjoner (Client ID/Secret eller brukernavn/passord).
• Postman-samlingen "Ship API - 2.0 Examples".
• Et konfigurert miljø. Se artikkelen om Postman for hvordan du setter opp miljøet:
  Postman Collection
• Vellykket autentisering (kjør riktig forespørsel i mappen "Authorization").

Trinn i arbeidsflyten:

1. Opprett testforsendelser (forespørsler: 1. Create Test Shipment 1, 2. Create Test Shipment 2):
   • Handling: Opprett nye forsendelser ved hjelp av POST /shipServer/{{ID}}/shipments-endepunktet.
   • Hvorfor: Du må ha eksisterende forsendelser for å kunne flytte dem. Når de opprettes, plasseres de vanligvis i en standard stack som er knyttet til valgt produkt/subcarrier.
   • Viktig output: Noter ShpTag (unik forsendelsesidentifikator) som returneres for hver forsendelse.
2. (Valgfritt) Hent tilgjengelige stacks (forespørsel: 3. Get Available Stacks (Optional Check)):
   • Handling: Hent en liste over alle eksisterende stacks ved hjelp av GET /shipServer/{{ID}}/stacks.
   • Hvorfor: For å se nåværende stacks og deres StackCSID før du oppretter en ny eller velger en eksisterende mål-stack.
3. Opprett ny mål-stack (forespørsel: 4. Create New Target Stack):
   • Handling: Opprett en ny, tom stack ved hjelp av POST /shipServer/{{ID}}/stacks. Du må angi SubcarrierConceptID (funnet i svaret fra opprettelse av forsendelse eller Get Stacks) og et ønsket StackName.
   • Hvorfor: For å opprette en spesifikk destinasjon for forsendelsene du vil flytte.
   • Viktig output: Noter StackCSID (unik stack-identifikator) for den nyopprettede stacken.
4. Flytt forsendelser (forespørsel: 5. Move Test Shipments to New Target Stack):
   • Handling: Oppdater stack-tilknytningen for spesifikke forsendelser ved hjelp av PATCH /shipServer/{{ID}}/stacks/shipments.
   • Hvorfor: Dette er hovedsteget der forsendelsene flyttes.
   • Viktige input: Oppgi mål-StackCSID (fra trinn 3) og en liste med ShipmentTags (fra trinn 1) for forsendelsene du vil flytte.
5. Opprydding (forespørsler: 6. Cleanup..., 7. Cleanup..., 8. Cleanup...):
   • Handling: Slett testforsendelsene (DELETE /shipServer/{{ID}}/shipments/:shipmentTag) og den nyopprettede stacken (DELETE /shipServer/{{ID}}/stacks/:stackCSID).
   • Hvorfor: For å fjerne midlertidige testdata fra systemet etter at flytteoperasjonen er verifisert.