Module 6 · Advanced · 9 min read

Tax codes: per item, per line and per document

You will be able to: Name Zeyto's five tax codes and the VAT 201 boxes they report in; Explain where a document line gets its tax code and how to override it; Say what a customer or supplier does and does not change.

  • Read not done yet
  • Self-check: not taken not done yet
  • Lesson complete not done yet

A tax code tells Zeyto how a line is taxed and which box of the VAT return it belongs in. Zeyto comes with five codes. The Rate and the boxes are stored on the code in Settings, Tax, never typed on documents.

The tax code list in Settings, Tax with the code, name, rate, direction and VAT 201 box columns.

Tax codes: rate, direction and box in one row each.

Tax codes: rate, direction and box in one row each.
CodeTreatmentRateBox on a saleBox on a purchase
SR5Standard5%19
ZRZero0%4none
EXExempt0%5none
RCMReverse charge5%310
OOSOut of scope0%nonenone

Where a line's code comes from

  1. The item. Every item has a VAT Code in the Tax (VAT) card of its record. New document lines for that item start on it.
  2. The item group. If a group has a Default VAT Code, items created in it without their own code start on that, for example through the Import Center. The New Item screen and the Items import start on SR5 themselves, so check the code there.
  3. The line. On a sales or purchase document, tick Tax Code under Columns to show the Tax column and change the code of one line.
  4. Charges. Delivery, freight and similar charges take their code from the charge type in Expense Types, and you can change it on the document.
A new sales invoice with two lines after ticking Tax Code under Columns, so each line shows its tax code such as SR5 beside the rate and the VAT amount.

Columns, Tax Code: show the tax code on every line.

Columns, Tax Code: show the tax code on every line.
Watch outThe customer does not change the tax code. If you sell a 5% item to a customer outside the UAE, Zeyto still puts 5% on the line until you change that line to ZR yourself. The customer's Tax Treatment field is only a label.

Overriding a line: an export

Zero-rating an export lineA customer abroad buys goods for AED 12,000. The item is on SR5, so the line shows VAT of AED 600. You change that line's Tax to ZR. VAT becomes 0.00, the sale of AED 12,000 is reported in Box 4, and you can still recover the VAT on your own costs. Keep the export evidence your accountant asks for; the code change alone proves nothing to the FTA.

Changing codes without rewriting history

  • A change in Settings, Tax affects only documents you post afterwards; posted documents keep the VAT they were posted with.
  • Changing the VAT Code on an item affects documents from now on. Saved documents keep their line codes.
  • To change many items at once use Set VAT Code on the Items list. Pick the code and the scope, press How many? to see how many items will change, then commit.
  • An inactive code is no longer offered on items and lines, but old documents that use it are not changed.

Reverse charge switches a code for you

Reverse charge is the one case where Zeyto changes a line's code by rule. An item can belong to an RCM category (Settings, RCM Categories). When you add it to a sale, Zeyto checks the category, the customer's 15-digit TRN and, where the category requires one, a valid declaration from the customer. If all pass, the line switches to the category's reverse-charge code and shows an RCM tag; the invoice then charges no VAT on that line.

Lines with no tax code

A line with no VAT code is in no box. The Return Worksheet shows a red banner naming such lines (for example SI-00012 line 3) and will not let you mark the period filed until each one has a code. Fix it by amending the document and giving the line a code.

TipOnce a period is filed, Zeyto refuses to submit, amend or cancel VAT documents dated in it. Settle your codes before you file, not after.

Rules change; always check the FTA website.

Try it in the demo

  1. Open Inventory, Items, open any item and look at the Tax (VAT) card. Which code does it carry?
  2. Open Sales, Sales Invoice, press + New Sales Invoice, add an item, then press Columns and tick Tax Code and VAT Amt.
  3. Change that line's Tax to ZR and watch the VAT Amt and the totals preview change. Do not press Submit in the shared demo.
  4. Open Settings, Tax and compare the Sale Box and Purchase Box of SR5, ZR and RCM.
Open the live demo

Public demo company, sign in as admin / demoAdmin123. Data refreshes nightly.

Key takeaways
  • Five codes cover the UAE treatments: SR5, ZR, EX, RCM and OOS, each mapped to VAT 201 boxes.
  • A line starts on its item's code; you change the line, not the customer, to zero-rate an export.
  • Reverse charge is the exception: Zeyto switches the line when category, TRN and declaration checks pass.
  • Lines without a tax code appear in no box and block the filing lock.

Check yourself

3 questions on this lesson. Not timed, not the exam, and you can try again. Score 60% or more, and read the lesson, to complete it.

1. Which Zeyto tax code is the 5% standard rate?

2. You sell a 5% item to a customer outside the UAE. How do you zero-rate the export in Zeyto?

3. If you change an item's VAT code, documents that are already saved are re-priced with the new code.

Practice questions for this module · Printable study sheet