Table of Contents
1ℹ️ 機能概要 #
「一括出品」は同じ商品セットを複数の EC プラットフォームに一度で公開する機能です。CSV/Excel 取込、セット商品、テーマ画像(画像セット)など複雑なシナリオにも対応します。
対応プラットフォーム #
楽天 Yahoo Q10 AU Amazon Mercari Temu TikTok
2 前提条件 #
- 対象店舗
shop.memberが作成済み&API 認証完了 - ERP 側に商品マスタが存在(メイン画像・価格・在庫あり)
- 基本紐付けが完了している(《店舗 商品紐付け マニュアル》参照)
3 標準フロー #
3.1 出品ウィザードへの入口 #
- 入口 A:店舗フォーム → 「店舗商品」タブ → 上部 一括出品 ボタン
- 入口 B:店舗設定ウィザード → 「商品インポート」ステップ → ファイルアップロード
[スクショ位置] 一括出品ウィザード画面
3.2 ファイル取込 #
ec.shop.product.import.wizard は CSV/Excel を解析します。プラットフォームに応じて read_rakuten / read_yahoo / read_q10 / read_au などの関数が呼ばれます。
3.3 セット商品(Kit) の扱い #
セット商品は import_kit_separators フィールドで識別します。デフォルト分隔子は - と _。
| ケース | 設定 | 結果 |
|---|---|---|
| 単品 | 分隔子なし | 1 行 |
| セット | - |
子 SKU に分解 |
| 多段セット | -,_ |
2 段階で分解 |
3.4 テーマ画像(画像セット)の同時反映 #
「画像セット」は テーマ画像キャンペーンモジュール (my_ec_product) で一括管理されています。
- テーマ画像キャンペーン で対象商品の新画像を AI 生成・編集
- 一括出品ウィザードで テーマ画像を適用 をチェック、対象テーマを選択
- 出品実行時、画像が自動でプラットフォームに反映されます
ヒント:テーマ切替と価格変更を組み合わせることでキャンペーン効果を最大化できます。
3.5 実行 #
- 解析 ボタン → 作成/更新/スキップ件数を確認
- 実行 ボタン →
queue_jobによるバックグラウンド処理
4 失敗・リトライ #
スキップ:
shop_product_code / shop_product_no が空の行は自動スキップ。既存の組み合わせも既定ではスキップ(上書きしない)。エラー処理:解析エラーは
ValidationError を投げます。プラットフォーム側のプッシュエラーはキューで保持され、設定 → 技術 → キュータスク から手動リトライできます。
