Sendungen über die API erstellen
Nachdem Sie einen Landed Cost berechnet und eine Bestellung erstellt haben, können Sie Sendungsverfolgungsnummern und andere Versanddetails über die API an Zonos senden.
Verwenden Sie diesen Workflow, wenn Sie eine Sendung für eine bestehende Bestellung erstellen und keine Artikel- oder Parteiendetails ändern müssen. Er unterstützt optionale Sendungsverfolgungsnummern, Fulfillment-Center, Service-Level-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 documentFiling } } }}Variable-Optionen:
- Mit Fulfillment-Center: Fügen Sie
"fulfillmentCenter": "fulfillment_center_12345"hinzu, um den Ursprungsort anzugeben - Mit benutzerdefiniertem Tracking: Setzen Sie
"generateLabel": falseund fügen Sie"trackingNumbers": ["tracking_1", "tracking_2"]hinzu - Mit Service-Level: 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 die Deckung des deklarierten Werts zu aktivieren
Deklarierter Wert
Setzen Sie "isDeclaredValue": true, um die Deckung des deklarierten Werts 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. Damit legen Sie die maximale Haftung fest, die der Spediteur im Falle von Verlust, Beschädigung oder Diebstahl während des Transports übernimmt. 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 keine unterschiedlichen Spediteuranforderungen verwalten müssen.
UPS-Einschränkungen: UPS deckt nur Werte zwischen 100,01 und 50.000 USD ab und verarbeitet den deklarierten Wert auf Kartonebene. Bei Sendungen mit mehreren Kartons müssen Händler die Sendung aufteilen, um die Deckung pro Karton festzulegen. UPS erstellt außerdem ein zusätzliches Versicherungsformular (UPS Control Log), das mit den Etiketten für deklarierte Werte über 999 USD ausgedruckt 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 Unterschriftsanforderungen anzugeben. Ausführliche Informationen und Beispiele finden Sie im Leitfaden zu Sonderleistungen.
Eine Sendung stornieren
Um ein erstelltes Etikett zu stornieren, verwenden Sie die folgende Mutation, um die Sendung zu stornieren. Alle zugehörigen Etiketten werden ebenfalls automatisch ungültig. Beachten Sie, dass eine einmal stornierte Sendung nicht mehr aktualisiert oder wiederhergestellt werden kann.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Eine Sendung für bestehende Bestellungen erstellen
Erstellen Sie Sendungen und Etiketten mit der Zonos API, nachdem Sie Landed Cost berechnet und Bestellungen erstellt haben.
GraphQL
Dieser Leitfaden richtet sich an Nutzer, die bereits mit der Zonos API integriert sind und Sendungen für bestehende Bestellungen in ihrem System erstellen müssen. Wenn Sie eine Versandplattform sind und Ihren Kunden stattdessen die Zonos-Sendungserstellung anbieten möchten, lesen Sie unseren Leitfaden zur Shipment API.
Wenn Sie mit der Zonos API integriert sind und für den Versand außerhalb des Dashboard zugelassen sind, verwenden Sie die Mutation
shipmentCreateWorkflow, um Sendungen zu erstellen und Tracking-Informationen bereitzustellen. Diese Mutationen ermöglichen es Ihnen auch, Zonos über inländische Lieferungen an Cross-Docking-Einrichtungen zu informieren.Hinweis: Wenn Sie eine Duty and Tax-App mit einer Plattform verwenden, die Sendungsverfolgungsnummern automatisch mit Zonos synchronisiert, oder wenn Sie direkt über Dashboard versenden, sind diese Mutationen nicht erforderlich.