Tax rates
A Tax rate (Tax Rate) is a reference value for the tax percentage, the invoice label, and the default assignment. Within the Product Catalogue it is selected on the product through taxRateId.
Path (Product Catalogue): Side menu → Product Catalogue → Tax rates
Page (CAT): /Entities/CAT/TaxRate
Page (ORG): /Entities/ORG/TaxRate
The CAT interface and the catalogue's side menu path open /Entities/CAT/TaxRate. An interface also exists under the organization at /Entities/ORG/TaxRate, and the backend API follows the ORG controller.
What this screen does
- Manages tax rates with both names, the percentage, and the invoice label
- Lets you set isDefault for the default rate
- Is linked to the product for tax on sale / purchase, depending on use
Fields
| Field | Required | Use |
|---|---|---|
| name / nameAr | Required in the CAT interface | Name in English and Arabic |
| taxValue_prc | Optional in validation (≥ 0) | Tax percentage % |
| labelOnInvoice | Optional | Label on the invoice |
| isDefault | Optional | Whether it is the default rate |
| description / descriptionAr | Optional | Descriptions |
CAT list columns
name / nameAr / descriptions / Active? / actions — without a taxValue column in the current CAT list.
ORG list columns
Adds a taxValue_prc column alongside the names, descriptions, and active status.
How to use the screen
- Open
/Entities/CAT/TaxRatefrom the catalogue menu (or the ORG path when working from the organization) - Create or edit a rate with both names, taxValue_prc, labelOnInvoice, and isDefault
- Later, choose the rate from the tax field on the Product
Best Practices
Make labelOnInvoice match what the customer sees so the wording does not differ between teams.
isDefault marks the rate used by default within the list.
Edit from a single approved path in your organization (CAT or ORG) to avoid operational confusion, bearing in mind that the backend API is under ORG.