商品登録（Product Listing）

目的

MallSupplierが商品・サービスをCatalog Mallに登録し、BuyerがRFQなしで直接購入できるようにするプロセスです。商品はMallMasterの承認を経て初めてMall上に公開されます。1件ずつの手動登録と、CSVによる一括登録の両方に対応しています。

---

登場人物

役割	担当
MallSupplier	商品の作成・編集・承認申請
MallMaster	商品の承認または却下
Buyer	承認済み商品の閲覧・購入

---

商品のライフサイクル

flowchart LR
    DRAFT(["📝 下書き\n(wk_product)"])
    DRAFT --> INTERNAL["社内承認\n（MallSupplier内部）"]
    INTERNAL --> EXTERNAL["MallMaster\n承認待ち"]
    EXTERNAL --> PUBLISHED(["✅ 公開済み\n(productテーブル)"])
    EXTERNAL --> REJECTED(["❌ 却下\n修正が必要"])
    REJECTED --> DRAFT
    PUBLISHED --> UPDATED["商品を更新\n→ 再承認が必要"]
    UPDATED --> INTERNAL

重要： wk_product テーブルは承認待ちの下書き。MallMasterが承認すると product テーブルに移行し、Buyerが閲覧できるようになります。

---

商品情報の入力項目

基本情報

項目	必須	説明
商品名	✅	Mall上での表示名
商品コード（SKU）	✅	MallSupplier側の管理コード
カテゴリ	✅	MallMasterが管理するカテゴリツリーから選択
ブランド	—	商品ブランド名
短い説明	✅	一覧ページに表示される簡易説明
詳細説明	—	機能・特長の詳細
商品画像	—	複数枚可（メイン画像＋サブ画像）
仕様・スペック	—	サイズ・重量・素材等
数量単位	✅	個・箱・kg・セット等
最低注文数（MOQ）	—	最小注文数量
標準納期	—	通常の納品に要する日数

価格設定（Buyer会社別）

1つの商品に対して、Buyer会社ごとに異なる単価を設定できます。

flowchart LR
    PRODUCT["商品A"] --> PRICE1["ANDY-MFG向け価格\n¥1,000/個"]
    PRODUCT --> PRICE2["ANDY-FOOD向け価格\n¥950/個"]
    PRODUCT --> PRICE3["標準価格\n（その他すべてのBuyer）\n¥1,100/個"]

価格項目	必須	説明
標準価格	✅	個別設定のないBuyerに適用
会社別単価	—	buyerCompanyCode ごとの特別価格
税率	✅	適用税率（標準税率・軽減税率・非課税等）
価格有効期間	—	開始日〜終了日

---

登録方法

方法1：手動登録（1件ずつ）

MallSupplier Portal → 商品管理 → 新規商品登録
→ 情報入力 → 価格設定 → 承認申請

URL: https://bizhiway.staging.jienie.com/MallSupplier/CMS07ProductList

方法2：CSVによる一括登録

複数商品をまとめて登録する場合に使用します。

flowchart LR
    PREP["CSVファイルを準備\n（テンプレートに従う）"] --> UPLOAD["システムにアップロード\n/MallSupplier/CMS15WkProductUpload"]
    UPLOAD --> VALIDATE{"データ検証"}
    VALIDATE -->|"正常"| IMPORT["インポート成功\n→ wk_productへ登録"]
    VALIDATE -->|"エラー"| ERROR["行ごとにエラー表示\n修正して再アップロード"]
    IMPORT --> SUBMIT["一括承認申請"]

---

公開済み商品の管理

承認・公開後も以下の操作が可能です。

操作	結果
情報更新	下書きを新規作成 → 再承認が必要
価格変更	価格変更もMallMasterの承認が必要
一時停止	検索に表示されなくなる（承認不要・即時反映）
恒久廃止	Mallから完全削除（復元不可）

---

Punchout（外部カタログ連携）

Punchoutは、BuyerがMallSupplierのWebサイトで商品を選び、結果をJ2のカートに戻す仕組みです。

sequenceDiagram
    participant B as Buyer (J2)
    participant J2 as J2システム
    participant SUP as MallSupplier Webサイト

    B->>J2: Mall上で「Punchout」をクリック
    J2->>SUP: セッショントークン付きでリダイレクト
    B->>SUP: サプライヤーWebサイト上で商品を選択
    SUP->>J2: 選択結果（商品・価格）を返送
    J2->>B: J2のカートに反映

Punchoutはすべてのサプライヤーで使えるわけではありません。MallMasterによる個別設定が必要です。

---

ビジネスルール

• 承認前はBuyerに非表示： wk_product の商品はMallMasterの承認完了まで一切表示されません。
• 変更はすべて再承認が必要： 説明文や価格の変更も再度MallMasterの承認が必要です。
• 価格はBuyer会社別： 同一商品でも、Buyer会社によって表示される価格が異なります。
• カテゴリはMallMasterが管理： MallSupplierは既存カテゴリから選択するのみ。新規カテゴリは作成不可。
• 一時停止は即時反映： 一時停止は承認不要 — 操作した瞬間から検索に表示されなくなります。

---

画面・URL

画面	URL (Staging)
商品一覧	https://bizhiway.staging.jienie.com/MallSupplier/CMS07ProductList
新規商品作成	https://bizhiway.staging.jienie.com/MallSupplier/CMS08WkProductCreate
商品編集	https://bizhiway.staging.jienie.com/MallSupplier/CMS09WkProductEdit
CSVアップロード	https://bizhiway.staging.jienie.com/MallSupplier/CMS15WkProductUpload
価格設定	https://bizhiway.staging.jienie.com/MallSupplier/CMS10PriceList