You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Security Support ends in January 2024. Read version 5.0 (the latest LTS version) of the Oro documentation to get the updated information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCommerce

Manage Taxes in the Back-Office


This section is part of the Tax Management concept guide that provides the general understanding of the tax configuration and management in OroCommerce.

Tax rules help OroCommerce find the correct tax rate that should be used for the products listed in the purchase order by matching the product tax code that indicates:

  • Tax status of the product
  • Customer tax code that indicates the tax status of the buying company
  • Tax jurisdiction where the tax is due

OroCommerce supports a tax exemption mechanism: you can set a zero tax rate for some customers and/or products.

A tax rule binds the following items:

  • Customer tax code - a label for a customer or customer group that follows similar taxation rules in at least one tax jurisdiction.
  • Product tax code - a label for a group of products that have similar taxation rules in at least one tax jurisdiction.
  • Tax jurisdiction - an address, usually a state in a country that has defined taxation policies that determine when and how the company should pay its sales or VAT tax, and what rates should be used, depending on the tax status of the products you sell and the parties you sell to.
  • Tax rate - the percentage of the sales income that should be paid as a tax in the particular tax jurisdiction for a certain type of products sold to a group of customers with the same tax status.
The general page of all tax rates

Taxation Configuration

OroCommerce groups taxation configuration options into the following categories that should be customized in the global system configuration or per organization:

Tax Rules Creation Prerequisites

Before setting up a tax rule, make sure to complete the following actions:

  1. Create a customer tax code

Create a customer tax code and apply it to a certain customer or a customer group who has fixed tax rates.

  1. Create a product tax code

Create a product tax code and apply it to the required products with fixed tax rates so that only the products that are subject to be taxed are taxed during a checkout.

  1. Create a tax jurisdiction

Once you have created both customer and product tax codes and assigned them to the required customers and products, you need to create a tax jurisdiction (country, state, and a range of zip codes) with defined taxation policies to determine where and how the company should pay their sales or VAT tax. A tax jurisdiction specifies what rates should be used depending on the tax status of the products you sell and the customers you sell to.

  1. Create a tax rate

Create a tax rate(%) defined by the tax jurisdiction for the customers you are serving and the products you are selling. A tax rate determines the percentage of a sale or order that is required to be paid as a tax in a certain tax area (country or state).

  1. Create a tax rule

Finally, create a tax rule that associates the customer tax code, the product tax code, and the tax jurisdiction with the tax rate or the tax exemption (zero rate).


See the two short demos for the guidance on how to create tax rules.

Creating tax codes and jurisdictions in OroCommerce

Creating tax rules

Related Articles