DOCS

Match orders to get customs info

/

Truy xuất tài liệu hải quan cho một đơn hàng

Nhận thông tin hải quan cho một đơn hàng hiện có.

GraphQL

Nếu bạn là đối tác của Zonos và chúng tôi chia sẻ khách hàng chung, bạn có thể sử dụng Clear để cập nhật và truy xuất tài liệu hải quan đầy đủ cho một đơn hàng Zonos hiện có. Bạn có thể truy xuất dữ liệu hải quan trên một lô hàng mà người gửi có thể đã cung cấp thông tin thiếu hoặc không chính xác. Ví dụ, thường thì người gửi cung cấp mô tả kém hoặc không cung cấp mã HS. Zonos có thể thêm, bổ sung hoặc cải thiện thông tin như mô tả, mã HS, quốc gia xuất xứ, giá cả và nhiều hơn nữa.

1

Tạo bên xuất xứ

Zonos sẽ không thể biết được nguồn gốc của lô hàng này vì nhãn không được thể hiện trong bảng điều khiển Zonos. Để đảm bảo rằng chúng tôi có thể lấy lại chi tiết đơn hàng chính xác, bạn cần tạo một party với thông tin xuất xứ bao gồm accountaccountOrderNumber làm referenceId. referenceId cho bên này PHẢI là accountaccountOrderNumber được nối với nhau bằng dấu gạch ngang như trong ví dụ dưới đây.

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
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
  }
}

Biến

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"
    }
  }
}

Phản hồi

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "shipFrom": {
      "id": "party_ac64040b-228e-424c-a090-6da03197011d",
      "location": {
        "countryCode": "US"
      }
    }
  }
}
2

Lấy Zonos orderId

Cung cấp cho Zonos số account của người bán cũng như số accountOrderNumber của họ để khớp các chi tiết từ hệ thống của bạn với order trong hệ thống của chúng tôi. Tài liệu tham khảo API có thể được tìm thấy ở đây.

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
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
        }
      }
    }
  }
}

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
{
  "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

Tạo lô hàng

Bước cuối cùng để lấy thông tin hải quan cho một lô hàng là tạo lô hàng đó. Một phần của quy trình này là tạo shipmentCarton chứa các chi tiết mặt hàng cho lô hàng cần thiết cho customsSpec. Shipment sẽ tự động tạo một đối tượng hải quan nếu bạn truyền true vào trường generateCustoms.

Mutation

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
      }
    }
  }
}

Biến

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"]
      }
    ]
  }
}

Phản hồi

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"
      }
    }
  }
}

Trang này có hữu ích không?