Når en kunde fullfører checkout, kan du opprette en partial shipment i nShift Checkout. En delvis forsendelse inneholder leveringsvalget (transportør/tjeneste, hentepunkt osv.), men den må fortsatt fullføres (bookes) i nShift Ship for å generere forsendelsesnumre og etiketter.

Oversikt

Dette er den typiske ende-til-ende-flyten:

1. Opprett en delvis forsendelse i Checkout (Checkout API). 
2. Book forsendelsen i nShift Ship ved å bruke Post Shipment‑forespørselen for å produsere etiketter og et forsendelsesnummer.

Steg 1: Opprett den delvise forsendelsen i Checkout

Når kunden har valgt et leveringsalternativ, opprett en delvis forsendelse ved hjelp av Checkout API-dokumentasjonen: Create Partial Shipment.

Viktig: Sørg for at du lagrer identifikatoren du senere vil bruke til å finne ordren/forsendelsen. Dette er vanligvis orderID.
 

Steg 3: Fullfør forsendelsen ved å booke den i nShift Ship

For å fullføre en delvis forsendelse booker du den ved hjelp av metoden Post Shipment i Ship API. Dette oppretter/booker forsendelsen og returnerer fraktetiketten. 
 

Hva du må inkludere for å booke vellykket

En booket forsendelse krever et komplett “data object” (mottaker, transportørprodukt/tjeneste, pakker/vekter osv.). Følgende er påkrevd, men kun informasjonen som ikke er inkludert i den delvise forsendelsen er nødvendig for å fullføre forsendelsen. I praksis inneholder den delvise forsendelsen (fra Checkout) vanligvis ikke alt som trengs for å fullføre bookingen.

• OrderID: legges til i Options og henter data fra den delvise forsendelsen fra Checkout
• Carrier service: ProdConceptID
• Order number: OrderNo
• Addresses: mottaker (Kind: 1) og avsender (Kind: 2)
• Packages / lines: for eksempel vekter/dimensjoner i Lines
• Goodstypes: kreves av noen transportører
• Label format options: for eksempel "Labels": "ZPLGK"
• Customs details: nødvendig ved sending over tollgrenser

Hver transportør har sine egne spesifikasjoner og krav – les mer her: Identifisere nødvendige felt ved booking av forsendelser

For flere detaljer om booking av en forsendelse, se How to - Book a Shipment

Eksempel på forespørsel (én pakke)

Dette eksemplet viser en forsendelse som inkluderer adresseinformasjon. Vanligvis er adresseopplysninger en del av den delvise forsendelsen fra Checkout og er ikke påkrevd, men noen transportører kan trenge ekstra informasjon avhengig av sine krav.

curl -s -X POST "{{URL}}/ShipServer/{{ACTOR_ID}}/Shipments" \
  -H "Authorization: {{TOKEN}}" \
  -H "Content-Type: application/json" \
  --data-raw "{
    \"data\": {
      \"OrderNo\": \"Test Shipment 1\",
      \"Addresses\": [{
        \"Kind\": 1,
        \"Name1\": \"Test Receiver Name1\",
        \"Street1\": \"Test Road 1\",
        \"PostCode\": 7400,
        \"City\": \"Herning\",
        \"CountryCode\": \"DK\",
        \"Phone\": \"12341234\",
        \"Mobile\": \"12341234\",
        \"Email\": \"noreply@nshift.com\",
        \"Attention\": \"Test Attention\"
      },{
        \"Kind\": 2,
        \"Name1\": \"Test Sender Name1\",
        \"Street1\": \"Test Road 1\",
        \"PostCode\": 6400,
        \"City\": \"Sønderborg\",
        \"CountryCode\": \"DK\",
        \"Phone\": \"12341234\",
        \"Mobile\": \"12341234\",
        \"Email\": \"noreply@nshift.com\",
        \"Attention\": \"Test Attention\"
      }],
      \"Lines\":[{
        \"Number\": 1,
        \"PkgWeight\": 10000,
        \"Height\": 100,
        \"Length\": 100,
        \"Width\": 100,
        \"GoodsTypeID\": 13
      }]
    },
    \"options\": { \"Labels\": \"ZPLGK\" \"OrderID\":\"order123\" }
  }"

Hva du får tilbake

Svaret inneholder forsendelsesidentifikatorer (f.eks. forsendelsesnummer) og etikett-/dokumentinnhold som du kan skrive ut eller videresende til nedstrømssystemer.

Flytskjema som illustrerer en Checkout-integrasjon med nShift Ship: