DOCS

Xác thực Declaration ID

Nhãn vận chuyển | Xác thực Declaration ID

Lấy trạng thái Declaration ID và tự động điền tài liệu hải quan

Nếu bạn tạo nhãn bưu điện, bạn có thể gọi Zonos để lấy chi tiết khai báo hải quan đầy đủ khi người dùng cung cấp Declaration ID. Điều này loại bỏ nhu cầu người dùng phải điền tài liệu hải quan thủ công, tạo ra trải nghiệm vận chuyển liền mạch với thuế được thanh toán trước và các biểu mẫu hải quan được tự động điền.

Tự động điền khai báo hải quan 

Làm theo các bước dưới đây để kích hoạt tính năng tự động điền khai báo hải quan bằng cách sử dụng Declaration ID từ nền tảng của bạn.

1. Bật trường Declaration ID trong luồng tạo nhãn

Thêm trường Declaration ID vào giao diện tạo nhãn bưu điện của bạn. Khi người dùng nhập Declaration ID hợp lệ, nền tảng của bạn có thể tự động điền khai báo hải quan, loại bỏ nhập dữ liệu thủ công.

2. Truy vấn trạng thái Declaration ID và chi tiết khai báo hải quan

Sử dụng truy vấn sau để lấy dữ liệu khai báo hải quan đầy đủ bằng cách sử dụng Declaration ID. Điều này trả về trạng thái xác thực cùng với chi tiết mục, giá trị, mã HS và thông tin người nhận khi có sẵn

1query DeclarationQuery($id: ID!) {
2 declaration(id: $id) {
3 id
4 status
5 paymentStatus
6 landedCost {
7 id
8 method
9 landedCostGuaranteeCode
10 amountSubtotals {
11 duties
12 taxes
13 fees
14 landedCostTotal
15 }
16 }
17 items {
18 id
19 sku
20 productId
21 amount
22 currencyCode
23 name
24 hsCode
25 description
26 hsCodeSource
27 countryOfOrigin
28 quantity
29 measurements {
30 type
31 value
32 unitOfMeasure
33 }
34 }
35 parties {
36 id
37 type
38 person {
39 firstName
40 lastName
41 email
42 phone
43 }
44 location {
45 id
46 line1
47 line2
48 countryCode
49 postalCode
50 }
51 }
52 }
53}

3. Xử lý phản hồi và tự động điền khai báo hải quan

Phản hồi API bao gồm trạng thái xác thực và dữ liệu hải quan. Sử dụng thông tin status để xác định xem Declaration ID có hợp lệ không, sau đó tự động điền dữ liệu hải quan có sẵn hoặc nhắc nhập thủ công.

Ví dụ về phản hồi

Declaration ID hợp lệ với dữ liệu hải quan đầy đủ:

{
  "data": {
    "declaration": {
      "id": "0mm1993s0mdcn",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "landedCost": {
        "id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
        "method": "DAP",
        "landedCostGuaranteeCode": "NOT_APPLICABLE",
        "amountSubtotals": {
          "duties": 0.0,
          "taxes": 0.0,
          "fees": 2.62,
          "landedCostTotal": 2.62
        }
      },
      "items": [
        {
          "id": "item_0mm199388v57g",
          "sku": "item_1",
          "productId": "item_1",
          "amount": 70.0,
          "currencyCode": "USD",
          "name": "Item 1",
          "hsCode": "9504.90.4000",
          "description": "This is the description for Item 1",
          "hsCodeSource": "TARIFF_COMPLETED",
          "countryOfOrigin": "CN",
          "quantity": 2,
          "measurements": [
            {
              "type": "WEIGHT",
              "value": 1,
              "unitOfMeasure": "POUND"
            }
          ]
        }
      ],
      "parties": [
        {
          "id": "party_0kesb32rw5hfa",
          "type": "DESTINATION",
          "person": {
            "firstName": "test",
            "lastName": "origin",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
            "line1": "123 Test Street",
            "line2": "",
            "countryCode": "US",
            "postalCode": "84790"
          }
        },
        {
          "id": "party_0mjfz59bgg175",
          "type": "ORIGIN",
          "person": {
            "firstName": "test",
            "lastName": "destination",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_0mdzb9vk8bp7c",
            "line1": "998 Ridgehaven",
            "line2": null,
            "countryCode": "CA",
            "postalCode": "N0N 0N0"
          }
        }
      ]
    }
  }
}

4. Tạo lô hàng

Xử lý việc tạo nhãn bằng cách sử dụng dữ liệu được điền tự động từ Declaration ID hoặc thông tin khai báo được nhập thủ công.

5. Liên kết số theo dõi với Declaration ID

Sau khi tạo nhãn, sử dụng mutation declarationShipmentCreate để liên kết số theo dõi với Declaration ID, đảm bảo xác thực thanh toán thuế đúng cách và theo dõi lô hàng.

1mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {
2 declarationShipmentCreate(input: $input)
3}

Bạn có thể tạo lô hàng được liên kết với Declaration ID bằng cách chuyển một mảng trackingNumbersdeclarationID được sử dụng cho lô hàng.

Bạn cũng có thể tạo lô hàng bằng cách chuyển declarationID với chi tiết về các thùng hàng và mục trong các thùng hàng, bạn có thể chuyển những thông tin đó trong shipmentCarton cùng với trackingNumber cho thùng hàng đó.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

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