1
発信者情報の作成
Zonos は、この出荷の発信者を知ることができません。なぜなら、ラベルが Zonos ダッシュボードに表示されていないからです。適切な注文の詳細を取得できるようにするためには、party を作成し、account と accountOrderNumber を referenceId として含める必要があります。このパーティの referenceId は、以下の例に示すように、account と accountOrderNumber をハイフンで結合したものでなければなりません。
ミューテーション
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
mutation originParty {
partyCreate(
input: {
referenceId: "100051-O-1434321"
person: {
firstName: "John"
lastName: "Doe"
email: "test@test.com"
phone: "5555555555"
}
location: {
administrativeArea: "Utah"
administrativeAreaCode: "UT"
countryCode: US
line1: "348 N 2450 E"
line2: "#245"
locality: "St George"
postalCode: "84790"
}
type: ORIGIN
}
) {
id
}
}
変数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"shipFrom": {
"type": "ORIGIN",
"referenceId": "root_cd8d3d85-283f-4865-af77-9cda0c123c0a",
"location": {
"administrativeArea": "Utah",
"administrativeAreaCode": "UT",
"countryCode": "US",
"line1": "370 Buena Vista Boulevard",
"locality": "St. George",
"postalCode": "84790"
}
}
}
応答
1
2
3
4
5
6
7
8
9
10
{
"data": {
"shipFrom": {
"id": "party_ac64040b-228e-424c-a090-6da03197011d",
"location": {
"countryCode": "US"
}
}
}
}
2
ZonosのorderIdを取得する
Zonosに対して、マーチャントのaccount番号とaccountOrderNumberを提供し、あなたのシステムの詳細と私たちのシステムのorderを照合します。APIリファレンスこちらで確認できます。
ミューテーション
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
mutation {
orderLink(input: { account: "10051", accountOrderNumber: "1434321" }) {
id
root {
id
parties {
id
type
location {
countryCode
postalCode
}
}
items {
id
description
}
shipmentRatings {
id
}
landedCosts {
amountSubtotals {
duties
taxes
fees
shipping
}
}
}
}
}
応答
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
{
"data": {
"orderLink": [
{
"id": "order_cd6bca4e-6da4-430c-aaf3-7a8b161627a4",
"root": {
"id": "100051-O-1434321",
"parties": [
{
"id": "party_2fdf56a0-2bb2-4443-b8ca-a984d335ffcf",
"type": "ORIGIN",
"location": {
"countryCode": "US",
"postalCode": "84790"
}
},
{
"id": "party_9b3ac542-da12-4869-bcf4-00f42af17f6f",
"type": "DESTINATION",
"location": {
"countryCode": "FR",
"postalCode": "47310"
}
}
],
"items": [
{
"id": "item_c0a329ef-d157-4fa2-8982-be4420717f64",
"description": "Monoprice 4-Port SATA Serial ATA PCI RAID Controller Card, Silicon Image"
},
{
"id": "item_67e9fd3f-8f84-4027-9b06-f6b26915d1d2",
"description": "CORSAIR iCUE H115i RGB PRO XT, 280mm Radiator, Dual 140mm PWM Fans, Software Control, Liquid CPU Cooler, CW-9060044-WW LGA 1700 Compatible"
}
],
"shipmentRatings": [
{
"id": "shipment_rating_fc73d892-1336-47c5-a620-40903388332d"
}
],
"landedCosts": [
{
"amountSubtotals": {
"duties": 53.67,
"taxes": 147.89,
"fees": 42.37,
"shipping": 15.0
}
}
]
}
}
]
}
}
3
出荷を作成する
出荷のための税関情報を取得する最終ステップは、出荷自体を作成することです。このフローの一部は、customsSpecに必要な出荷のアイテム詳細を含むshipmentCartonを作成することです。generateCustomsフィールドにtrueを渡すと、shipmentは自動的に税関オブジェクトを生成します。
ミューテーション
1
2
3
4
5
6
7
8
9
10
11
12
13
mutation CreateShipment($createShipment: ShipmentCreateInput!) {
shipmentCreate(input: $createShipment) {
id
customSpec {
id
}
shipmentCartons {
carton {
id
}
}
}
}
変数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"createShipment": {
"orderId": "order_3a369733-3046-4390-b0a4-99a2f8a1c2a2",
"trackingNumber": "12345",
"generateCustoms": true,
"parties": [
"party_2fdf56a0-2bb2-4443-b8ca-a984d335ff3g",
"party_5c928cde-67fa-4ee4-b77a-2628fbcd5ac9"
],
"serviceLevel": "custom.custom",
"shipmentCartons": [
{
"height": 10,
"length": 10,
"width": 10,
"weight": 1,
"items": ["item_8a0ecee9-42ff-4544-9610-8e8d679ef0a3"]
}
]
}
}
応答
1
2
3
4
5
6
7
8
9
10
{
"data": {
"shipmentCreate": {
"id": "shipment_a125e480-369c-4606-abf8-ff34295b15cb",
"customSpec": {
"id": "customsSpec_a19875ec-b85c-11ed-afa1-0242ac120002"
}
}
}
}
注文のカスタム文書を取得する
既存の注文のカスタム情報を取得します。GraphQL
あなたが Zonos のパートナーであり、相互の顧客を共有している場合、Clear を使用して、既存の Zonos 注文の完全なカスタム文書を更新および取得できます。発送者が欠落または不正確な情報を提供した場合、出荷に関するカスタムデータを取得できます。たとえば、発送者が不十分な説明を提供したり、HSコードを提供しなかったりすることは一般的です。Zonos は、説明、HSコード、原産国、価格などの情報を追加、補足、または改善できます。