Zonos + Japan Post API 模型的運作方式
Japan Post 已驗證帳戶商人直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證，並在每個標籤上包含您的後納客戶號碼，以便郵資計入您的帳戶。
在單個 GraphQL 請求中，Zonos 執行以下操作：
- 驗證您的已驗證帳戶和後納客戶號碼。
- 代表您呼叫 Japan Post 標籤 API (代碼 52)，以產生標籤和追蹤編號。
- 為美國稅務預付建立申報 ID。
- 透過
declarationShipmentCreate將申報 ID 連結到追蹤編號。 - 將標籤、追蹤編號和出貨記錄傳回給您。
您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您確實需要您的 Japan Post 後納客戶號碼 (後納お客様番号) 連結到您的 Zonos 已驗證帳戶。
您的設置是哪種？
所有人都呼叫 Zonos 來建立標籤和清單，因此您永遠不需要提供自己的 Japan Post 認證 (CTID / CT 密碼)。根據您的設置而改變的是您傳遞的 Zonos API 標頭——請在下方找到您的行，然後在每個流程的端點和身份驗證部分中使用匹配的標籤。
| ↕ | 電商商人↕ | 運輸平台 (BYOA)↕ | 3PL / 物流合作夥伴 / 轉售商↕ |
|---|---|---|---|
| 您是誰 | 運送您自己訂單的品牌 | 許多商人透過其建立標籤的平台 | 代表許多商人客戶託運的合作夥伴 |
| 您設置的已驗證帳戶 | 一個已驗證帳戶 (您的) | 每個商人設置他們自己的；您代表他們託運 | 一個用於所有託運商的已驗證帳戶 |
| 要傳遞的 Zonos API 標頭 | credentialToken (您的) 只 | credentialToken (您的) + accountKey (每個商人的) | credentialToken (您的) 只 |
| 其後納客戶號碼計費的郵資 | 您的 | 每個商人的 | 您的 |
| Zonos 為稅務向誰開發票 | 您 | 每個商人 | 您 |
BYOA (自帶帳戶): 每個商人持有自己的 Japan Post 已驗證帳戶，該平台透過傳遞商人的帳戶金鑰代表該商人建立標籤，而不是在該平台自己的帳戶下託運。
兩個 API 流程
根據您如何調度包裹，有兩種整合模式。
建立單個出貨
基礎鏈。一個 GraphQL 請求將出貨從原始輸入 (方、項目、包裝) 一路帶到可列印的 Japan Post 標籤。如果您在訂單進入時逐個運送包裹，請使用此方法。
批量調度 (整合)
延遲付款批量流程。在早上開啟整合，全天使用單個出貨鏈將出貨附加到它，然後在營業時間結束時關閉整合以獲得一份涵蓋整個批次的 Japan Post 調度單。如果您在一天結束時在一筆交易中結算 Japan Post 郵資而不是逐個包裹，請使用此方法。
已在使用 Japan Post My Page API？
如果您目前使用 Japan Post My Page API (ctCode=52) 建立標籤，您可以保留該整合並為應稅預付美國標籤新增 Zonos。請參閱使用 Zonos 搭配 My Page API 以獲得逐欄位映射和驗證檢查清單。
透過 API 建立標籤
整合您的履行系統與 Zonos GraphQL API，以建立費用預付的日本郵政標籤。
本節適用於正在構建將使用已驗證帳戶的程式化日本郵政標籤工作流的工程團隊。如果您是沒有開發資源的中小型託運商，請改為查看在 Dashboard 中建立標籤。