DOCS
BerandaUntuk penyedia logistik Validasi Declaration ID

Label pengiriman | Validasi Declaration ID

Ambil status Declaration ID 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 Declaration ID. Ini menghilangkan kebutuhan pengguna untuk mengisi dokumentasi bea cukai secara manual, menciptakan pengalaman pengiriman yang mulus di mana bea sudah dibayar di muka dan formulir bea cukai diisi secara otomatis.

Isi otomatis deklarasi bea cukai 

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

1. Aktifkan kolom Declaration ID dalam alur pembuatan label

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

2. Kueri status Declaration ID dan detail deklarasi bea cukai

Gunakan kueri berikut untuk mengambil data deklarasi bea cukai lengkap menggunakan Declaration ID. Ini mengembalikan status validasi bersama detail item, nilai, kode HS, dan informasi penerima ketika tersedia

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. Tangani respons dan isi otomatis deklarasi bea cukai

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

Contoh respons

Declaration ID yang valid dengan data bea cukai lengkap:

{
  "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 otomatis dari Declaration ID atau informasi deklarasi yang dimasukkan secara manual.

5. Hubungkan nomor pelacakan ke Declaration ID

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

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

Anda dapat membuat pengiriman yang terikat ke Declaration ID dengan meneruskan array trackingNumbers dan declarationID yang digunakan untuk pengiriman.

Anda juga dapat membuat pengiriman dengan meneruskan declarationID dengan detail tentang karton, dan item dalam karton, Anda dapat meneruskan informasi tersebut dalam shipmentCarton bersama dengan trackingNumber untuk karton tersebut.

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

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

Apakah halaman ini bermanfaat?

Dapatkan dukungan·Dokumen hukum·© 2026 Zonos
Di halaman ini:
  • Label pengiriman | Validasi Declaration ID
  • Isi otomatis deklarasi bea cukai