고객이 귀하의 플랫폼에서 Zonos 라벨을 인쇄할 수 있도록 허용
고객이 귀하의 플랫폼에서 Zonos 라벨을 검색할 수 있도록 하려면 아래 단계를 따르십시오.
1
고객이 자신의 Zonos API 자격 증명을 입력할 수 있도록 허용
Zonos API는 credentialToken으로 접근할 수 있습니다. 귀하의 플랫폼은 고객이 Zonos 대시보드에서 credentialToken을 입력할 수 있는 기능을 제공해야 합니다. 여기에서 귀하는 고객을 대신하여 Zonos에 요청을 할 수 있습니다.
2
배송 생성
label을 검색하려면 label과 연결된 shipment을 생성해야 합니다. Zonos는 동일한 요청에서 shipments 및 labels를 생성하는 워크플로우로 이 프로세스를 관리합니다. 이 변형을 수행할 때 order에 연결된 landedCost에서 사용된 serviceLevel을 사용할 것이므로 serviceLevel을 전달할 필요가 없습니다. orderId에는 Zonos 주문 ID 또는 귀하의 시스템에 이미 있을 가능성이 있는 accountOrderNumber를 사용할 수 있습니다. 배송 및 라벨이 성공적으로 생성되면, 저희는 BASE64_ENCODED_IMAGE인 labelImage로 라벨을 반환하거나 라벨을 가져올 수 있는 url로 반환합니다.
변형
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
}
}
}
응답
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
배송 취소
고객이 배송을 취소하고자 하는 경우, 다음의 변형을 사용하여 배송에 연결된 모든 라벨을 취소할 수 있습니다.
요청
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
}
}
귀하의 플랫폼에서 Zonos 배송 생성
고객이 귀하의 플랫폼에서 Zonos 배송 및 라벨을 생성할 수 있도록 합니다.
귀하가 Zonos 고객이 국제적으로 배송할 수 있도록 지원하는 배송 플랫폼이라면, 배송 생성을 위해 Zonos와 연결하는 것이 최우선 고려 사항이 되어야 합니다. 이를 통해 귀하의 플랫폼의 기존 기능을 활용하면서 Zonos가 배송, 라벨 및 지원 세관 문서 생성을 관리하도록 하여 상인과 고객에게 가장 원활한 경험을 제공할 수 있습니다.
Zonos를 사용하여 배송을 생성하는 장점은 다음과 같습니다:
이 가이드는 귀하의 플랫폼에서 배송을 위해 Zonos를 호출할 수 있도록 완전한 엔드 투 엔드 통합을 구현하는 단계를 안내합니다.