API 経由でラベル作成

このセクションは、Verified Accounts を使用して Japan Post ラベルをプログラムで作成するワークフローを構築するエンジニアリングチーム向けです。開発リソースのない中小規模の荷主の場合は、Dashboard でラベル作成 を参照してください。

Zonos + Japan Post API モデルの仕組み 

Japan Post Verified Account の販売者は Zonos を直接呼び出します。Zonos は Zonos 独自の Japan Post 認証情報を使用し、すべてのラベルにお客様の Later Pay Number を含めるため、郵便料金はお客様のアカウントに請求されます。

1 回の GraphQL リクエストで、Zonos は次の処理を行います。

1. Verified Account と Later Pay Number を検証します。
2. お客様に代わって Japan Post Label API（code 52）を呼び出し、ラベルと追跡番号を生成します。
3. 関税前払い用 Declaration ID を作成します。
4. declarationShipmentCreate を使用して Declaration ID を追跡番号に紐づけます。
5. ラベル、追跡番号、出荷レコードをお客様に返します。

お客様ご自身の Japan Post API 認証情報（CTID / CT パスワード）は不要です。ただし、Zonos Verified Account に接続された Japan Post の Later Pay Number（後納お客様番号）は必要です。

どのセットアップですか？ 

どのセットアップでも、ラベルと manifest の両方の作成に Zonos を呼び出すため、ご自身の Japan Post 認証情報（CTID / CT パスワード）を提供する必要はありません。セットアップによって異なるのは、渡す Zonos API ヘッダーです。下の表で該当するセットアップを確認し、各フローの エンドポイントと認証 セクションで対応するタブを使用してください。

BYOA（Bring Your Own Account）: 各販売者が独自の Japan Post Verified Account を保持し、プラットフォームは自身のアカウントで出荷するのではなく、販売者の account key を渡してその販売者に代わってラベルを作成します。

2 つの API フロー 

小包の差し出し方法に応じて、2 つの連携パターンがあります。

単一出荷の作成

基本となる一連の処理です。1 回の GraphQL リクエストで、元の入力データ（当事者、商品、梱包）から印刷可能な Japan Post ラベルまでを一括で処理します。注文が入るたびに小包を個別に出荷する場合に使用します。

単一出荷の作成 →

バッチ dispatch（consolidation）

後納のバッチフローです。朝に consolidation をオープンし、日中は単一出荷の処理で作成した出荷を追加し、終業時に consolidation をクローズすると、バッチ全体をまとめた 1 枚の Japan Post dispatch slip が発行されます。Japan Post の郵便料金を小包ごとではなく、終業時に 1 回の取引でまとめて精算する場合に使用します。

バッチ dispatch（consolidation） →

すでに Japan Post My Page API を使用していますか？ 

現在 Japan Post My Page API（ctCode=52）でラベルを作成している場合は、その連携を維持したまま、関税前払いの米国向けラベルに Zonos を追加できます。フィールドごとの対応表と検証チェックリストについては、My Page API と Zonos の併用 を参照してください。