Abschluss einer Teilsendung aus nShift Checkout – nShift Ship Help Center

Wenn ein Kunde den Checkout abschließt, können Sie eine partial shipment in nShift Checkout erstellen. Eine Teilsendung enthält die Lieferauswahl (Frachtführer/Service, Abholpunkt usw.), muss jedoch noch in nShift Ship abgeschlossen (gebucht) werden, um Sendungsnummern und Labels zu erzeugen.

Übersicht

Dies ist der typische End-to-End-Ablauf:

Erstellen Sie eine Teillieferung im Checkout (Checkout API).
Buchen Sie die Sendung in nShift Ship mithilfe der Post Shipment‑Anfrage, um Etiketten und eine Sendungsnummer zu erzeugen.

Schritt 1: Erstellen Sie die Teilsendung im Checkout

Nachdem der Kunde eine Lieferoption ausgewählt hat, erstellen Sie eine Teilsendung mithilfe der Checkout API-Dokumentation: Create Partial Shipment.

Wichtig: Stellen Sie sicher, dass Sie die Kennung speichern, die Sie später verwenden, um die Bestellung/Sendung zu finden. Dies ist in der Regel die orderID.

Schritt 3: Schließen Sie die Sendung ab, indem Sie sie in nShift Ship buchen

Um eine Teilsendung abzuschließen, buchen Sie sie mit der Methode Post Shipment in der Ship API. Dadurch wird die Sendung erstellt/gebucht und das Versandlabel zurückgegeben.

Wichtiger Hinweis: Sie müssen den ShipAdvisor Import in Ihrer Ship-Konfiguration aktiviert haben, um Teilsendungen aus Checkout abschließen zu können. Ohne dies kann Ship die orderID nicht mit der Teilsendung aus Checkout abgleichen. Das Konfigurationselement ShipAdvisor Import muss von nShift Customer Service für API- und Cloud-Kunden aktiviert werden.

Was Sie für eine erfolgreiche Buchung angeben müssen

Eine gebuchte Sendung erfordert ein vollständiges Versand-„data object“ (Empfänger, Frachtführerprodukt/-service, Pakete/Gewichte usw.). Folgendes ist erforderlich, jedoch nur die Informationen, die nicht in der Teilsendung enthalten sind, werden benötigt, um die Sendung abzuschließen. In der Praxis enthält die Teilsendung (aus Checkout) meist nicht alle notwendigen Informationen für die Buchung.

OrderID: wird in Options hinzugefügt und ruft die Daten aus der Teilsendung aus Checkout ab
Carrier service: ProdConceptID
Order number: OrderNo
Addresses: Empfänger (Kind: 1) und Absender (Kind: 2)
Packages / lines: z. B. Gewichte/Abmessungen in Lines
Goodstypes: von einigen Frachtführern erforderlich
Label format options: z. B. "Labels": "ZPLGK"
Customs details: erforderlich bei Versand über Zollgrenzen hinweg

Jeder Frachtführer hat eigene Spezifikationen und Anforderungen – lesen Sie hier mehr: Erforderliche Felder beim Buchen von Sendungen identifizieren

Weitere Details zur Buchung einer Sendung finden Sie hier: How to - Book a Shipment

Beispielanfrage (ein Paket)

Dieses Beispiel zeigt eine Sendung mit Adressinformationen. In der Regel sind Adressdaten Teil der Teilsendung aus Checkout und nicht erforderlich, aber einige Frachtführer benötigen je nach Anforderungen zusätzliche Informationen.

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

Was Sie zurückerhalten

Die Antwort enthält Sendungskennungen (z. B. Sendungsnummer) sowie Label-/Dokumentinhalte, die Sie drucken oder an nachgelagerte Systeme weiterleiten können.

Flussdiagramm zur Veranschaulichung einer Checkout-Integration mit nShift Ship:

Ship Help Center