Add or Edit Tax Rule

Description

This page interface allows editing existing or add a brand new Tax Rule to the Prestashop Tax system.

QA

Link to test

Common components

Top elements

  • Add New or Edit:{edited Tax Rule name} - page title.

  • Add new tax rule button - toggles the expanding or subtracting the Tax rule creating and editing section below.

  • Help - a side-bar with the helpful information, how to navigate in this page.

  • Tabs: Taxes and Tax Rules - navigation tabs for taxes and tax rules.

The form can be accessed in 2 ways:

  • Add new Tax Rules group button must be clicked from the Tax Rules listing.

  • Clicking on the Edit button of a Tax Rules item in the listing.

Tax Rules Editing form

  • Name label - mandatory - text field for naming the specific Tax Rule. Once hovered, there is a tooltip text prompted - Invalid characters: <>;=#{}.

DescriptionValueError message

Mandatory

YES

The field name is required at least in your default language.

Allowed/Forbidden values

Invalid characters: <>;=#{}

(text) is invalid

Default value

Default value

Add : empty Edit : Taxe rule name

Help text

Tax name to display in carts and on invoices (e.g. "VAT"). Invalid characters: <>={}

-

Tool tips

Invalid characters: <>;=#{}

-

Lower limit

Upper limit

Behavior

-

  • Enable - toggle - allows to Enable or Disable tax rule. By default - Tax rule toggle is disabled.

  • Shop association ( LABEL MULTISTORE ) - a widget, that allows to select the desired Multistores or Shop Groups, where Tax Rules could be applied. The widget contains 4 buttons:

    • Collapse all ( LABEL MULTISTORE ) - subtracts the Multistores and Shop groups tree.

    • Expand all ( LABEL MULTISTORE ) - expands the Multistores and Shop groups tree.

    • Check all ( LABEL MULTISTORE ) - checkmarks all the Multistores and Shop groups items in tree.

    • Uncheck all ( LABEL MULTISTORE ) - unchecks all the Multistores and Shop groups items in tree.

  • Cancel - button cancels the Tax editing form.

  • Save and stay - button saves the configured form and redirects to the same page.

New Tax Rule panel (appears after submitting the Tax Rules main form)

  • Country - dropdown, allows the selection of country for specific Tax Rule. By default it is set to All.

  • Zip/Postal code range - input, defines the zip or postal code for Tax Rule.

DescriptionValueError message

Mandatory

YES

TODO

Allowed/Forbidden values

Depending on which region is used

(text) is invalid

Default value

Default value

Add : 0 Edit: the current ZipCode

Help text

-

-

Tool tips

-

-

Lower limit

Upper limit

Behavior

-

  • Behavior - dropdown, allows the Tax rule to have a specific behavior, when address matches multiple rules. Once hovered, there is an explanation prompted:

You must define the behavior if an address matches multiple rules: This tax only: Will apply only this tax Combine: Combine taxes (e.g.: 10% + 5% = 15%) One after another: Apply taxes one after another (e.g.: 100 + 10% => 110 + 5% = 115.5)

The Behavior dropdown values are the following:

  • This tax only - rule applies only one current tax.

  • Combine - rule combines the current tax with another tax.

  • One after another - rule combines the current tax, and then after the combination result it combines the next rule.

  • Tax - dropdown, allows to apply specific Tax from the list. Once hovered, there will be a text prompted (Total tax: 9%).

  • Description - input field allows to type specific description of the Tax Rule.

DescriptionValueError message

Mandatory

NO

Allowed/Forbidden values

-

(text) is invalid

Default value

Add: empty

Edit: Current value

Help text

-

-

Tool tips

-

-

Lower limit

Upper limit

Behavior

-

  • Save and stay - button saves the configured form and redirects to the same page with the green success notification Successful update.

Country panel

If there are specific countries added, after clicking Save and stay, the lower panel will appear with the countries list. The table has the following headers:

Table country

  • Country - displays the country name.

  • State - if defined country has a state, it can be displayed.

  • Zip/Postal code - if there is available Zip or Postal code, it can be displayed here. If the field is typed with the invalid characters, there will be an error notification prompted:

    There are 2 errors. The Zip/Postal code is invalid. It must be typed as follows: 0000 for Afghanistan. zipcode_from is invalid.

  • Behavior - displays the Tax behavior selected for specific country.

  • Tax - displays the Tax rule code.

  • Description - displays the specific description for the Tax rule.

  • Edit - redirects to the same page for editing the current Tax rule.

  • Dropdown > Delete - delete the specific country Tax rule from list. After clicking the Delete, there is a pop-up prompted with the exclamation error sign and text Delete selected item? and possible values - Yes or No. No leads to closing the pop-up, Yes - deletes the country tax rule, with the page reloading and the success message Successful update.

  • Bulk actions widget - if there more than 1 c in the list, some of them can be selected by checkboxes separately, or can be Selected all or Unselected all. After the selections, Delete selected will delete the selected from the list (confirmation pop-up will be prompted as well).

Last updated