Defining tax rates

The HCL Commerce Accelerator configures tax rates through the Tax notebook.

About this task

Specify all rates as a percentage value, and not a flat rate.

Procedure

  1. Open HCL Commerce Accelerator
  2. Click Store > Change Tax. The Tax notebook opens.
  3. From the left navigation frame, click Rates.
  4. If you created your store based on a starter store archive, the tax rates table contains a default tax, Shipping, which has an initial value of 0.00. In the Shipping column, for each jurisdiction within the table, type the tax rate that is charged for shipping. Leave the value as zero if you do not charge a shipping tax.
  5. In the rest of the cells, type the tax rate for each combination of tax jurisdiction and tax category.
  6. Click OK to save your settings and exit.
  7. Optional: If the tax rates for the products often change, you can manage the effective dates of different tax rules through HCL Commerce Accelerator. You can enable a tax rates configuration page, which includes starting and ending dates.

    To enable the starting and ending dates on the configuration page, and manage the start and end dates of your tax rates:

    1. Open the following file in a text editor:
      • workspace_dir/CommerceAccelerator/WebContent/WEB-INF/struts-config-ext.xml
      • workspace_dir/CommerceAccelerator/src/struts-wcs-accelerator.xml
    2. For HCL Commerce Version 9.0.0.x users: Find the <forward> element with the name TaxRatesPanelView and change it as shown in the following sample:
      <global-forwards>
      	<forward className="com.ibm.commerce.struts.ECActionForward"
      		name="TaxRatesPanelView" path="/tools/taxation/TaxRatesforDate.jsp">
      		<set-property property="resourceClassName"
      			value="com.ibm.commerce.tools.command.ToolsForwardViewCommandImpl" />
      	</forward>
      </global-forwards>
    3. Find the <action> element with the name TaxRatesPanelView and change it as shown in the following sample:
      <action class="com.ibm.commerce.struts.v2.BaseAction" name="TaxRatesPanelView">
      <param name="https">0:0</param>
      <result name="TaxRatesPanelView">
      <param name="location">/tools/taxation/TaxRates.jsp</param>
      <param name="resourceClassName">com.ibm.commerce.tools.command.ToolsForwardViewCommandImpl</param>
      </result>
      </action>
    4. Open HCL Commerce Accelerator
    5. Click Store > Change Tax. The Tax notebook opens.
    6. From the left navigation frame, click Rates.
    7. Select a tax category.
    8. You can Add, Change, or Remove tax rate records.

      If you add or change a tax rate record, you can define the jurisdiction, rate, start time, end time, and priority. Click OK to save your changes.

    9. Click OK to save your changes and exit the tax notebook.
    Notes:
    1. When two tax rates with same jurisdiction and tax category fall into the same time period, the tax rate with the higher priority takes effect. If they have the same priority, both of them take effect.
    2. The new tax rate configuration page is an enhancement to the existing page. It is not recommended to reverse back to the previous version. To reverse the changes to the original page, remove any data that is created with the new page before you reverse the changes. Data that is configured with the original page can be used by the new page without issue.