Zonos + Japan Post API 模式的運作方式
日本郵政認證帳戶商家直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證，並在每個標籤上包含您的後納號碼，以便郵資帳單至您的帳戶。
在單一 GraphQL 請求中，Zonos 會：
- 驗證您的認證帳戶和後納號碼。
- 代表您呼叫 Japan Post Label API (代碼 52) 來產生標籤和追蹤號碼。
- 為美國關稅預付建立 Declaration ID。
- 透過
declarationShipmentCreate將 Declaration ID 連結至追蹤號碼。 - 將標籤、追蹤號碼和寄件記錄傳回給您。
您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您需要有連結至 Zonos 認證帳戶的 Japan Post 後納號碼 (後納お客様番号)。
您是哪種設置？
每個人都呼叫 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 中建立標籤。