運輸平台和標籤

聲明 ID 是必須新增至郵政標籤建立系統（API 和線上運輸介面）的新欄位，以支援包裝級別的預付稅金驗證。此欄位可針對下列使用案例進行驗證：

第一個使用案例：在結帳時支付稅金

當使用您的郵政服務的電子商務商家有客戶在結帳時支付進口稅金時，商家將提供來自訂單的唯一聲明 ID。您的標籤建立系統必須接受此聲明 ID，以表示運送的稅金已預付。

第二個使用案例：透過 Zonos Prepay 應用程式支付稅金 

Zonos 行動應用程式 (iOS 和 Android) 允許個人透過拍攝他們要運送到美國的物品的圖片來預付稅金。應用程式計算稅金並提示付款。付款後，使用者會收到一個聲明 ID，必須在標籤建立期間輸入您的郵政系統中。

在您的系統中實施

• 對於您的標籤 API：將 declaration_id 欄位（或類似欄位）新增至標籤建立端點，第三方平台在透過 API 建立標籤時可填入。
• 對於您的線上運輸介面：在運輸表格中新增聲明 ID 輸入欄位，客戶可輸入其聲明 ID。

如果使用者沒有聲明 ID 

對於沒有聲明 ID 的使用者，在您的系統中實施包含三個選項的指導：

1. 使用 Zonos Prepay 應用程式 – 指引使用者下載應用程式預付稅金
2. 建立 Zonos 驗證帳户 – 適用於定期運送的商業客戶
3. 建立郵政商業帳户 – 如果您提供直接稅金徵收服務

或者，您可以與 Zonos 合作，直接在您的運輸系統中提供稅金徵收，讓您在單一交易中同時徵收運費和稅金。

帳户密鑰是授權商業運送人的唯一識別符 (類似 API 金鑰)，無需他們在每次運送時輸入聲明 ID。帳户密鑰可從您的郵政運營商或直接從 Zonos 取得。

實施要求

• 客戶帳户管理：您的系統需要設定，商業客戶可在其運輸帳户設定檔中保存其帳户密鑰
• API 整合：保存帳户密鑰後，您的系統應在標籤建立期間透過 Zonos API 動態產生聲明 ID，無需商業客戶進行手動輸入
• 計費整合：帳户密鑰的存在表示該客戶的所有運送都被視為預付，Zonos 直接向授權運送人開立稅金發票

您的標籤建立系統產生追蹤號碼後，您必須立即使用與運送的聲明 ID 相關的追蹤號碼更新 Zonos。此步驟對於郵政網路全程的符合規範驗證至關重要。

API 實施 

您的標籤建立系統必須使用唯一聲明 ID 和對應的追蹤號碼呼叫 Zonos API。此 API 呼叫必須：

• 在標籤產生後立即發生
• 在運送被派送前
• 作為標籤完成流程的一部分

關鍵：如果追蹤號碼未連結至聲明 ID，運送可能被視為未支付並被拒絕進入美國。

您的標籤產生系統必須透過在運輸標籤上包含視覺標記和可掃描的 QR 代碼來清楚地識別稅金已支付的運送。

標籤標記實施

呼叫 Zonos API 以擷取包含 QR 代碼和稅金已支付標記的標準化影像：

API 端點：

https://api.zonos.com/graphql

標籤放置選項

選項 1—分開的符合規範標籤：產生第二個標籤，僅包含預付標記和 QR 代碼，以與主要運輸標籤一起列印。

選項 2—嵌入主要標籤中：將預付標記直接整合至您的運輸標籤範本中，放在靠近海關申報部分 (CN22/CN23) 的明顯位置，最好在右上角或右下角。

QR 代碼必須清楚地列印，並放在郵政工作人員或美國海關官員可掃描的位置。