Denne arbejdsgang demonstrerer de API-kald, der kræves for at isolere specifikke forsendelser i en bestemt stack. Ved at oprette forsendelser, oprette en mål-stack og bruge PATCH-endpointet med de korrekte identifikatorer (ShpTag, StackCSID) kan du effektivt administrere gruppering af forsendelser før videre behandling, såsom generering af EDI.

Forudsætninger:

• Adgang til Ship API med gyldige legitimationsoplysninger (Client ID/Secret eller brugernavn/adgangskode).
• Postman-collection "Ship API - 2.0 Examples".
• Et konfigureret miljø. Se artiklen om Postman for, hvordan du opsætter miljøet:
  Postman Collection
• Vellykket autentificering (kør den relevante forespørgsel i mappen "Authorization").

Trin i arbejdsgangen:

1. Opret testforsendelser (forespørgsler: 1. Create Test Shipment 1, 2. Create Test Shipment 2):
   • Handling: Opret nye forsendelser ved hjælp af POST /shipServer/{{ID}}/shipments-endpointet.
   • Hvorfor: Du skal have eksisterende forsendelser for at kunne flytte dem. Når de oprettes, placeres de typisk i en standard stack, der er knyttet til det valgte produkt/undertransportør.
   • Vigtigt output: Notér ShpTag (unik forsendelsesidentifikator), der returneres for hver forsendelse.
2. (Valgfrit) Hent tilgængelige stacks (forespørgsel: 3. Get Available Stacks (Optional Check)):
   • Handling: Hent en liste over alle eksisterende stacks ved hjælp af GET /shipServer/{{ID}}/stacks.
   • Hvorfor: For at se nuværende stacks og deres StackCSID før du opretter en ny eller vælger en eksisterende mål-stack.
3. Opret ny mål-stack (forespørgsel: 4. Create New Target Stack):
   • Handling: Opret en ny, tom stack ved hjælp af POST /shipServer/{{ID}}/stacks. Du skal angive SubcarrierConceptID (fundet i svaret fra oprettelse af forsendelse eller Get Stacks) og et ønsket StackName.
   • Hvorfor: For at oprette en specifik destination for de forsendelser, du vil flytte.
   • Vigtigt output: Notér StackCSID (unik stack-identifikator) for den nyoprettede stack.
4. Flyt forsendelser (forespørgsel: 5. Move Test Shipments to New Target Stack):
   • Handling: Opdater stack-tilknytningen for specifikke forsendelser ved hjælp af PATCH /shipServer/{{ID}}/stacks/shipments.
   • Hvorfor: Dette er det centrale trin, hvor forsendelserne flyttes.
   • Vigtige input: Angiv mål-StackCSID (fra trin 3) og en liste af ShipmentTags (fra trin 1) for de forsendelser, du vil flytte.
5. Oprydning (forespørgsler: 6. Cleanup..., 7. Cleanup..., 8. Cleanup...):
   • Handling: Slet testforsendelserne (DELETE /shipServer/{{ID}}/shipments/:shipmentTag) og den nyoprettede stack (DELETE /shipServer/{{ID}}/stacks/:stackCSID).
   • Hvorfor: For at fjerne midlertidige testdata fra systemet efter verifikation af flytteoperationen.