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.
Cho phép khách hàng nhập thông tin xác thực API Zonos
Zonos API 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ừ Zonos Dashboard 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ọ.
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
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
}
itemCreateWorkflow(
input: {
amount: "50"
currencyCode: USD
quantity: 1
sku: "test1"
description: "shoes"
hsCode: "670121"
}
) {
amount
id
sku
}
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_627db90e-d2e2-4499-b388-bfd5d8d33e18" }
) {
id
status
shipmentCartons {
id
label {
id
url
labelAmounts {
amount
amountType
}
}
}
customsDocuments {
id
fileType
fileUrl
}
}
}
Phản hồi
{
"data": {
"shipmentCreateWorkflow": {
"id": "shipment_cd535d6f-c92a-41a9-ae70-f6e67ed30dc9",
"status": "CREATED"
},
"shipmentCartons": [
{
"id": "label_171c7cf5-b005-45cb-bac4-2bfc141dbacb",
"trackingNumber": "794602938880",
"status": "CREATED",
"documentFiling": "ELECTRONIC",
"labelImage": "{{BASE64_ENCODED_IMAGE}}",
"labelAmounts": [
{
"amount": 137.87,
"amountType": "QUOTE"
}
],
"shipmentCarton": "shipment_carton_480d776e-48d8-4699-9b37-bc26c7d0cd1b",
"statusTransitions": [
{
"changedAt": "2024-02-09T18:54:37.158Z",
"note": "Label created",
"status": "CREATED"
}
]
}
]
}
}
Hủy lô hàng
Trong trường hợp khách hàng muốn hủy lô hàng, bạn có thể sử dụng mutation sau đây để hủy tất cả các nhãn liên quan đến lô hàng.
Yêu cầu
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
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 nhân 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:
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.