Etikettendruck aktivieren
Befolgen Sie die folgenden Schritte, um Ihren Kunden zu ermöglichen, Zonos-Etiketten von Ihrer Plattform abzurufen.
API-Anmeldeinformationen zulassen
Die Zonos-API ist über ein credentialToken zugänglich. Ihre Plattform muss den Kunden die Möglichkeit geben, ihr credentialToken vom Zonos-Dashboard in Ihre Plattform einzugeben. Von hier aus können Sie im Namen der Kunden Anfragen an Zonos stellen.
Eine Sendung erstellen
Um ein label abzurufen, müssen Sie eine shipment erstellen, die mit dem 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 verwenden, das mit dem landedCost verknüpft ist, das an die order gebunden 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 eine Sendung und Etiketten erfolgreich erstellt werden, geben wir die Etiketten als labelImage zurück, das ein BASE64_ENCODED_IMAGE ist, oder als url, von der das Etikett abgerufen werden kann.
Verwenden Sie diesen Workflow, wenn Sie eine Sendung für eine bestehende Bestellung erstellen und keine Artikel- oder Party-Details ändern müssen. Es unterstützt optionale Sendungsverfolgungsnummern, Erfüllungszentren, die Auswahl des Servicelevels und eine deklarierte Wertversicherung.
Mutation
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
}
}
}
}
Grundlegende Variablen
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Mit Erfüllungszentrum
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Mit benutzerdefinierter Verfolgung
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Mit Servicelevel
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Mit deklarierter Wertversicherung
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Deklarierter Wert
Setzen Sie "isDeclaredValue": true, um die Deckung des deklarierten Wertes für alle Artikel in Ihrer Sendung zu aktivieren. Zonos beansprucht automatisch den vollen Wert aller in der Bestellung eingereichten Artikel; Händler können diesen Betrag nicht ändern. Dies legt die maximale Haftung fest, die der Carrier 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 kümmert sich automatisch um die carrier-spezifische Implementierung, wenn Sie den deklarierten Wert aktivieren, einschließlich der entsprechenden Parameter in unseren API-Aufrufen an diese Carrier, sodass Sie keine unterschiedlichen Anforderungen der Carrier verwalten müssen.
UPS-Beschränkungen: UPS deckt nur Werte zwischen 100-50.000 USD ab und verarbeitet den deklarierten Wert auf Karton-Ebene. Bei Mehrkartonsendungen müssen Händler die Sendung aufteilen, um die Deckung pro Karton zuzuweisen. UPS erstellt auch ein zusätzliches Versicherungsformular, das zusammen mit den Etiketten ausgedruckt werden muss.
FedEx und DHL: Verarbeiten den deklarierten Wert auf Sendungsebene ohne zusätzliche Einschränkungen.
Eine Sendung stornieren
Falls ein Kunde eine Sendung stornieren möchte, können Sie die folgende Mutation verwenden, die alle mit der Sendung verbundenen Etiketten stornieren wird.
Anfrage
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Erstellen Sie Sendungen von Ihrer Plattform
Geben Sie Ihren Kunden die Möglichkeit, Zonos-Sendungen und -Etiketten von Ihrer Plattform aus zu erstellen.
Dieser Leitfaden richtet sich an Entwickler von Versandplattformen, die die Erstellung von Zonos-Sendungen in ihre Plattform für ihre Kunden integrieren möchten. Wenn Sie bereits die Zonos-API verwenden und nur Sendungen für bestehende Bestellungen erstellen müssen, sehen Sie sich unseren Leitfaden zur Erstellung von Sendungen an.
Wenn Sie eine Versandplattform sind, die Zonos-Kunden beim internationalen Versand unterstützt, sollte die Integration mit Zonos zur Erstellung von Sendungen eine oberste Priorität haben. Dies ermöglicht es Ihnen, das nahtloseste Erlebnis für Ihre Händler und deren Kunden zu bieten, indem Sie die bestehenden Funktionen Ihrer Plattform nutzen und Zonos die Erstellung der Sendung, des Etiketts und der unterstützenden Zollunterlagen verwalten lassen.
Die Vorteile der Verwendung von Zonos zur Erstellung von Sendungen umfassen:
Dieser Leitfaden führt Sie durch die Schritte zur Implementierung einer vollständigen End-to-End-Integration, die es Ihnen ermöglicht, Zonos für Sendungen von Ihrer Plattform aus aufzurufen.