1
출발지 당사자 생성
Zonos는 이 배송의 출발지를 알 수 없습니다. 왜냐하면 라벨이 Zonos 대시보드에 나타나지 않았기 때문입니다. 적절한 주문 세부정보를 가져올 수 있도록 account와 accountOrderNumber를 referenceId로 포함한 출발지 세부정보로 party를 생성해야 합니다. 이 당사자의 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 주문 ID 가져오기
상인에게 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 코드, 원산지, 가격 등과 같은 정보를 추가, 보완 또는 개선할 수 있습니다.