Tax Class ID Attributes

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 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. You can provide values for both attributes, but only the active attribute is used.

taxClassId Attribute

The taxClassID is a product attribute. You can use the taxClassID attribute to assign a tax class to a product SKU for your site. For example, you can set thetaxClassID 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, you can 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

The localizedTaxClassId attribute allows you 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. You can 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:

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.

Note: Sites that use the legacy taxClassId can turn on the localizedTaxClassId flag. If your site has product SKUs that are mapped to the taxClasId for specific locale tax handling, you must change the mapping so that the products are mapped to the localizedTaxClassId.

The localizedTaxClass Attribute Flag

You turn on the localized TaxClassId attriute flag in Business Manager > Global Preferences > Settings > Products. Turning on the flag modifies the following processes in you 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.

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.