[PaaS only]{class="badge informative"}
Add tax class, attribute set, and inventory attributes
The Adobe Commerce Extra Product Attributes module extends product data feeds. It includes additional product attributes from Adobe Commerce product configurations:
Once installed, the module works automatically. It captures and exports the additional attributes during product synchronization. No additional configuration is required.
Key benefits
- Automatic enhancement: Enriches product feeds with tax class, attribute set, and inventory attributes
- Seamless integration: Provides essential context for external systems and services
- Zero configuration: Works immediately after installation
- Real-time updates: Synchronizes automatically with product changes
Features and exported attributes
The module adds three additional attributes to your existing product data feeds:
ac_tax_classac_attribute_setac_inventory
1. Tax class information (ac_tax_class)
Purpose: Provides tax classification information for each product
Data Format: String value containing the tax class name
Example output:
{
"attributes": [
{
"code": "ac_tax_class",
"values": ["Taxable Goods"]
}
]
}
Use cases:
When you export tax class data to Commerce catalog services, this data becomes available for applications that support:
- Tax compliance reporting
- Integration with external tax calculation services
- Product categorization for accounting systems
2. Attribute set information (ac_attribute_set)
Purpose: Identifies which attribute set is assigned to each product
Data Format: String value containing the attribute set name
Example output:
{
"attributes": [
{
"code": "ac_attribute_set",
"values": [
"Default"
]
}
]
}
Use cases:
When you export attribute set data to Commerce catalog services, it enables advanced product management features in external systems. These features include:
- Product template identification
- Catalog management and organization
- Third-party system integration requiring attribute set context
3. Advanced inventory data (ac_inventory)
Purpose: Provides inventory management settings for each product
Data Format: JSON-encoded string containing inventory configuration
Included fields:
-
manageStock(boolean): Whether stock management is enabled -
cartMinQty(float): Minimum quantity allowed in shopping cart -
cartMaxQty(float): Maximum quantity allowed in shopping cart -
backorders(string): Backorder policy. The value is one of the following:"no": No backorders allowed"allow": Allow quantity below 0"allow_notify": Allow quantity below 0 and notify customer
-
enableQtyIncrements(boolean): Whether quantity increments are enabled -
qtyIncrements(float): Required quantity increment value
Example output:
{
"attributes": [
{
"code": "ac_inventory",
"values": [
"{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
]
}
]
}
Use cases:
When you export inventory data to Commerce catalog services, it enables advanced inventory management features in external systems. These features include:
- Inventory management system integration
- Shopping cart validation rules
- Order fulfillment process optimization
- Customer experience customization
Data export feed enhancement
The Extra Product Attributes module enhances the existing product feeds. It integrates the new attribute data automatically.
-
Products Feed (
products): Enhanced with the three additional attributes- Adds the
ac_tax_class,ac_attribute_set, andac_inventoryattributes to each product record - Keeps original product data unchanged
- Maintains backward compatibility with existing feed consumers
- Adds the
-
Product Attributes Feed (
productAttributes): Enhanced with attribute metadata for the new attributes- Automatically registers metadata for the three new attributes in the
productAttributesfeed - Provides attribute configuration details (data types, visibility settings, and so on)
- Helps external systems understand the new attribute schema
- Automatically registers metadata for the three new attributes in the
Install the extension
Requirements
-
PHP 8.1, 8.2, 8.3, or 8.4
-
Adobe Commerce 2.4.4+
-
Adobe Commerce Data Export extension, version 103.4.11 or later
-
Access to repo.magento.com
To generate keys and obtain the necessary rights, see Get your authentication keys. For cloud installations, see the Commerce on Cloud Infrastructure Guide.
-
Access to the command line of the Adobe Commerce application server.
Installation steps
Add the adobe-commerce/module-extra-product-attributes module using Composer:
composer require adobe-commerce/module-extra-product-attributes
For detailed installation steps, see the following guides:
Synchronize product data
After redeployment, the Adobe Commerce instance exports the additional data automatically during product synchronization. You can also use the resync CLI commands to synchronize immediately.
# 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
Troubleshooting
Products missing additional attributes:
- Verify that the module is properly installed and enabled
- Run the resync commands to refresh product data
- Check that products have valid tax class and attribute set assignments
Inventory data appears incorrect:
- Verify that inventory settings are configured correctly in the Admin
- Check for website-specific inventory overrides
- Verify that the Inventory Management module is working correctly
For further details, see the Inventory Management Guide in the Adobe Commerce Merchant Documentation.
Performance concerns:
- Monitor export process performance after installation
- Consider scheduling resyncs during low-traffic periods
Logging and debugging
The module logs export errors and warnings to the standard Commerce logging system. If you encounter issues during product synchronization, check the data export logs.