Wanneer een klant de checkout voltooit, kunt u een partial shipment aanmaken in nShift Checkout. Een gedeeltelijke zending bevat de bezorgkeuze (vervoerder/service, afhaalpunt, enz.), maar moet nog worden voltooid (geboekt) in nShift Ship om zendingsnummers en labels te genereren.

Overzicht

Dit is de typische end-to-end-flow:

1. Maak een gedeeltelijke zending aan in Checkout (Checkout API). 
2. Boek de zending in nShift Ship met behulp van de Post Shipment‑aanvraag om labels en een zendingnummer te produceren.

Stap 1: Maak de gedeeltelijke zending aan in Checkout

Nadat de klant een bezorgoptie heeft geselecteerd, maakt u een gedeeltelijke zending aan met behulp van de Checkout API-documentatie: Create Partial Shipment.

Belangrijk: Zorg ervoor dat u de identifier opslaat die u later zult gebruiken om de order/zending te vinden. Dit is doorgaans de orderID.
 

Stap 3: Voltooi de zending door deze te boeken in nShift Ship

Om een gedeeltelijke zending af te ronden, boekt u deze met de methode Post Shipment in de Ship API. Hiermee wordt de zending aangemaakt/geboekt en wordt het verzendlabel geretourneerd. 
 

Wat u moet opnemen om succesvol te boeken

Een geboekte zending vereist een volledig “data object” voor de zending (ontvanger, vervoerderproduct/service, pakketten/gewichten, enz.). Het volgende is vereist, maar alleen de informatie die niet in de gedeeltelijke zending is opgenomen, is nodig om de zending te voltooien. In de praktijk bevat de gedeeltelijke zending (uit Checkout) meestal niet alles wat nodig is om de boeking te voltooien.

• OrderID: toegevoegd in Options, hiermee worden de gegevens opgehaald uit de gedeeltelijke zending vanuit Checkout
• Carrier service: ProdConceptID
• Order number: OrderNo
• Addresses: ontvanger (Kind: 1) en afzender (Kind: 2)
• Packages / lines: bijvoorbeeld gewichten/afmetingen in Lines
• Goodstypes: vereist door sommige vervoerders
• Label format options: bijvoorbeeld "Labels": "ZPLGK"
• Customs details: nodig bij verzending over douanegrenzen heen

Elke vervoerder heeft zijn eigen specificaties en vereisten - lees meer hier: Vereiste velden identificeren bij het boeken van zendingen

Voor meer details over het boeken van een zending, zie How to - Book a Shipment

Voorbeeldverzoek (enkel pakket)

Dit voorbeeld toont een zending met adresinformatie. Normaal gesproken maken adresgegevens deel uit van de gedeeltelijke zending vanuit Checkout en zijn ze niet vereist, maar sommige vervoerders kunnen extra informatie nodig hebben afhankelijk van hun vereisten.

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\" }
  }"

Wat u terugkrijgt

Het antwoord bevat zendingidentificaties (bijv. zendingsnummer) en label-/documentinhoud die u kunt afdrukken of doorsturen naar downstream-systemen.

Stroomdiagram dat een Checkout-integratie met nShift Ship illustreert: