Zum Hauptinhalt springen
Wenn Ihr Shop physische Produkte verkauft, verbinden Sie mit diesen Endpunkten Ihr Lager oder Ihre Versandsoftware. Ihr Shop muss unter Einstellungen › Physische Waren für physische Waren freigeschaltet sein.

1. Zu versendende Bestellungen finden

to_ship listet bezahlte Bestellungen mit noch nicht versendeten Artikeln auf, die ältesten zuerst. Weitere Filter: in_transit, delivered, issues (fehlgeschlagene Zustellungen, Retouren) und all. GET /orders/{invoiceId} liefert die Adresse, jeden Artikel mit shipped_quantity, Sendungen, Retouren und Notizen.

2. Sendung erstellen

  • Lassen Sie items weg, um alles Verbleibende zu versenden. Für eine Teilsendung senden Sie items: [{ "invoice_item_id": 55, "qty": 1 }].
  • Der Kunde erhält eine E-Mail mit dem Tracking-Link. Senden Sie notify_customer: false, um sie zu überspringen.
  • Der Tracking-Link wird anhand des Versanddienstleisters erzeugt. GET /shipping listet die Carrier-Codes auf.

3. Status aktualisieren

Statuswerte: label_created, shipped, in_transit, out_for_delivery, delivered, failed_attempt, returned_to_sender. Jeder Status wird der Tracking-Zeitleiste hinzugefügt, die der Kunde sieht. Der fulfillment_status der Bestellung folgt den Sendungen automatisch.

Retouren

Kunden beantragen Retouren innerhalb des Rückgabezeitraums des Produkts über ihre Bestellseite. Bearbeiten Sie sie mit PATCH /orders/{invoiceId}/returns/{returnId}: GET /returns?status=requested listet offene Anfragen über alle Bestellungen hinweg auf.

Versandeinstellungen

Lesen und ändern Sie Zonen, Tarife und Lagerstandorte mit /shipping/zones und /shipping/locations. Berechnen Sie die Versandkosten für einen Warenkorb mit POST /shipping/quote.