> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# プロダクト

> 商品カタログの作成と管理

## プロダクト管理

プロダクトページは、商品カタログ全体を管理する場所です。単発購入商品またはサブスクリプション商品を作成できます。

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=2068cb755f3bad4349d93aadbaa7a94f" alt="Products List" width="1440" height="900" data-path="images/dashboard/products-list.png" />
</Frame>

## プロダクトリスト

プロダクトはテーブル形式で表示されます：

| 列     | 説明                          |
| ----- | --------------------------- |
| 名前    | プロダクト名と画像サムネイル              |
| 価格    | 価格、通貨、請求サイクル                |
| ステータス | 有効または無効                     |
| 登録者数  | アクティブなサブスクリプション数（サブスク商品の場合） |
| 作成日   | 作成日時                        |
| アクション | 編集、リンクコピー、ステータス切替           |

## プロダクトの作成

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-create.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=afb107e0fe3b6c245f273109473fca24" alt="Create Product" width="1440" height="900" data-path="images/dashboard/products-create.png" />
</Frame>

<Steps>
  <Step title="「プロダクトを作成」をクリック">
    プロダクトページの右上にあるボタンを見つけます。
  </Step>

  <Step title="基本情報を入力">
    **必須フィールド：**

    * プロダクト名
    * 価格
    * 通貨
    * 価格タイプ（単発またはサブスクリプション）
  </Step>

  <Step title="詳細を追加（オプション）">
    * プロダクト説明（Markdown対応）
    * プロダクト画像
    * 税設定
  </Step>

  <Step title="サブスクリプション設定">
    サブスクリプション商品のみ：

    * 請求サイクル
    * 試用期間（オプション）
  </Step>

  <Step title="プロダクトを保存">
    「作成」をクリックしてプロダクトを公開。
  </Step>
</Steps>

## プロダクトフィールド

### 基本情報

| フィールド | 必須  | 説明                    |
| ----- | --- | --------------------- |
| 名前    | はい  | 表示名（顧客に表示）            |
| 説明    | いいえ | Markdown形式のプロダクト詳細    |
| 画像    | いいえ | プロダクト画像（推奨：400x400px） |

### 価格設定

| フィールド | オプション                      | 説明              |
| ----- | -------------------------- | --------------- |
| 価格    | 数値                         | プロダクト価格（最小通貨単位） |
| 通貨    | USD、EUR、GBP、CNY、JPY、HKD など | 取引通貨            |
| 価格タイプ | 単発、サブスクリプション               | 支払いモード          |
| 税カテゴリ | SaaS、デジタル商品、ソフトウェア、電子書籍など  | 税計算ルール          |
| 税の扱い  | 税込、税抜                      | 価格に税が含まれるか      |

### 価格の上下限

各通貨には設定可能な最低価格と最高価格があります。範囲外の価格は商品の保存時に拒否されます。

| 通貨  |       最低 |            最高 |
| --- | -------: | ------------: |
| USD |   \$1.00 |    \$7,500.00 |
| EUR |    €1.00 |     €7,400.00 |
| GBP |    £1.00 |     £6,400.00 |
| JPY |     ¥100 |    ¥1,250,000 |
| HKD | HK\$8.00 | HK\$61,000.00 |

<Note>
  CNY はダッシュボードの分析ビューで表示通貨として利用できますが、現時点では商品の価格設定通貨としては利用できません。
</Note>

### サブスクリプション設定

サブスクリプション商品のみ：

| フィールド   | オプション        | 説明             |
| ------- | ------------ | -------------- |
| サイクル    | 週次、月次、四半期、年次 | 請求頻度           |
| トライアル有効 | はい/いいえ       | 無料試用を提供        |
| 試用日数    | 数値           | 試用期間（デフォルト：7日） |

### 税設定

| フィールド | オプション       | 説明         |
| ----- | ----------- | ---------- |
| 税カテゴリ | SaaS、デジタル商品 | 税計算ルール     |
| 税の扱い  | 税込、税抜       | 価格に税が含まれるか |

## プロダクトステータス

<CardGroup cols={2}>
  <Card title="有効" icon="check">
    * プロダクトが公開中で購入可能
    * 支払いリンクが有効
    * チェックアウトで表示される
  </Card>

  <Card title="無効" icon="pause">
    * プロダクトが非表示
    * 支払いリンクはエラーを返す
    * 既存のサブスクリプションは継続
  </Card>
</CardGroup>

ステータスを切り替えるには、プロダクト行のスイッチを使用するか、プロダクトを編集します。

## プロダクトの編集

1. プロダクト行または編集アイコンをクリック
2. 任意のフィールドを変更
3. 「変更を保存」をクリック

<Warning>
  サブスクリプション商品の価格変更は、新規登録者にのみ影響します。既存の登録者は元の価格を維持します。
</Warning>

## プロダクト購入リンク

各プロダクトには有効期限のない恒久的な購入リンクが発行されます：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}
```

テストモード：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}/test
```

**リンクの取得：**

* 任意のプロダクトの「リンクをコピー」ボタンをクリック
* 高度なユースケースでは、API でカスタムパラメータ付きのチェックアウトセッションを作成（動的リンク、TTL は 7 日間）

**テスト vs 本番：**

* ダッシュボード上部でテストモードを切り替えると、テストリンクでプレビューできます
* テストリンクには `/test` サフィックスが付きます

## ベストプラクティス

<AccordionGroup>
  <Accordion title="プロダクト命名">
    * 明確で説明的な名前を使用
    * サブスクリプション商品には請求サイクルを含める（例：「プロ - 月額」）
    * 特殊文字を避ける
  </Accordion>

  <Accordion title="説明">
    * 主要機能をリストアップ
    * 箇条書きで読みやすく
    * 顧客が得られるものを含める
    * サポートや保証について言及
  </Accordion>

  <Accordion title="画像">
    * 高品質画像を使用（最小400x400px）
    * PNGまたはJPG形式
    * ファイルサイズは2MB以内
    * プロダクト間で一貫したスタイル
  </Accordion>

  <Accordion title="価格戦略">
    * 競合の価格を調査
    * 地域の購買力を考慮
    * 年間割引を提供（通常15-20%オフ）
    * わかりやすい整数価格
  </Accordion>
</AccordionGroup>

## 一括操作

複数のプロダクトを選択して：

* 一括で有効/無効化
* プロダクトデータをエクスポート
* 削除（確認が必要）