アカウント設定

Verified Account の作成、支払い方法の追加、連携の接続。

ステップ 1 — Verified Account の作成

Česká pošta 登録リンクを使用して Zonos Verified Account に登録します。ビジネス住所と請求セットアップを完了してください。

米国向け配送の関税納付用に Zonos アカウントに支払い方法を追加します。

Zonos Dashboard にログインし Account → Integrations に移動します。表に 2 つのキーが表示されます:

Dashboard 上の名称↕	目的↕	API で使用する？↕
Account key	郵便事業者とのリンク用識別子	❌ いいえ
API key	Zonos API 呼び出し用認証キー	✅ はい — こちらを使用

API key 行のトークンをコピーします。credential_live_ で始まります。両方の連携方法で必要になります。

API key は安全に保管してください。ソースコード管理にコミットしたり公開共有したりしないでください。漏洩が疑われる場合は、同じ Account → Integrations ページから再生成してください。

Zonos Dashboard の Item Quoter ツールで、配送前に商品の推定関税コストを確認できます — rate の確認や事前計画に有用で、Declaration ID は生成しません。

技術セットアップに合った方法を選択してください。どちらの方法も Declaration ID を生成し、 Česká pošta の配送システムにアップロードします。

自社システムから Zonos を直接呼び出す技術者や開発者向け。

エンドポイント

認証

API key を credentialToken ヘッダーで渡します: credentialToken: credential_live_xxxxxxxxxxxxxxxxxx

API 例

完全なリクエストとレスポンスを含む API 例は、Česká pošta アカウントにログインしてご確認ください。

Declaration ID 生成後

Declaration ID を配送詳細とともに Česká pošta に提出します。Česká pošta が Declaration ID を配送にリンクし、追跡番号を返します。Zonos は追跡番号を発行しません。

エラー処理

エラー / 症状↕	考えられる原因と対処法↕
Security requirement failed	API key が無効または誤ったヘッダーで渡されています。API Key（Account Key ではない）を使用し、ヘッダー名が正確に `credentialToken` であることを確認してください。
HTTP 401 Unauthorized	リクエストヘッダーに API key がありません。`credentialToken` が含まれているか確認してください。
`errors` array in response	mutation が GraphQL エラーを返しました。errors 配列の `message` フィールドで詳細を確認してください。
Unexpected response shape	レスポンスに `data.declarationCreate.id` が含まれませんでした。レスポンス本体全体をログし、mutation テキストが例と完全一致するか確認してください。