ドキュメントCommerceData Export

[PaaSのみ]{class="badge informative"}

税区分、属性セットおよび在庫属性の追加

最終更新日： 2026年5月12日

作成対象：

  • Admin
  • Developer

Adobe Commerce Extra Product Attributes モジュールは、商品データフィードを拡張します。 これには、Adobe Commerceの製品設定から追加の製品属性が含まれます。

インストールすると、モジュールは自動的に動作します。 製品の同期中に、追加の属性をキャプチャし、書き出します。 追加の設定は必要ありません。

主な特長

  • 自動拡張：税区分、属性セットおよび在庫属性を使用して製品フィードを強化します
  • シームレスな統合：外部システムとサービスに必要なコンテキストを提供します
  • 設定なし: インストール直後に動作します
  • リアルタイム更新：製品の変更と自動的に同期

機能と書き出された属性

このモジュールは、既存の製品データフィードに3つの追加属性を追加します。

  • ac_tax_class
  • ac_attribute_set
  • ac_inventory

​1. 税区分の情報（ac_tax_class）

目的：各製品の税分類情報を提供します

データ形式：税種名を含む文字列値

出力例:

{
  "attributes": [
    {
      "code": "ac_tax_class",
      "values": ["Taxable Goods"]
    }
  ]
}

ユースケース:

税区分データをCommerce カタログサービスに書き出すと、このデータは次をサポートするアプリケーションで使用できるようになります。

  • 税務コンプライアンスレポート
  • 外部税計算サービスとの統合
  • 会計システム向け製品カテゴリ

​2. 属性セット情報（ac_attribute_set）

目的：各製品に割り当てられている属性セットを特定します

データ形式：属性セット名を含む文字列値

出力例:

{
  "attributes": [
    {
      "code": "ac_attribute_set",
      "values": [
        "Default"
      ]
    }
  ]
}

ユースケース:

属性セットデータをCommerce カタログサービスに書き出すと、外部システムで高度な製品管理機能が有効になります。 主な機能は次のとおりです。

  • 製品テンプレートの特定
  • カタログの管理と整理
  • 属性セットコンテキストを必要とするサードパーティシステム統合

​3. 高度な在庫データ （ac_inventory）

目的：各製品の在庫管理設定を提供します

データ形式: インベントリ設定を含むJSON エンコードされた文字列

含まれるフィールド:

  • manageStock （ブール値）：在庫管理が有効になっているかどうか

  • cartMinQty （浮動小数）: ショッピングカートで許可される最小数量

  • cartMaxQty （浮動小数）: ショッピングカートで許可される最大数量

  • backorders （文字列）: バックオーダーポリシー。 値は次のいずれかです。

    • "no"：取り寄せ注文は許可されていません
    • "allow"：数量が0未満の場合
    • "allow_notify":0未満の数量を許可し、お客様に通知

  • enableQtyIncrements （ブール値）：数量の増分が有効かどうか

  • qtyIncrements （浮動小数）：必要な数量の増分値

出力例:

{
  "attributes": [
    {
      "code": "ac_inventory",
      "values": [
        "{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
      ]
    }
  ]
}

ユースケース:

在庫データをCommerce カタログサービスに書き出すと、外部システムで高度な在庫管理機能が有効になります。 主な機能は次のとおりです。

  • Inventory managementとの連携
  • ショッピングカート検証ルール
  • 注文フルフィルメントプロセスの最適化
  • 顧客体験のカスタマイズ

データ書き出しフィードの強化

製品属性の追加モジュールは、既存の製品フィードを強化します。 新しい属性データが自動的に統合されます。

  • 製品フィード （products）: 3つの追加属性で強化されました

    • 各製品レコードにac_tax_class、ac_attribute_setおよびac_inventory属性を追加します
    • 元の商品データを保持
    • 既存のフィード コンシューマーとの下位互換性を維持

  • 製品属性フィード （productAttributes）：新しい属性の属性メタデータで強化

    • productAttributes フィードに3つの新しい属性のメタデータを自動的に登録します
    • 属性設定の詳細（データタイプ、表示設定など）を提供します。
    • 外部システムが新しい属性スキーマを理解するのに役立つ

拡張機能のインストール

要件

インストール手順

Composerを使用してadobe-commerce/module-extra-product-attributes モジュールを追加します。

composer require adobe-commerce/module-extra-product-attributes

インストール手順の詳細については、次のガイドを参照してください。

製品データの同期

再デプロイメント後、Adobe Commerce インスタンスは、製品の同期中に追加データを自動的に書き出します。 また、resync CLI コマンドを使用して、即座に同期することもできます。

# Resync the products feed (includes the new attributes)
bin/magento saas:resync --feed=products

# Resync the product attributes feed (includes new attribute metadata)
bin/magento saas:resync --feed=productAttributes

トラブルシューティング

追加属性が見つからない製品：

  • モジュールが適切にインストールされ、有効になっていることを確認します
  • 再同期コマンドを実行して製品データを更新する
  • 製品に有効な税区分と属性セットの割り当てがあることを確認します

在庫データが正しくありません：

  • 管理画面で在庫設定が正しく設定されていることを確認します
  • web サイト固有のインベントリの上書きを確認する
  • Inventory management モジュール ​が正しく動作していることを確認します

詳しくは、Inventory managementのマーチャント向けドキュメント​のAdobe Commerce ガイド ​を参照してください。

パフォーマンスに関する懸念事項：

  • インストール後の書き出しプロセスのパフォーマンスを監視する
  • トラフィックが少ない期間には再同期のスケジュールを検討する

ログとデバッグ

モジュールは、エラーと警告を標準のCommerce ロギングシステムに書き出します。 製品の同期中に問題が発生した場合は、データ書き出しログを確認してください。

詳しくは、​ ログの確認とトラブルシューティング ​を参照してください。

recommendation-more-help
commerce-help-data-export