如果提供了申報 ID
- 從請求中接受申報 ID
- 呼叫 Zonos API 驗證申報 ID 有效且已關聯到已支付的申報
- 如果驗證成功，建立配送並生成標籤
- 在派發前透過
declarationShipmentCreate呼叫將追蹤號碼關聯到 Zonos API 中的申報 ID
如果提供了帳戶金鑰
- 從請求中或託運人的已儲存帳戶檔案中接受帳戶金鑰
- 使用帳戶金鑰執行
declarationCreate呼叫到 Zonos API 並返回有效的申報 ID - 建立配送並生成標籤
- 在派發前透過
declarationShipmentCreate呼叫將追蹤號碼關聯到 Zonos API 中的申報 ID
如果都未提供
拒絕標籤建立請求，並顯示錯誤訊息，說明寄往美國的配送需要有效的申報 ID 或帳戶金鑰。
第三方配送平台需求
第三方配送平台的開發人員必須：
- 為郵政營運商提供申報 ID 輸入欄位，與其他標籤數據項目並列
- 在託運人設定檔設定中支援儲存帳戶金鑰
- 將提供的值傳遞給郵政營運商的配送/標籤建立 API
- 將與申報 ID 相關聯的追蹤號碼寫回 Zonos
實現優勢
透過在郵政營運商的配送/標籤建立 API 中集中此驗證邏輯，郵政網站和第三方平台都可以保持輕量級，只需傳遞申報 ID 或帳戶金鑰。API 處理驗證、標籤建立、追蹤關聯和非合規配送的拒絕。
寄往美國包裹的標籤建立流程
透過申報 ID 或帳戶金鑰確保預付稅費合規性
郵政營運商必須更新其配送/標籤建立 API，在允許寄往美國的配送進入網路前驗證預付稅費。無論標籤是透過郵政營運商自己的網站或第三方配送平台生成，此 API 邏輯都相同。
關鍵是郵政營運商的 API 必須在建立標籤前要求提供申報 ID 或帳戶金鑰。如果都未提供，標籤請求必須被拒絕。這確保所有配送在派發前都已將預付稅費証明與海關數據關聯。