整合您的履行系統與 Zonos GraphQL API,以建立關稅預付的日本郵政標籤。
本節適用於正在構建將使用已驗證帳戶的程式化日本郵政標籤工作流的工程團隊。如果您是沒有開發資源的中小型託運商,請改為查看在 Dashboard 中建立標籤。
Japan Post 已驗證帳戶商人直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證,並在每個標籤上包含您的後納客戶號碼,以便郵資計入您的帳戶。
在單個 GraphQL 請求中,Zonos 執行以下操作:
declarationShipmentCreate
您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您確實需要您的 Japan Post 後納客戶號碼 (後納お客様番号) 連結到您的 Zonos 已驗證帳戶。
所有人都呼叫 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 模型的運作方式
Japan Post 已驗證帳戶商人直接呼叫 Zonos。Zonos 使用自己的 Japan Post 認證,並在每個標籤上包含您的後納客戶號碼,以便郵資計入您的帳戶。
在單個 GraphQL 請求中,Zonos 執行以下操作:
declarationShipmentCreate將申報 ID 連結到追蹤編號。您不需要自己的 Japan Post API 認證 (CTID / CT 密碼)。您確實需要您的 Japan Post 後納客戶號碼 (後納お客様番号) 連結到您的 Zonos 已驗證帳戶。
您的設置是哪種?
所有人都呼叫 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 以獲得逐欄位映射和驗證檢查清單。這個頁面有幫助嗎?