You are here:
Tax Class ID Attributes in B2C Commerce
B2C Commerce has two system object attributes for managing product tax rates on your storefront: legacy taxClassId and localizedTaxClassId.
The taxClassId is the default for Salesforce Reference Architecture (SFRA) and SiteGenesis sites. The localizedTaxClassId is a flag setting that you turn on in Business Manager. The taxClassId and the localizedTaxClassId don’t run in parallel. Provide values for both attributes, but only the active attribute is used.
taxClassId Attribute
The taxClassID is a product attribute. Use the taxClassID attribute to assign a tax class to a product SKU for your site. For example, you can set the taxClassID for a product as Standard or Exempt. The taxClassId attribute setting is the same for that product at all locales the site serves. To assign a different tax class for a locale, use the taxClassID to map a tax class for the required product SKUs.
If the localizedTaxClassId attribute flag is turned off, then the taxClassId attribute is used. The taxClassId has the following impacts on your site implementation.
Business Manager–The taxClassId field shows on the Product Detail page. You can change the value from the dropdown. The value options depend on the values defined for the tax class.
Product Catalog Export–If the export passes an attribute value for the localizedTaxClassId, the attribute value shows in the export file. If the export passes a taxClassId attribute value exists, the value also shows in the export file.
Order Processing–During cart checkout, the taxClassId is used.
localizedTaxClassId Attribute
Use the localizedTaxClassId attribute to operate one site across multiple locales and assign a different tax class ID value for product SKUs in different locales. For example, your site sells imported cheese at multiple locales. The locales your site serves have different tax rates on imported cheese. Use the localizedTaxClassId to set a different tax class for your cheese SKUs based on each locale.
The localizedTaxClassId is designed to support both tax class scenarios:
- One site with one tax rate for a product
- One site with multiple locale-specific tax rates for a product
For a new site that serves multiple locales with different tax classes for the same products, B2C Commerce recommends using the localizedTaxClassId instead of the legacy taxClassId.
The localizedTaxClass Attribute Flag
You turn on the localized TaxClassId attribute flag in . Turning on the flag modifies the following processes in your site implementation.
Business Manager–The legacy localizedTaxClassId field replaces the taxClassId field on the Product Detail page. The field default value is set to Undefined. You can change the value from the dropdown. The value options depend on the values defined for the tax class.
Product Catalog Export–If the export passes an attribute value for the taxClassId, the value shows in the export file. If the export passes a localizedTaxClassId attribute value, the value also shows in the export file.
Order Processing–During cart checkout, the localizedTaxClassId is used. The attribute value is based on the locale for the request from the storefront.
- Set the Tax Class Attribute Value
Set the attribute localizedTaxClassId attribute on the Business Manager Product Detail page or use the catalog Import and Export process. This topic applies to B2C Commerce.
