Label pengiriman | Validasi Declaration ID

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

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.

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.