DOCS

Erstellen Sie einen Versand

Landed Cost•
StartseiteFür Logistikdienstleister Landed Cost Erstellen Sie einen Versand

Erstellen Sie einen Versand für bestehende Bestellungen

Erstellen Sie Sendungen und Etiketten mit der Zonos API, nachdem Sie die Landekosten berechnet und Bestellungen erstellt haben.

GraphQL

Dieser Leitfaden ist für Benutzer gedacht, die bereits in die 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 Erstellung von Zonos-Sendungen anbieten möchten, sehen Sie sich unseren Versand-API-Leitfaden an.

Wenn Sie in die Zonos API integriert sind und genehmigt wurden, um außerhalb des Dashboards zu versenden, verwenden Sie die shipmentCreateWorkflow-Mutation, um Sendungen zu erstellen und Tracking-Informationen bereitzustellen. Diese Mutationen ermöglichen es Ihnen auch, Zonos über Inlandsversendungen zu Cross-Docking-Einrichtungen zu informieren.

Hinweis: Wenn Sie eine Duty and Tax-App mit einer Plattform verwenden, die automatisch Tracking-Nummern mit Zonos synchronisiert, oder wenn Sie direkt über das Dashboard versenden, sind diese Mutationen nicht erforderlich.

Erstellen Sie Sendungen über die API 

Nachdem Sie eine Landed Cost berechnet und eine Bestellung erstellt haben, können Sie Tracking-Nummern und andere Versanddetails über die API an Zonos senden.

Verwenden Sie diesen Workflow, wenn Sie einen Versand für eine bestehende Bestellung erstellen und keine Artikel- oder Partydetails ändern müssen. Er unterstützt optionale Tracking-Nummern, Erfüllungszentren, die Auswahl des Servicelevels und eine deklarierte Wertversicherung.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Mit Erfüllungszentrum

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Mit benutzerdefinierter Verfolgung

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Mit Servicelevel

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Mit deklarierter Wertversicherung

1
2
3
4
5
6
7
{
  "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 

Um ein erstelltes Etikett zu stornieren, verwenden Sie die folgende Mutation, um die Sendung zu stornieren. Alle zugehörigen Etiketten werden ebenfalls automatisch storniert. Beachten Sie, dass eine stornierte Sendung nicht mehr aktualisiert oder wiederhergestellt werden kann.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

War diese Seite hilfreich?

Buchen Sie eine Demo
© 2025 Zonoszonos.com
Auf dieser Seite:
  • Erstellen Sie einen Versand für bestehende Bestellungen
  • Erstellen Sie Sendungen über die API
  • Eine Sendung stornieren