Landed Cost•

StartseiteFür Logistikdienstleister Landed Cost Plattform-Sendungsintegration

Sendungen von Ihrer Plattform aus erstellen

Geben Sie Ihren Kunden die Möglichkeit, Zonos-Sendungen und Etiketten von Ihrer Plattform aus zu erstellen.

Dieser Leitfaden richtet sich an Entwickler:innen von Versandplattformen, die Zonos-Funktionen zur Sendungserstellung in ihre Plattform für ihre Kunden integrieren möchten. Wenn Sie die Zonos API bereits nutzen und nur Sendungen für bestehende Bestellungen erstellen müssen, siehe unseren Leitfaden zur Sendungserstellung.

Wenn Sie eine Versandplattform sind, die Zonos-Kunden beim internationalen Versand unterstützt, sollte die Integration mit Zonos für die Sendungserstellung eine Priorität sein. So bieten Sie Ihren Händler:innen und deren Kunden das nahtloseste Erlebnis, indem Sie die bestehenden Funktionen Ihrer Plattform nutzen und Zonos die Erstellung der Sendung, des Etiketts und der unterstützenden Zolldokumentation überlassen.

Vorteile der Sendungserstellung mit Zonos:

Third-Party-Abrechnung von Zöllen und Steuern – Wir stellen sicher, dass Ihre oder die Spediteurkontonummer Ihres Händlers für Versandkosten verwendet wird, während Rechnungen für Zoll und Steuern an Zonos gehen.
Flexibilität – Statt Entwicklungsaufwand zu betreiben, um konforme Etiketten mit Ihrer Plattform zu generieren, integrieren Sie unsere API und überlassen Sie uns die sich ständig ändernde grenzüberschreitende Compliance.
Genaue Zolldokumentation – Wenn Sie Zonos zur Etikettenerstellung nutzen, stellen wir sicher, dass die richtigen Details an den Spediteur übermittelt werden, damit das Paket schnell den Zoll passiert.

Dieser Leitfaden führt Sie durch die Schritte zur Implementierung einer vollständigen End-to-End-Integration, mit der Sie Zonos für Sendungen von Ihrer Plattform aus aufrufen können.

Etikettendruck aktivieren

Folgen Sie den Schritten unten, damit Ihre Kunden Zonos-Etiketten von Ihrer Plattform aus abrufen können.

API-Anmeldedaten zulassen

Sendung erstellen

Um ein label abzurufen, müssen Sie eine shipment erstellen, mit der das label verknüpft ist. Zonos verwaltet diesen Prozess mit einem Workflow, der shipments und labels in derselben Anfrage erstellt. Bei dieser Mutation müssen Sie kein serviceLevel übergeben, da wir das serviceLevel aus dem landedCost verwenden, der mit der order verknüpft ist. Für die orderId können Sie die Zonos-Bestell-ID oder die accountOrderNumber verwenden, die wahrscheinlich bereits in Ihrem System vorhanden ist.

Wenn Sendung und Etiketten erfolgreich erstellt wurden, geben wir Etiketten als labelImage zurück, das ein BASE64_ENCODED_IMAGE ist, oder als url, unter der das Etikett abgerufen werden kann.

Verwenden Sie diesen Workflow, wenn Sie eine Sendung für eine bestehende Bestellung erstellen und Artikel- oder Parteiendetails nicht ändern müssen. Er unterstützt optionale Sendungsverfolgungsnummern, Fulfillment-Center, Servicelevel-Auswahl und Versicherung für den deklarierten Wert.

Shopify-Händler

Shopify übergibt einen Nullwert für person in der Ursprungspartei. Daher funktioniert orderId allein für Shopify-Händler nicht — verwenden Sie stattdessen den Tab Erweiterte Sendungserstellung und geben Sie vollständige Parteiendetails einschließlich person an.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items

25 item

26 id

27 amount

28 description

32 label

33 url

34 trackingNumber

35 id

36 documentFiling

Variablenoptionen:

Mit Fulfillment Center: Fügen Sie "fulfillmentCenter": "fulfillment_center_12345" hinzu, um den Ursprungsstandort anzugeben
Mit benutzerdefinierter Sendungsverfolgung: Setzen Sie "generateLabel": false und fügen Sie "trackingNumbers": ["tracking_1", "tracking_2"] hinzu
Mit Servicelevel: Fügen Sie "serviceLevel": "dhl.express_example" hinzu, um einen bestimmten Spediteur-Service auszuwählen
Mit Versicherung für deklarierten Wert: Fügen Sie "isDeclaredValue": true hinzu, um Deckung für den deklarierten Wert zu aktivieren
Mit Sonderleistungen: Siehe den Leitfaden zu Sonderleistungen für Batterien, Trockeneis, Gefahrgut und Signaturoptionen.

Deklarierter Wert

Setzen Sie "isDeclaredValue": true, um Deckung für den deklarierten Wert für alle Artikel in Ihrer Sendung zu aktivieren. Zonos beansprucht automatisch den vollen Wert aller in der Bestellung übermittelten Artikel; Händler können diesen Betrag nicht ändern. Dies legt die maximale Haftung fest, die der Spediteur im Falle von Verlust, Beschädigung oder Diebstahl während des Transports akzeptiert. Diese Funktion wird nur für UPS-, FedEx- und DHL-Sendungen unterstützt. Zonos übernimmt automatisch die spediteurspezifische Implementierung, wenn Sie den deklarierten Wert aktivieren, einschließlich der entsprechenden Parameter in unseren API-Aufrufen an diese Spediteure, sodass Sie unterschiedliche Spediteuranforderungen nicht selbst verwalten müssen.

UPS-Einschränkungen: UPS deckt nur Werte zwischen 100 und 50.000 USD ab und verarbeitet den deklarierten Wert auf Kartonebene. Bei Mehrkarton-Sendungen müssen Händler die Sendung aufteilen, um die Deckung pro Karton festzulegen. UPS generiert außerdem ein zusätzliches Versicherungsformular, das zusammen mit den Etiketten gedruckt werden muss.

FedEx und DHL: Verarbeiten den deklarierten Wert auf Sendungsebene ohne zusätzliche Einschränkungen.

Sonderleistungen

Verwenden Sie specialServices auf einem Karton, um besondere Handhabungsanforderungen für Batterien, Trockeneis, Gefahrgut oder Signaturpflicht anzugeben. Siehe den Leitfaden zu Sonderleistungen für vollständige Details und Beispiele.

ShipStation UPS Unlock: Mehrstück-Sendungen werden nicht unterstützt. Wenn eine Bestellung in mehreren Kartons versendet wird, wird das Referenzfeld dupliziert, wodurch die Bestellnummern-Zuordnung im Backend fehlschlägt. Händler, die Mehrstück-Sendungen benötigen, sollten das Etikett stattdessen im Zonos Dashboard erstellen. Einzelkarton-Sendungen sind nicht betroffen.

Sendung stornieren

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Buchen Sie eine Demo

Sendungen von Ihrer Plattform aus erstellen

Etikettendruck aktivieren

API-Anmeldedaten zulassen

Sendung erstellen

Sendung stornieren

War diese Seite hilfreich?