DOCS

Create a shipment

/

Tạo một lô hàng

Tạo một lô hàng với API Zonos.

GraphQL

Nếu bạn đã tích hợp với API Zonos và được phê duyệt để gửi hàng ra ngoài Dashboard, bạn sẽ cần tạo một lô hàng và cung cấp số theo dõi bằng cách sử dụng phép biến đổi shipmentCreateWorkflow. Bạn cũng có thể sử dụng các phép biến đổi này để thông báo cho Zonos về các lô hàng nội địa đến các cơ sở cross-docking.

Nếu bạn đang sử dụng ứng dụng Duty and Tax và gửi hàng với một nền tảng đồng bộ số theo dõi đến Zonos hoặc gửi hàng trong Dashboard, bạn sẽ không cần sử dụng phép biến đổi này.

Tạo một lô hàng qua API 

Khi một Landed Cost đã được tính toán và một đơn hàng đã được tạo, bạn có thể gửi cho chúng tôi số theo dõi và các chi tiết lô hàng khác qua API.

Chi tiết lô hàng
Tạo nhãn với lô hàng

Sử dụng yêu cầu này khi bạn thông báo cho Zonos về một shipment nhưng không cần nhãn. Bạn sẽ cung cấp chi tiết về partiesshipmentCartons liên quan đến order. Bằng cách cung cấp cho chúng tôi những chi tiết này, chúng tôi sẽ biết liệu đơn hàng đã được hoàn thành một phần hay toàn bộ.

Phép biến đổi

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
mutation {
  partyCreateWorkflow(
    input: [
      {
        location: {
          administrativeArea: "Utah"
          administrativeAreaCode: "UT"
          countryCode: US
          line1: "123 Test Street"
          locality: "St George"
          postalCode: "84770"
        }
        person: { companyName: "test Corp", phone: "8018565714" }
        type: ORIGIN
      }
      {
        location: {
          administrativeArea: "Quebec"
          administrativeAreaCode: "QC"
          countryCode: CA
          line1: "2147 Pitfield Blvd"
          locality: "Pierrefonds"
          postalCode: "H9H 3C7"
        }
        person: {
          email: "test@gmail.com"
          firstName: "firstName"
          lastName: "lastName"
          phone: "5022303021"
          companyName: "goProTest"
          metadata: { key: "key", value: "value" }
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }
  shipmentCreateWorkflow(
    input: {
      trackingNumber: "test_tracking_num_5"
      orderId: "order_c535c9c8-88a1-4dde-b938-7dd7f776beee"
      serviceLevel: "service_level_720198b0-43ce-409e-a5bb-0c6e91a43fad"
      shipmentCartons: [
        {
          dimensionalUnit: "INCH"
          length: 10
          width: 10
          height: 10
          weightUnit: "POUND"
          weight: 10
          trackingNumber: "1234567890"
          items: [{ itemReference: "someothersku4345" }]
        }
      ]
    }
  ) {
    id
    status
    tracking {
      id
      number
    }
    shipmentCartons {
      id
      tracking {
        number
      }
      carton {
        id
        length
        width
        height
        dimensionalUnit
        weight
        weightUnit
      }
    }
  }
}

Hủy lô hàng 

Trong trường hợp bạn muốn hủy một nhãn đã được tạo, bạn có thể sử dụng đoạn mã sau để hủy lô hàng. Nếu đã tạo nhãn cho lô hàng, chúng sẽ được hủy bỏ. Khi một lô hàng đã được hủy, nó không thể được cập nhật.

Yêu cầu

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Trang này có hữu ích không?