注文設定

各注文商品には、1件以上のmetadataエントリ（key と value）を持てます。プラットフォームは注文作成時にZonosへ送信します。デフォルトではZonosはmetadataを保存しますが、注文内訳には表示しません。

設定ページでキーを追加すると、Zonosは各商品でそのキーを探し、一致する値を商品の下に追加行として表示します。

• 同一キーの複数値はカンマで結合されます（例：red, large）。
• キーを持たない商品には行が表示されず、注文詳細がすっきり保たれます。
• キーは組織全体で設定され、組織内の全ユーザーが同じmetadata行を見ます。

一般的な用途：

• 彫刻・パーソナライズ — engraving-text キーを表示し、倉庫が出荷前のカスタム作業を把握。
• ギフト注文 — gift-message や gift-wrap キーで、梱包時に適切な同封物を準備。
• サブスクリプション・ロイヤルティ — subscription-id や loyalty-tier をサポート・fulfillmentの文脈表示に利用。
• カスタムプラットフォームフィールド — チームが注文で確認したい商品レベルの任意フィールド。

1. Dashboard -> Settings -> Orders -> Preferences に移動します。
2. Metadata keys フィールドに、プラットフォームが送信する正確なキー名（例：engraving-text）を入力します。
3. Add をクリックします。

キーはすべての注文詳細ページに即時反映されます。metadataを持つ商品の下に新しい行が表示されるか、任意の注文内訳で確認してください。

キー名は大文字小文字を区別し、プラットフォームの送信値と完全一致する必要があります。正確なキーが不明な場合は、最近の注文のraw metadataを確認するか、開発者に問い合わせてください。

1. Dashboard -> Settings -> Orders -> Preferences に移動します。
2. リストから削除するキーを見つけます。
3. 行右側のゴミ箱アイコンをクリックします。

注文内訳からその行は表示されなくなります（新規・既存の注文両方）。

注文詳細ページに行が表示されない

• キー名が大文字小文字・ハイフン・アンダースコアを含め完全一致しているか確認してください（engraving-text と Engraving_Text は異なります）。
• その注文商品に実際にmetadataがあるか確認してください。プラットフォームがキー送信を開始する前の古い注文には含まれない場合があります。

行は表示されるが空

• プラットフォームが空の値でキーを送信しています。統合側で値が設定されているか確認してください。

一部の商品にのみキーが表示される

• 想定どおりです — metadataは商品単位です。プラットフォームがキーを送信した商品にのみ行が表示されます。