Qoyod
Pricing
Qoyod
Pricing

 Knowledge Base

How to Add and Manage Taxes in Web POS

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

  1. 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.
  2. Sign in to Web POS as a user with that role, then open Settings, then Taxes.
  3. 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.
  4. Click Add tax.
  5. Enter Tax name (English) and Tax name (Arabic). Both are required, so the tax reads correctly on Arabic and English receipts.
  6. Choose the Tax code from the four codes: Standard rate, Zero rated, Exempt and Out of scope.
  7. 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.”
  8. 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?

  1. Open Settings, then Taxes, choose the tax, then Edit tax.
  2. Correct either name whenever you like, as both can always be edited.
  3. Change the rate or the tax code only if the tax has never been used on an issued document.
  4. 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

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.

Help Center

Can't find what you're looking for?

Don’t worry — we have more ways to help.

Live webinars hosted by the Qoyod team to help you master the software with ease.

Discover Qoyod’s latest releases, continuous improvements, and new features.

Our team is ready to help you with instant support for any issue you face.