帳戶金鑰

為經驗證的組織使用帳戶金鑰自動產生申報 ID 和進行關稅徵收。

申報 ID 可透過帳戶金鑰由郵政營運商和運送平台代表經驗證帳戶產生。帳戶金鑰無需手動進行關稅徵收，同時能進行自動計費以及遵守郵政 DDP 要求。

帳戶金鑰是一個獨特的授權憑證（類似於 API 金鑰），允許已獲核准的組織代表其使用者徵收關稅，無需為每次寄送產生個別申報 ID。帳戶金鑰代表對關稅付款負最終責任的一方。

帳戶金鑰如何運作

擁有帳戶金鑰的 Zonos 組織可在建立標籤時動態產生申報 ID，同時確保關稅付款合規性，打造無縫的運送體驗。

主要優勢：

不需手動輸入申報 ID，自動進行關稅徵收
透過 Zonos 發票簡化計費流程
完全符合郵政 DDP 要求
與現有運送工作流程無縫整合

使用案例範例

如果運送平台取得自己的帳戶金鑰，他們可使用此金鑰代表其使用者產生申報 ID。在此情況下：

運送平台向使用者徵收關稅
Zonos 根據從帳戶金鑰產生的申報 ID 向運送平台開具關稅發票
使用者享受無縫運送體驗，無需手動進行關稅程序

組織可根據特定的使用案例和與 Zonos 的關係，透過 Zonos Dashboard 取得帳戶金鑰。

產生申報 ID

擁有帳戶金鑰的組織可透過 Zonos API 為寄送動態產生個別申報 ID。使用完整的完全著陸成本工作流程時，需要下列輸入參數：

必需的輸入參數

partyCreateWorkflowInput

識別所涉及的參與方及其位置。

欄位↕	描述↕	必需↕
location	運送參與方的位置資訊	是
countryCode	國家的兩個字母 ISO 代碼	是
line1	地址的第一行	是
postalCode	地址的郵遞區號或郵編	是
type	參與方類型：`DESTINATION` 或 `ORIGIN`	是

1"partyInput": [

2 {

3 "location": {

4 "countryCode": "US"

itemCreateWorkflowInput

列出購物車中的項目。

欄位↕	描述↕	必需↕
amount	項目的價格	是
currencyCode	項目金額的貨幣代碼	是
quantity	項目的數量	是
description	項目的描述	是
countryOfOrigin	產品的製造地	建議
hsCode	項目的 HS 代碼	建議

1"itemInput": [

2 {

3 "amount": 700,

4 "currencyCode": "USD",

5 "description": "This is the description for Item 1",

6 "hsCode": "1234.56.7890",

7 "countryOfOrigin": "CA",

8 "quantity": 2

9 }

10]

cartonsCreateWorkflowInput

寄送的容器資訊。

1"cartonInput": [

2 {

3 }

4]

shipmentRatingCreateWorkflowInput

傳達運送成本。雖然對美國來說運送不需徵稅，但計算完全著陸成本需要一個值。

欄位↕	描述↕	必需↕
amount	運送成本	是
currencyCode	運送成本的貨幣代碼	是
serviceLevelCode	表示運送服務等級的代碼	是

1"shipmentRatingInput": {

2 "currencyCode": "CAD",

3 "amount": 0,

4 "serviceLevelCode": "canada_post.custom"

5}

landedCostWorkFlowInput

規定完全著陸成本計算的偏好。

欄位↕	描述↕	選項↕
calculationMethod	您計畫如何運送	`DDP`（預付關稅和稅費）或 `DAP`（在交付時支付關稅）
endUse	商品用途	`FOR_RESALE`（企業對企業）或 `NOT_FOR_RESALE`（消費者）

1"landedCostInput": {

2 "endUse": "NOT_FOR_RESALE",

3 "calculationMethod": "DDP",

4 "currencyCode": "CAD"

5}

declarationCreateWorkflowInput

建立將與寄送關聯的申報 ID。

欄位↕	描述↕	選項↕
source	申報 ID 的來源	`DIRECT`（帳戶金鑰）或 `POST`（郵局櫃檯）

1"declarationInput": {

2 "source": "DIRECT"

3}

API 範例

下面是使用帳戶金鑰產生申報 ID 的完整 GraphQL 變動。

使用此方法進行基本申報 ID 建立，無需完整的完全著陸成本計算。

1mutation declarationCreate($input: DeclarationCreateInput!) {

2 declarationCreate(input: $input) {

3 id

4 status

5 paymentStatus

6 source

7 organizationId

8 parties {

9 id

10 }

11 items {

12 id

13 }

14 landedCost {

15 id

16 currencyCode

17 }

18 }

19}

完整工作流程變數和回應

1{

2 "partyInput": [

3 {

4 "location": {

5 "countryCode": "US",

6 "line1": "123 Test Street",

7 "locality": "St. George",

8 "postalCode": "84790"

9 },

10 "type": "DESTINATION"

11 },

12 {

13 "location": {

14 "countryCode": "CA"

15 },

16 "type": "ORIGIN"

17 }

18 ],

19 "itemInput": [

20 {

21 "amount": 700,

22 "currencyCode": "USD",

23 "description": "This is the description for Item 1",

後續步驟

如需更全面的技術詳細資訊和廣泛文件，請訪問我們的 Zonos GraphQL API 參考開發人員網站。此資源提供 API 端點、GraphQL 變動和帳戶金鑰實作的詳細技術資訊。

•