You add a sales tax from Taxes in the Web POS settings, edit it, learn when its rate gets locked, and decide who may manage taxes. This guide walks through the steps in order.
Path in Qoyod
Point of Sale › Settings › Taxes › Add tax
Steps
- Give the role the Tax Management permission in the role management settings: view level for someone who only needs to see taxes, edit level for someone who adds and changes them. A user without it does not see the Taxes section.
- Sign in to Web POS as a user with that role, then open Settings, then Taxes.
- Read the list: it shows each tax with its name, Tax code and Rate, together with the name of its tax code, and a tax used on issued documents carries the In use marker. To find a specific tax, type its Arabic or English name in Search taxes.
- Click Add tax.
- Enter Tax name (English) and Tax name (Arabic). Both are required, so the tax reads correctly on Arabic and English receipts.
- Choose the Tax code from the four codes: Standard rate, Zero rated, Exempt and Out of scope.
- Enter Rate %. Standard rate needs a rate above zero. The other three codes fix the rate at zero and show the note “This tax code requires a rate of zero.”
- Click Save. The message “Tax created.” appears and the tax shows in the list.
Fields
- Tax name (English) (required): the name that shows on the English receipt.
- Tax name (Arabic) (required): the name that shows on the Arabic receipt.
- Tax code (required): one of four codes, and it controls the rate.
- Rate % (required): accepts up to two decimals and cannot be negative.
How do I edit a tax?
- Open Settings, then Taxes, choose the tax, then Edit tax.
- Correct either name whenever you like, as both can always be edited.
- Change the rate or the tax code only if the tax has never been used on an issued document.
- Click Save. The message “Tax updated.” appears.
Special cases
The tax is used on issued documents
The rate and the tax code are locked, and you see “This tax has been used on issued documents, so its rate and tax code cannot be changed.” with the advice “To use a different rate, create a new tax.” So the rate and code on an issued document cannot change. A tax counts as used once a line on an issued document uses it, while assigning it to a product alone does not lock it.
A tax with the same code and rate already exists
The system refuses the addition. The message says a tax with the same code and rate exists, shows its name and rate, and advises you to use it instead of creating a new one.
There is no internet connection
Adding and editing a tax need an internet connection. Offline, the form keeps what you typed and shows “Taxes cannot be created while offline. Connect to the internet and try again.” Nothing is queued, so try again once the connection is back.
You do not have the permission
A user who tries to reach Taxes directly without the Tax Management permission sees “You do not have permission to manage taxes.” Ask your organization admin to grant it.
Notes
- Taxes created here are sales taxes only.
- The Tax Management permission is separate from the Modify tax and unit price permission, which still controls changing the tax on a cart line.
- These capabilities are available on Web POS.
- Update details are in Web POS Taxes: Two Names, Named Tax Codes and a Permission to Manage Them, the Taxes section as it first appeared is in Web POS 2.7.0: Dashboard and Tax Management, and setting up roles is in POS User Management from Inside Settings. For an introduction to the system, read Qoyod Point of Sale.
FAQ
Why do I not see Taxes in the settings?
The section shows only to users with the Tax Management permission. Ask your organization admin to add it to your role.
Why can I not change the rate?
If you picked a code other than Standard rate, the rate is fixed at zero and the note “This tax code requires a rate of zero.” appears. If the tax has been used on issued documents, its rate and code are locked and you need a new tax.
Can I correct the name of a tax that is already used?
Yes. Both the Arabic and the English name can always be edited, even when the tax is used.
Can I change the rate of a tax already used on issued invoices?
No. Its rate and code are locked after use, and you create a new tax to use a different rate.
Why did the system refuse a tax I added?
A tax with the same code and rate already exists. The message names it, so use it instead of creating a new one.
Can I add a tax while offline?
No. Adding and editing need a connection, and nothing is queued.