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:
-
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.
-
Handling: Opprett nye forsendelser ved hjelp av
-
(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
StackCSIDfør du oppretter en ny eller velger en eksisterende mål-stack.
-
Handling: Hent en liste over alle eksisterende stacks ved hjelp av
-
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å angiSubcarrierConceptID(funnet i svaret fra opprettelse av forsendelse eller Get Stacks) og et ønsketStackName. - Hvorfor: For å opprette en spesifikk destinasjon for forsendelsene du vil flytte.
-
Viktig output: Noter
StackCSID(unik stack-identifikator) for den nyopprettede stacken.
-
Handling: Opprett en ny, tom stack ved hjelp av
-
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 medShipmentTags(fra trinn 1) for forsendelsene du vil flytte.
-
Handling: Oppdater stack-tilknytningen for spesifikke forsendelser ved hjelp av
-
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.
-
Handling: Slett testforsendelsene (