API 経由でラベル作成

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

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

Japan Post Verified Account merchant は Zonos を直接呼び出します。Zonos は Japan Post 用の独自 credentials を使用し、各ラベルに Later Pay Number を含めて郵便料金をアカウントに請求します。

1 回の GraphQL リクエストで Zonos は:

1. Verified Account と Later Pay Number を検証します。
2. merchant に代わって Japan Post Label API（code 52）を呼び出し、ラベルと tracking number を生成します。
3. 米国関税前払い用 Declaration ID を作成します。
4. declarationShipmentCreate 経由で Declaration ID を tracking number に紐づけます。
5. ラベル、tracking number、配送レコードを返します。

Japan Post API credentials（CTID / CT password）は不要です。Zonos Verified Account に接続された Japan Post Later Pay Number（後納お客様番号）は必要です。

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

ラベルと manifest の両方を作成するため、全員が Zonos を呼び出します — Japan Post credentials（CTID / CT password）を提供する必要はありません。セットアップによって異なるのは渡す Zonos API headers です — 該当行を見つけ、各 flow の Endpoint and authentication セクションで対応する tab を使用してください。

BYOA（Bring Your Own Account）: 各 merchant が独自 Japan Post Verified Account を保持し、platform が merchant の account key を渡して merchant 代わりにラベルを作成 — platform 自身のアカウントでは配送しません。

2 つの API flow 

parcel の dispatch 方法に応じて 2 つの連携パターンがあります。

単一配送の作成

基本 chain。1 回の GraphQL リクエストで raw inputs（parties、items、packaging）から印刷可能 Japan Post ラベルまで処理。注文ごとに個別 parcel を配送する場合に使用。

単一 shipment の作成 →

バッチ dispatch（consolidation）

後納 batch flow。朝に consolidation を open し、単一 shipment chain で日中 shipment を attach、終業時に close して 1 枚の Japan Post dispatch slip を取得。1 回の transaction で parcel ごとではなく end-of-day に Japan Post 郵便料金を精算する場合に使用。

バッチ dispatch（consolidation） →

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

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