Important

You are browsing documentation for version 5.0 of OroCommerce, supported until January 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

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

Available in OroCommerce

Manage Customer Tax Codes in the Back-Office 

Hint

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

A customer tax code is a label assigned to a customer and indicates the tax obligations and exemptions a customer has. The customer tax obligations are considered when a customer (user) submits an order.

The sections below explain how to manage customer tax codes, using them to label customers and bind customers to dedicated tax rules.

Create a Customer Tax Code 

A customer tax code is a label for a group of customers that indicates the tax obligations and exemptions that a customer has. These tax obligations are considered when a customer submits an order.

To create a new customer tax code:

  1. Navigate to Taxes > Customer Tax Codes in the main menu.

  2. Click Create Customer Tax Codes.

  3. Fill in Owner, Code, and Description with information about the customer tax code you are creating.

  4. Click Save and Close.

Manage Customer Tax Codes 

To view all customer tax codes, navigate to Taxes > Customer Tax Codes in the main menu.

The general page of all customer tax codes

Note

To handle a considerable volume of data, use the page switcher, increase View Per Page, or use filters to narrow down the list to just the codes you need.

In the customer tax codes list, you will find the information about the code (unique identifier), a detailed description, and the dates when the customer tax code was created and updated.

Hover over the More Options menu to the right of the item and click to open its details page, to edit, or to remove the customer tax code.

View Customer Tax Code Details 

To view customer tax code details:

  1. Navigate to Taxes > Customer Tax Codes in the main menu.

  2. Find the line with the necessary customer tax code and click it to open its details.

  3. You can perform the following actions with a customer tax code:

  • View Change History — See the log of edits of this customer tax code by clicking the Change History link to the top right of the page.

    The log of edits of the selected customer
  • View details of the customer who is linked to this customer tax code — Click the line with the customer account details.

  • Edit or Delete the selected customer tax code.

    Note

    You can edit the customer details to remove the link to this customer tax code, if necessary.

Edit Customer Tax Code Details 

To edit the customer tax code value and description:

  1. Navigate to Taxes > Customer Tax Codes in the main menu.

  2. Hover over the More Options menu to the right of the item and click to start editing its details.

  3. Update the Code and Description with new information about the customer tax code.

  4. Click Save and Close.