[僅限PaaS]{class="badge informative"}

新增稅捐類別、屬性集及存貨屬性

Adobe Commerce額外產品屬性模組可擴充產品資料摘要。 其中包括Adobe Commerce產品設定中的其他產品屬性:

安裝後,模組會自動運作。 它會在產品同步期間擷取並匯出其他屬性。 不需要額外設定。

主要優點

  • 自動增強功能:使用稅捐類別、屬性集及存貨屬性豐富產品摘要
  • 緊密整合:提供外部系統與服務的基本內容
  • 零組態:安裝後立即運作
  • 即時更新:自動與產品變更同步

特徵和匯出的屬性

此模組會新增三個其他屬性至您現有的產品資料摘要:

  • 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_classac_attribute_setac_inventory屬性新增至每個產品記錄
    • 保持原始產品資料不變
    • 維持與現有摘要使用者的回溯相容性
  • 產品屬性摘要 (productAttributes):新屬性的屬性中繼資料已增強

    • productAttributes摘要中自動註冊三個新屬性的中繼資料
    • 提供屬性組態詳細資訊(資料型別、可見度設定等)
    • 協助外部系統瞭解新的屬性結構

安裝擴充功能

需求

安裝步驟

使用撰寫器新增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

疑難排解

遺失其他屬性的產品:

  • 驗證模組是否已正確安裝及啟用
  • 執行resync命令以重新整理產品資料
  • 檢查產品是否具有有效的稅捐類別與屬性集指定

詳細目錄資料顯示不正確:

  • 確認已在Admin中正確設定詳細目錄設定
  • 檢查網站特定詳細目錄覆寫
  • 驗證Inventory management模組是否正常運作

如需詳細資訊,請參閱Inventory management商家檔案中的​ Adobe Commerce指南

效能問題:

  • 監視安裝後的匯出程式效能
  • 考慮在低流量期間排程重新同步

記錄與偵錯

此模組會將匯出錯誤和警告記錄到標準Commerce記錄系統。 如果您在產品同步期間遇到問題,請檢查資料匯出記錄檔。

如需詳細資訊,請參閱檢閱記錄檔及疑難排解

recommendation-more-help
84c95778-e795-4ef1-8b7e-54d73e45e22d