DOCS

Tích hợp API vận chuyển

Landed Cost•
Trang chủĐối với nhà cung cấp logistics Landed Cost Tích hợp API vận chuyển

Tạo Zonos vận chuyển từ nền tảng của bạn

Cung cấp cho khách hàng khả năng tạo Zonos vận chuyển và nhãn từ nền tảng của bạn.

Nếu bạn là một nền tảng vận chuyển hỗ trợ khách hàng Zonos vận chuyển quốc tế, việc kết nối với Zonos để tạo vận chuyển nên là một ưu tiên hàng đầu. Điều này sẽ cho phép bạn cung cấp trải nghiệm liền mạch nhất cho các thương gia và khách hàng của họ bằng cách tận dụng các tính năng hiện có của nền tảng của bạn trong khi để Zonos quản lý việc tạo vận chuyển, nhãn và tài liệu hải quan hỗ trợ.

Lợi ích của việc sử dụng Zonos để tạo vận chuyển bao gồm:

  • Thanh toán thuế và phí từ bên thứ ba - Chúng tôi sẽ đảm bảo rằng số tài khoản của bạn hoặc của thương gia được sử dụng cho các khoản phí vận chuyển trong khi hóa đơn cho thuế và phí sẽ đến Zonos.
  • Tính linh hoạt - Thay vì thực hiện công việc phát triển để đảm bảo rằng bạn có thể tạo nhãn tuân thủ với nền tảng của mình, hãy tích hợp với API của chúng tôi và để chúng tôi quản lý sự tuân thủ xuyên biên giới luôn thay đổi.
  • Tài liệu hải quan chính xác - Khi bạn sử dụng Zonos để tạo nhãn, chúng tôi đảm bảo rằng các chi tiết đúng được chuyển đến nhà vận chuyển để đảm bảo rằng gói hàng được thông quan nhanh chóng.

Hướng dẫn này sẽ hướng dẫn bạn qua các bước để thực hiện một tích hợp hoàn chỉnh từ đầu đến cuối cho phép bạn gọi Zonos để vận chuyển từ nền tảng của bạn.

Cho phép khách hàng in nhãn Zonos từ nền tảng của bạn 

Thực hiện theo các bước dưới đây để cho phép khách hàng của bạn lấy nhãn Zonos từ nền tảng của bạn.

1

Cho phép khách hàng nhập thông tin xác thực API Zonos

API Zonos có thể truy cập bằng credentialToken. Nền tảng của bạn sẽ cần cung cấp cho khách hàng khả năng nhập credentialToken của họ từ Bảng điều khiển Zonos vào nền tảng của bạn. Từ đây, bạn sẽ có thể thực hiện các yêu cầu đến Zonos thay mặt cho họ.

2

Tạo một vận chuyển

Để lấy một label, bạn cần tạo một shipment mà label sẽ được liên kết với. Zonos quản lý quy trình này với một quy trình làm việc tạo shipments và labels trong cùng một yêu cầu. Khi thực hiện biến đổi này, bạn không cần phải truyền một serviceLevel vì chúng tôi sẽ sử dụng serviceLevel được sử dụng từ landedCost liên kết với order. Đối với orderId, bạn có thể sử dụng ID đơn hàng Zonos hoặc accountOrderNumber mà có thể đã có trong hệ thống của bạn. Khi một vận chuyển và nhãn được tạo thành công, chúng tôi sẽ trả về nhãn dưới dạng labelImage là một BASE64_ENCODED_IMAGE, hoặc dưới dạng url nơi nhãn có thể được lấy từ.

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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
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"
          firstName: "Tom"
        }
        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"
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }
  itemCreateWorkflow(
    input: [
      {
        amount: 50
        currencyCode: USD
        countryOfOrigin: US
        quantity: 1
        metadata: { key: "tags", value: "accessory" }
        sku: "ow-accessory-gtr"
        productId: "1892949164056"
      }
    ]
  ) {
    amount
    id
    quantity
    sku
    productId
  }
  cartonsCreateWorkflow(
    input: {
      dimensionalUnit: INCH
      height: "5"
      length: "5"
      weight: "5"
      weightUnit: POUND
      width: "10"
    }
  ) {
    items {
      item {
        amount
        id
        quantity
        sku
      }
    }
    length
    width
    weight
    weightUnit
    height
    id
  }
  shipmentCreateWorkflow(
    input: { orderId: "order_f648793c-2585-4684-afa0-da1fdb0d4f94" }
  ) {
    id
    serviceLevel {
      id
      name
      carrier {
        id
        name
      }
    }

    shipmentCartons {
      id
      tracking {
        number
      }
      label {
        labelImage
        labelFileType
      }
      carton {
        id
        width
        length
        height
        weight
        items {
          item {
            id
            amount
            description
          }
        }
      }
    }
    customsDocuments {
      id
      fileType
      fileUrl
    }
  }
}

Phản hồ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
{
  "data": {
    "shipmentCreateWorkflow": {
      "id": "shipment_90f3c62a-c50e-466c-a317-70ececb26dc4",
      "serviceLevel": {
        "id": "service_level_a7129244-7334-4e8b-8b10-6494b0e49a7d",
        "name": "UPS Worldwide Express",
        "carrier": {
          "id": "carrier_26bf7275-cac2-47b5-979a-4325fa2efa82",
          "name": "UPS"
        }
      },
      "shipmentCartons": [
        {
          "id": "shipment_carton_d254a6df-9dcd-47fc-926b-48eaeaea232c",
          "tracking": {
            "number": "1Z2030216698896462"
          },
          "label": {
            "labelImage": "{{BASE64_ENCODED_IMAGE}}",
            "labelFileType": "PDF",
            "labelAmounts": [
              {
                "amount": 41.88,
                "amountType": "QUOTE"
              }
            ]
          },
          "carton": {
            "id": "carton_0jhg9mxk431q7",
            "width": 10.0,
            "length": 5.0,
            "height": 5.0,
            "weight": 5.0,
            "items": [
              {
                "item": {
                  "id": "item_0jhg9mxdwm77w",
                  "amount": 50,
                  "description": null
                }
              }
            ]
          }
        }
      ],
      "customsDocuments": [
        {
          "id": "customs_doc_d8bedf7a-2de0-4729-8bdd-ebd901b67127",
          "fileType": "PDF",
          "fileUrl": "https://prod-zonos-shipping-label.s3.us-east-2.amazonaws.com/organization_a61090a2-d18b-415c-9870-03b9087cbf2d/shipment_90f3c62a-c50e-466c-a317-70ececb26dc4/customs/International_Forms.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250117T231615Z&X-Amz-SignedHeaders=host&X-Amz-Credential=AKIAR3GS2GP6V4LZE3OI%2F20250117%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Expires=14400&X-Amz-Signature=6c17e358a038c3cd7d61391302909ee503344249405974e490d9b46051c79dba"
        }
      ]
    }
  }
}
3

Hủy một lô hàng

Trong trường hợp khách hàng muốn hủy một lô hàng, bạn có thể sử dụng phép biến đổi sau đây để hủy tất cả các nhãn liên quan đến lô hàng.

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?

Đặt một buổi trình diễn
© 2025 Zonoszonos.com
Trên trang này:
  • Tạo Zonos vận chuyển từ nền tảng của bạn
  • Cho phép khách hàng in nhãn Zonos từ nền tảng của bạn
  • Cho phép khách hàng nhập thông tin xác thực API Zonos
  • Tạo một vận chuyển
  • Hủy một lô hàng