Etikettendruck aktivieren
Folgen Sie den Schritten unten, damit Ihre Kunden Zonos-Etiketten von Ihrer Plattform aus abrufen können.
API-Anmeldedaten zulassen
Die Zonos API ist über ein credentialToken zugänglich. Ihre Plattform muss Kunden die Möglichkeit geben, ihr credentialToken aus dem Zonos Dashboard in Ihre Plattform einzugeben. Von dort aus können Sie Anfragen an Zonos in deren Namen stellen.
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.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items item id amount description label url trackingNumber id documentFilingVariablenoptionen:
- Mit Fulfillment Center: Fügen Sie
"fulfillmentCenter": "fulfillment_center_12345"hinzu, um den Ursprungsstandort anzugeben - Mit benutzerdefinierter Sendungsverfolgung: Setzen Sie
"generateLabel": falseund 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": truehinzu, 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
Falls eine Kund:in eine shipment stornieren möchte, können Sie die folgende Mutation verwenden, die alle mit der shipment verknüpften labels storniert.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
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:
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.