整合您的履行系統與 Zonos GraphQL API,以建立預付關稅的日本郵政標籤。
此部分適用於正在建構程式化日本郵政標籤工作流的工程團隊,該工作流將使用認證帳戶。如果您是沒有開發資源的小型或中型寄件者,請改為參閱在 Dashboard 中建立標籤。
日本郵政認證帳戶商家直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證,並在每個標籤上包含您的後納號碼,以便郵資帳單至您的帳戶。
在單一 GraphQL 請求中,Zonos 會:
declarationShipmentCreate
您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您需要有連結至 Zonos 認證帳戶的 Japan Post 後納號碼 (後納お客様番号)。
每個人都呼叫 Zonos 來建立標籤和清單,所以您永遠不需要提供自己的 Japan Post 認證 (CTID / CT 密碼)。因設置而改變的是您傳遞的 Zonos API 標頭 — 在下方找到您的列,然後使用每個流程的端點和認證部分中的匹配分頁。
credentialToken
accountKey
**BYOA (自帶帳戶):**每個商家持有自己的 Japan Post 認證帳戶,該平臺透過傳遞商家的帳戶金鑰代表該商家建立標籤,而不是在平臺自己的帳戶下寄送。
有兩種整合模式取決於您如何調派包裹。
基礎流程。單一 GraphQL 請求會將寄件從原始輸入 (當事人、項目、包裝) 一直帶到可列印的 Japan Post 標籤。如果您在訂單進來時逐一寄送包裹,請使用此方法。
建立單一寄件 →
延期支付批次流程。在早上打開合併,全天使用單一寄件流程將寄件附加到其中,然後在一天結束時關閉合併,以取得一張 Japan Post 調派單涵蓋整個批次。如果您在一天結束時以一筆交易結算 Japan Post 郵資,而不是逐件包裹進行,請使用此方法。
批次調派 (合併) →
如果您目前使用 Japan Post My Page API (ctCode=52) 建立標籤,您可以保持該整合並新增 Zonos 用於預付關稅的美國標籤。如需欄位對欄位的對應和驗證檢查清單,請參閱使用 Zonos 搭配 My Page API。
ctCode=52
透過 API 建立標籤
透過 API 建立標籤
整合您的履行系統與 Zonos GraphQL API,以建立預付關稅的日本郵政標籤。
此部分適用於正在建構程式化日本郵政標籤工作流的工程團隊,該工作流將使用認證帳戶。如果您是沒有開發資源的小型或中型寄件者,請改為參閱在 Dashboard 中建立標籤。
Zonos + Japan Post API 模式的運作方式
日本郵政認證帳戶商家直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證,並在每個標籤上包含您的後納號碼,以便郵資帳單至您的帳戶。
在單一 GraphQL 請求中,Zonos 會:
declarationShipmentCreate將 Declaration ID 連結至追蹤號碼。您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您需要有連結至 Zonos 認證帳戶的 Japan Post 後納號碼 (後納お客様番号)。
您是哪種設置?
每個人都呼叫 Zonos 來建立標籤和清單,所以您永遠不需要提供自己的 Japan Post 認證 (CTID / CT 密碼)。因設置而改變的是您傳遞的 Zonos API 標頭 — 在下方找到您的列,然後使用每個流程的端點和認證部分中的匹配分頁。
credentialToken(您的)credentialToken(您的) +accountKey(每個商家的)credentialToken(您的)**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。這個頁面有幫助嗎?