Declaration ID

查詢 Declaration ID 的稅費繳納狀態並自動填寫海關文件

Declaration ID 有四個用途：

稅費繳納狀態（一律提供） - 告訴您稅費是否已經繳納。
申報狀態（一律提供） - 告訴您這個 Declaration ID 是否已被用於其他寄件。
申報海關詳情（視情況提供） - 完整的海關資料，例如商品、HS 代碼、收件人資訊等。
Declaration ID 與 S10 的連結 - 透過簡單的 mutation，將 Zonos 的 Declaration ID 連結至 S10 追蹤號碼以完成計費。

如果您建立郵政標籤，當使用者提供 Declaration ID 時，您可以呼叫 Zonos 查詢完整的海關申報詳情。這讓使用者不再需要手動填寫海關文件，打造出稅費已預先繳納、海關表單自動帶入的順暢出貨體驗。

自動填寫海關申報

請依照以下步驟，使用來自您平台的 Declaration ID 啟用自動海關申報填寫功能。

1. 在建立標籤流程中啟用 Declaration ID 欄位

在您的郵政標籤建立介面中新增 Declaration ID 欄位。當使用者輸入有效的 Declaration ID 時，您的平台即可自動帶入海關申報資料，省去手動輸入的麻煩。如果您的系統會自動帶入資料，務必取得 declarationId 和 items 資料。您的系統可能還需要使用者提供更準確的相關方、重量與尺寸詳情。

2. 查詢 Declaration ID 以取得狀態與海關詳情

請依照您的需求選擇適當的查詢：

當您同時需要驗證狀態與完整海關申報資料，以便自動帶入海關表單時，請使用這個綜合查詢。此查詢會傳回驗證狀態，並在有資料時一併提供商品詳情、金額、HS 代碼與收件人資訊。

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. 處理回應並自動填寫海關申報

API 回應會包含驗證狀態與海關資料。請使用狀態資訊判斷 Declaration ID 是否有效，然後自動帶入可用的海關資料，或提示使用者手動輸入。

4. 建立寄件

使用來自 Declaration ID 的自動帶入資料，或手動輸入的申報資訊，來處理標籤建立作業。

5. 將追蹤號碼連結至 Declaration ID

建立標籤後，請使用 declarationShipmentCreate mutation 將追蹤號碼與 Declaration ID 連結，確保稅費繳納驗證與寄件追蹤都能正確進行。

建立寄件

1mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {

2 declarationShipmentCreate(input: $input)

3}

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

INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

•