DOCS

Validasi ID Deklarasi

BerandaUntuk penyedia logistik Validasi ID Deklarasi

Label pengiriman | Validasi ID Deklarasi

Ambil status ID Deklarasi dan isi otomatis dokumentasi bea cukai

Jika Anda membuat label pos, Anda dapat memanggil Zonos untuk mengambil detail deklarasi bea cukai lengkap ketika pengguna memberikan ID Deklarasi. Ini menghilangkan kebutuhan bagi pengguna untuk mengisi dokumentasi bea cukai secara manual, menciptakan pengalaman pengiriman yang mulus di mana bea dibayar di muka dan formulir bea cukai secara otomatis terisi.

Isi otomatis deklarasi bea cukai 

Ikuti langkah-langkah di bawah ini untuk mengaktifkan pengisian otomatis deklarasi bea cukai menggunakan ID Deklarasi dari platform Anda.

1. Aktifkan kolom ID Deklarasi dalam alur pembuatan label

Tambahkan kolom ID Deklarasi ke antarmuka pembuatan label pos Anda. Ketika pengguna memasukkan ID Deklarasi yang valid, platform Anda dapat mengisi otomatis deklarasi bea cukai, menghilangkan entri data manual.

2. Kuery status ID Deklarasi dan detail deklarasi bea cukai

Gunakan kuery berikut untuk mengambil data deklarasi bea cukai lengkap menggunakan ID Deklarasi. Ini mengembalikan status validasi bersama dengan detail item, nilai, kode HS, dan informasi penerima jika tersedia.

Kuery

GraphQL

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
query DeclarationQuery($id: ID!) {
  declaration(id: $id) {
    id
    status
    paymentStatus
    landedCost {
      id
      method
      landedCostGuaranteeCode
      amountSubtotals {
        duties
        taxes
        fees
        landedCostTotal
      }
    }
    items {
      id
      sku
      productId
      amount
      currencyCode
      name
      hsCode
      description
      hsCodeSource
      countryOfOrigin
      quantity
      measurements {
        type
        value
        unitOfMeasure
      }
    }
    parties {
      id
      type
      person {
        firstName
        lastName
        email
        phone
      }
      location {
        id
        line1
        line2
        countryCode
        postalCode
      }
    }
  }
}

Variabel

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Tangani respons dan isi otomatis deklarasi bea cukai

Respons API mencakup status validasi dan data bea cukai. Gunakan informasi status untuk menentukan apakah ID Deklarasi valid, kemudian isi otomatis data bea cukai yang tersedia atau minta untuk entri manual.

Contoh respons

ID Deklarasi Valid dengan data bea cukai lengkap:

Respons

JSON

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
{
  "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. Buat pengiriman

Proses pembuatan label menggunakan data yang diisi secara otomatis dari ID Deklarasi atau informasi deklarasi yang dimasukkan secara manual.

5. Tautkan nomor pelacakan ke ID Deklarasi

Setelah pembuatan label, gunakan mutasi declarationShipmentCreate untuk mengaitkan nomor pelacakan dengan ID Deklarasi, memastikan validasi pembayaran bea yang tepat dan pelacakan pengiriman.

Buat pengiriman

GraphQL

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

Anda dapat membuat pengiriman yang terikat pada ID Deklarasi dengan mengirimkan array trackingNumbers dan declarationID yang digunakan untuk pengiriman.

Variabel tanpa rincian karton

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

Anda dapat membuat pengiriman dengan mengirimkan declarationID yang digunakan untuk pengiriman tersebut. Jika Anda memiliki rincian tentang karton, dan barang-barang di dalam karton, Anda dapat mengirimkan rincian tersebut dalam shipmentCarton bersama dengan trackingNumber untuk karton tersebut.

Variabel dengan rincian karton

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

Apakah halaman ini bermanfaat?

Pesan demo
© 2025 Zonoszonos.com
Di halaman ini:
  • Label pengiriman | Validasi ID Deklarasi
  • Isi otomatis deklarasi bea cukai