wix-stores-versioning

Wix Stores カタログのバージョン管理

Wix Stores には、下位互換性のない 2 つのカタログバージョンがあります。

バージョン	ステータス
V1_CATALOG	レガシー（例：products、inventory）
V3_CATALOG	現行（例：productsV3、inventoryItemsV3）

V3 のモジュールには通常、V3 の接尾辞が付いています。必要なモジュールを検索するには、Wix MCP を使用してください。

基本パターン

Stores の操作を行う前に、必ずカタログバージョンを確認してください。

import { catalogVersioning, products, productsV3 } from '@wix/stores';

async function getProducts() {
  const { catalogVersion } = await catalogVersioning.getCatalogVersion();

  if (catalogVersion === 'STORES_NOT_INSTALLED') {
    return [];
  }

  if (catalogVersion === 'V3_CATALOG') {
    // Use V3 module
    const result = await productsV3.queryProducts().limit(10).find();
    return result.items;
  }

  // Use V1 module
  const result = await products.queryProducts().limit(10).find();
  return result.items;
}

必要な権限

使用する各 API メソッドの権限を必ず確認してください。

1. SearchWixSDKDocumentation を使用してメソッドを検索します
2. ReadFullDocsArticle でドキュメント全体を読み、必要な権限を確認します
3. 必要な権限をユーザーに伝えます

主なルール

• 各フローの開始時に getCatalogVersion() を呼び出します
• カタログバージョンはサイトごとに固定されます（V3 から V1 へのダウングレードはできません）
• V1 と V3 ではペイロードの構造が異なります。フィールド名、ネスト、型が異なります
• すべてのサイトに対応するには、V1 と V3 の両方の Webhook をサブスクライブします

SDK の詳細を確認する

MCP ツールを使用して、バージョン固有のドキュメントを検索します。

• SearchWixSDKDocumentation — メソッドと権限を検索します
• ReadFullDocsArticle — 必要に応じてドキュメント全体を読みます

検索クエリ（検索結果には V1 と V3 の両方の名前空間が表示されます）：

• "getCatalogVersion" → 権限と使用方法
• "createProduct" → productsV3（V3）と products（V1）
• "queryProducts" → productsV3（V3）と products（V1）
• "getInventoryItem" → inventoryItemsV3（V3）と inventory（V1）

重要： メソッドを見つけたら、ReadFullDocsArticle を使用して、必要な権限を含むドキュメント全体を確認します。必要な権限をユーザーに伝えてください。

API の差異に関するリファレンス

V1 と V3 ではフィールド構造が異なります。フィールドの対応関係については、次を参照してください。 カタログ V1 から V3 への移行ガイド