DOCS

Erstellen Sie einen Versand

Erstellen Sie einen Versand

Erstellen Sie Sendungen mit der Zonos API unter Verwendung von GraphQL-Mutationen.

GraphQL

Wenn Sie mit der 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 an Cross-Docking-Einrichtungen zu informieren.

Hinweis: Wenn Sie eine Duty and Tax-App mit einer Plattform verwenden, die automatisch Tracking-Nummern an 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. Es unterstützt optionale Tracking-Nummern, Erfüllungszentren und die Auswahl des Servicelevels.

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"
  }
}

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?