Field reference

Every field on every Tax form: label in English and Arabic, type, whether it is required, its limits, a valid example and what the system refuses.

On this page (37)

Any tax master

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
CodeالرمزTextYes2-30: capital letter first, then capitals, digits, _ . -; made capitals; unique per kind; create onlyAE-VAT'1AE' -> 'A code is capitals, digits, _ . and - (2-30).'; existing -> 'A tax registration with that code exists.' (kind named)
NameالاسمTextYesMax 160UAE VATEmpty -> 'This is required.'
Arabic nameالاسم بالعربيةTextNoMax 160ضريبة القيمة المضافة
Valid from / Valid toيسري من / يسري حتىDateNoTo not before From; outside the window the master does not applyTo before From -> 'The end comes after the start.'; '01-01-2026' -> 'Send the date as YYYY-MM-DD.'
NotesملاحظاتLong textNoMax 4000
CountryالدولةSelectYesGCC only: AE, SA, BH, OM, QA, KWAE(API) 'IN' -> 'A GCC country: AE, SA, BH, OM, QA or KW.'

Registration

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
TaxالضريبةSelectYesVAT, Excise, Withholding, Corporate tax, ZakatVAT(API) 'gst' -> 'Choose from: vat, excise, withholding, corporate, zakat.'
Registration number (TRN)رقم التسجيل الضريبيTextYes (to activate)Max 40, spaces removed. AE: exactly 15 digits. SA: 15 digits starting and ending with 3100123456700003AE '12345' -> 'A UAE tax registration number is 15 digits.'; SA '123456789012345' -> 'A Saudi VAT number is 15 digits starting and ending with 3.'; empty at Activate -> 'Enter the registration number.'
Authority (code)الجهة (رمز)TextNoCode of a tax authority of this companyFTA'XYZ' -> 'No tax authority XYZ.'
Tax group (code)المجموعة الضريبية (رمز)TextNoMax 30; set when this registration files as a groupGRP-01
Evidence (certificate reference)الدليل (مرجع الشهادة)TextNoMax 300FTA certificate 2026-001
Branch (API)الفرعIdNoEmpty = whole companyActivate with dates overlapping an active registration of the same country/tax/branch -> '<CODE> already covers these dates for this tax and branch.'

Tax authority

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
TaxالضريبةSelectYesAs registrationVAT
Settlement currencyعملة السدادTextYes3 letters, capitalsAED'DIRHAM' -> 'Keep this to 3 characters or fewer.'
Returns everyالإقرار كلSelectNoMonthly / Quarterly / YearlyQuarterly
Due days after period endأيام الاستحقاق بعد نهاية الفترةNumberNo0 to 36528400 -> 'Choose between 0 and 365.'

Determination rule

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
ForلـSelectYesSales / Purchases / BothSales
Priority (lower wins)الأولوية (الأقل يفوز)NumberYes1 to 99991000 -> 'Choose between 1 and 9999.'
Gives tax codeيعطي الرمز الضريبيSelectYesA tax code of this company (Finance > Taxes)ZR(API) 'ZZ' -> 'ZZ is not a tax code in this company.'; none at Activate -> 'Say which tax code the rule gives.'
ExclusiveحصريCheckboxNoTwo exclusive rules matching at the same priority are a conflictOnActivate a rule with the same conditions, priority, side and country as an active exclusive one -> 'Rule <CODE> has the same conditions and priority. Two exclusive rules cannot both decide the same supply.'
Only with a valid exemption certificateبشهادة إعفاء سارية فقطCheckboxNoThe partner must hold an active certificate for the code on the tax dateOff
Conditions (JSON)الشروط (JSON)JSON listNo[{fact, op, value}]; facts: side, seller_country, buyer_country, ship_from_country, ship_to_country, buyer_registered, supply_type, party_class, product_class, place_of_supply; ops eq, ne, in, not_in, present[{"fact":"ship_to_country","op":"ne","value":"AE"}]fact 'colour' -> 'Condition 1: colour is not a fact. Use one of side, seller_country, ...'; op 'gt' -> 'Condition 1: gt is not a comparison.'; eq with no value -> 'Condition 1 needs a value.'; supply_type 'food' -> "Condition 1: supply_type is one of ('goods', 'service')."; in with [] -> 'Condition 1 needs at least one value.'
Facts the request must carryالحقائق المطلوبةLinesNoKnown facts onlyplace_of_supply'colour' -> 'Not facts: colour.'
Legal source (code)المصدر القانونيTextNoMax 30
Explanation shown with the resultالتفسيرLong textNoMax 500Export of goods - zero rated

Classification

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
ClassifiesيصنّفSelectYesCustomer / supplier, Product, SupplyProduct
CategoryالفئةTextNoMax 80Healthcare
Needs evidenceيحتاج دليلاًCheckboxNoStored; not checked by determination
MembersالأعضاءLines (codes)NoPartner codes (party) or product codes (product) of this companyMED-001'NOPE' -> 'No product NOPE in this company.'

Exemption certificate

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Customer / supplier (code)العميل / المورد (رمز)TextYesPartner id or code of this companyUnknown -> 'Choose a customer or supplier of this company.'; missing at Activate -> 'A certificate names the partner and the tax code it covers.'
Tax code it allowsالرمز الضريبيSelectYesTax code of this companyEX
Certificate referenceمرجع الشهادةTextNoMax 80
SHA-256 of the scanبصمة النسخةTextNoMax 64

Rounding policy

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Company defaultالافتراضي للشركةCheckboxNoOne active default; used when a request names no policy
Prices include taxالأسعار شاملة الضريبةCheckboxNoAmounts are gross: net = amount / (1 + rate)Off
RoundالتقريبSelectNoEach line / Whole document (largest-remainder spread)Each line
Decimal placesالمنازل العشريةNumberNo0 to 627 -> 'Choose between 0 and 6.'
ModeالطريقةSelectNoHalf up / Half to even / DownHalf up

Return form

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
TaxالضريبةSelectNoMust equal the registration's tax when a return is createdVAT
Form versionإصدار النموذجTextNoMax 201
Ledger difference that may stand unexplainedالفرق المسموح دون تفسيرNumberNo0 to 1000 (AED)01001 -> 'Choose between 0 and 1000.'
Boxes (JSON)الخانات (JSON)JSON listYes (to activate)Each {box, label, arabic, measure net|tax|recoverable|net_payable, side sale|purchase|both, treatments, tax_codes, place_of_supply, reverse_charge true/false/null, sign 1/-1}; box numbers unique[{"box":"1a","label":"Standard rated supplies Abu Dhabi","measure":"net","side":"sale","treatments":["standard"],"place_of_supply":"AUH"}]Duplicate box -> 'Box 2 needs its own box number.'; measure 'gross' -> 'Box 1a: measure is one of net, tax, recoverable, net_payable.'; treatment 'vat' -> 'Box 1a: unknown treatment vat.'; sign 2 -> 'Box 1a: sign is 1 or -1.'; no boxes at Activate -> 'A return form needs its boxes.'; not JSON -> 'Boxes are a JSON list.'

Tax group

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Group registration numberرقم تسجيل المجموعةTextNoMax 40
Members (JSON)الأعضاء (JSON)JSON listNo[{company_id, from, to}]; a real company id; from required; to not before from[{"company_id":"<id>","from":"2026-01-01"}]Unknown id -> 'Member 1 needs the id of a company.'; no from -> 'Member 1 needs the date it joined.'; to before from -> 'Member 1 leaves before it joins.'

Withholding rule

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Payee classفئة المستفيدTextNoMax 30NONRESIDENT
Threshold per periodالحد لكل فترةNumberNo0 to 10^150
PeriodالفترةSelectNoMonthly / Quarterly / YearlyYearly
Rate %النسبة %NumberYes0 to 100101 -> 'Choose between 0 and 100.'
Onعلى أساسSelectNoPayment / InvoicePayment(API) 'accrual' -> 'payment or invoice.'

Corporate-tax policy

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Rate %النسبة %NumberNo0 to 100; 0 = workpaper only (no tax worked out)09
Threshold before taxالحد قبل الضريبةNumberNo0 to 10^150375000
Allowed adjustmentsالتعديلات المسموحةLinesNopermanent, temporary, exempt_income, loss_reliefAll four'bonus' -> 'Not adjustment kinds: bonus.'

Country package

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
VersionالإصدارTextYesMax 201
Legal sources (codes)المصادر القانونيةLinesYes (to activate)At least one ACTIVE legal source of the same countryActivate with none active -> 'A country package rests on at least one active legal source of its country. Record and activate the source first.'
Reviewer noteملاحظة المراجعLong textNoMax 500
FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Authority / Document / Versionالجهة / المستند / الإصدارTextNoMax 120 / 200 / 40FTA / Federal Decree-Law No. 8 of 2017 / 2017
Where it is (URL)الرابطTextNoMax 500
SHA-256 of the copy keptبصمة SHA-256TextNoEmpty or 64 hexadecimal characters (made lower-case)'abc' -> 'A SHA-256 is 64 hexadecimal characters.'
What it applies toنطاق التطبيقLong textNoMax 500
Superseded by (code) / Published on / Reviewed onاستُبدل بـ / تاريخ النشر / تاريخ المراجعةText / DateNoMax 30; dates YYYY-MM-DD

New return dialog

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
RegistrationالتسجيلSelectYesActive registration of this company(API) draft one -> 'Choose an active registration of this company.'
Return formنموذج الإقرارSelectYesActive form whose country and tax equal the registration'sSA form for an AE registration -> '<FORM> is a SA vat form; the registration is AE vat.'
First day / Last dayاليوم الأول / اليوم الأخيرDateYesLast not before first; no overlap with another non-amended return of the registrationThis quarter (help text)Last before first -> 'Give a period: its first and last day.'; overlap -> 'VAT-0001 already covers part of this period. Amend it instead.'

Return record > Explain difference

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
ExplanationالتفسيرLong textYesMax 1000; only in Draft/PreparedOn an approved return -> 'An approved or submitted return is not edited. Amend it: a new version is linked to this one.'; on Reviewed -> 'Send the return back to draft to change it.'

Return record (API)

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Boxes / payable / output_taxالخانات / المستحق--Never typedSending boxes -> 'Box amounts come from the posted documents. Correct the documents and prepare again.'

Return record > Submit

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Authority reference (if any)مرجع الجهةTextPer Fields settingMax 80FTA-ACK-2026-0001Required mode and empty -> 'Enter the authority's reference: this company requires it on submission.'

Return record > Acknowledgement

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Authority referenceمرجع الجهةTextYesMax 80Empty -> 'This is required.'

Return record > Amend

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
WhyالسببLong textYesMax 1000Empty -> 'This is required.'

Simulator

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
ForلـSelectYesSale / PurchaseSale(API) none -> 'Say whether this is a sale or a purchase.'
Tax dateتاريخ الضريبةDateYesThe date of supply the law usesTodayEmpty (API) -> 'Give the tax date (the date of supply the law uses).'; no registration covers it -> 'No AE VAT registration covers <date>.' or 'The AE VAT registration ended on <date>; nothing covers <date>. ...'
Customer / supplier (code)العميل / المورد (رمز)TextNoPartner code or id; brings its classes and 'buyer registered' (has a TRN)'NOPE' -> 'No such customer or supplier in this company.'
Ship-to countryدولة الشحن إلىText (2)NoMade capitals; max 2SA
Goods or servicesسلع أو خدماتSelectNoFrom the product / Goods / ServicesFrom the product
Place of supplyمكان التوريدTextNoEmirate/region code, made capitalsDXB
Amounts include taxالمبالغ شاملة الضريبةCheckboxNoOverrides the rounding policy's setting

Simulator > line

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Product (code)المنتج (رمز)TextNoProduct of this company'NOPE' -> 'No product NOPE in this company.'
Tax code (if no rule)الرمز (إن لم توجد قاعدة)SelectWhen no rule decidesBy the rulesNo rule and none chosen -> 'No rule decides line 1 and it names no tax code. Nothing is defaulted.'; a purchase-only code on a sale -> 'RC is not used on a sale.'
AmountالمبلغNumberYesA number1000Empty -> "Give the line's amount (or price and quantity)."; 'abc' -> 'Send a number.'; no lines -> 'Give at least one line.'

New workpaper dialog

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Corporate-tax policyسياسة ضريبة الشركاتSelectNoActive policy; none = no tax worked out(API) draft policy -> 'Choose an active corporate-tax policy.'
First day / Last dayاليوم الأول / اليوم الأخيرDateYesLast not before first1 Jan / 31 Dec (help)Last before first -> "Give the period's first and last day."

Workpaper > Edit adjustments

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Adjustments (JSON)التعديلات (JSON)JSON listYes[{kind, description, amount, account, evidence}]; kind must be allowed by the policy; description required; only in Draft[{"kind":"permanent","description":"Entertainment 50% disallowed","amount":"20000"}]kind 'bonus' -> 'Adjustment 1: bonus is not an allowed kind.'; no description -> 'Adjustment 1 needs a description: what it is and why.'; not JSON -> 'Adjustments are a JSON list.'; on Reviewed -> 'A reviewed or approved workpaper is not edited. Reopen it first.'

Withholding > Work out / Record

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Rule (code)القاعدة (رمز)TextYesActive withholding rule; must cover the dateUnknown/draft -> 'Choose an active withholding rule.'; outside its dates -> '<CODE> does not apply on <date>.'
Payee (code)المستفيد (رمز)TextYesPartner code or idUnknown -> 'Choose the payee.'
DateالتاريخDateYesToday
Gross paymentإجمالي الدفعةNumberYes0.01 to 10^15500000 -> 'Choose between 0.01 and 1E+15.'
Payment referenceمرجع الدفعةTextNoMax 80

Bad-debt relief dialog

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Invoice written offالفاتورة المشطوبةSelectYesA posted customer invoice with an amount written off in AccountingDraft invoice -> 'Relief is claimed on a posted invoice.'; nothing written off -> 'Nothing written off on this invoice is left to relieve. Write the debt off in Accounting first.'; no tax charged -> 'That invoice charged no tax.'
Customer told onتاريخ إشعار العميلDateYesEmpty -> 'Say when the customer was told the debt was written off.'
Amount to relieve (with tax)المبلغ (شاملاً الضريبة)NumberNoBlank = all written off and not yet relieved; above 0 and not more than thatMore than left -> 'Relieve up to the <amount> written off and not yet relieved.'

Bad-debt relief / Import VAT dialog

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Tax dateالتاريخ الضريبيDateYesBad debt: not before invoice date + the settings' months (default 6)Too early -> 'Relief can be claimed from <date>: 6 months after the date of supply (<date>).'; import with none -> 'Give the date of the customs declaration.'
ReasonالسببTextYes for bad debtMax 300Empty (bad debt) -> 'This is required.'

Import VAT dialog

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Customs declarationالبيان الجمركيTextYesMax 80; unique among proposed/posted import VATDXB-IMP-2026-0001Repeat -> 'That customs declaration is already recorded.'
Customs valueالقيمة الجمركيةNumberYesAt least 0.01200000 -> 'Choose between 0.01 and None.'
Tax codeرمز الضريبةTextYesPurchase or both direction; has a rate on the tax dateIM'SR' if sale-only -> 'SR is not used on purchases.'; unknown -> 'XX is not a tax code in this company.'
VAT on the declarationالضريبة في البيانNumberNoWithin 0.05 of value x rate1000.0020000 at 5% with 900 -> "The declaration's VAT 900.00 is not 5.0000% of 20000.00 (1000.00); check the value or the tax code."
Accounted byطريقة الاحتسابSelectYesReverse charge on the return / Paid at the borderReverse charge(API) 'cash' -> 'Reverse charged on the return, or paid at the border.'
Paid from (account)مدفوعة من (حساب)TextWhen PaidMax 20; account code creditedEmpty -> 'This is required.'

Adjustments > Reject

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
WhyالسببTextYesMax 200Empty -> 'This is required.'

Tax settings

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Documents take their tax code from the determination rulesتأخذ المستندات رمز الضريبة من قواعد التحديدCheckboxNoOn + at least one active rule: a line with no tax code gets the rules' code at save; the determination is frozen at postingOn
Unrecoverable VAT on goods received goes into their costتُضاف الضريبة غير المستردة على البضائع المستلمة إلى تكلفتهاCheckboxNoOff
Bad-debt relief: months after the date of supplyإعفاء الديون المعدومة: الأشهر بعد تاريخ التوريدNumberNo0 to 60661 -> 'Choose between 0 and 60.'

Taxes > tax code

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Tax codeرمز ضريبيTextYes2-30 letters, digits, _ or -; made capitals; uniqueSR'S' -> 'Use 2–30 letters, digits, underscores or hyphens.'; existing -> 'Another tax code already uses that code.'
Tax nameاسم الضريبةTextYesMax 120Standard rated 5%Empty -> 'Enter valid text (maximum 120 characters).'
Arabic nameالاسم بالعربيةTextNoMax 120خاضع للنسبة الأساسية ٥٪
Tax typeنوع الضريبةSelectYesvat, withholding, excise, corporate, zakatvat(API) 'gst' -> 'Choose a tax type: vat, withholding, excise, corporate, zakat.'
TreatmentالمعالجةSelectYesStandard rated, Zero rated, Exempt, Out of scope, Reverse charge (kept distinct on returns even at 0%)Standard rated(API) 'free' -> 'Choose a treatment: standard, zero, exempt, out_of_scope, reverse_charge.'
Applies to (direction)يُطبَّق علىSelectYesBoth / Sales / PurchasesBothPurchase-only code on an invoice line -> 'RC is not used on a invoice document.'
Recoverable percentنسبة الاستردادNumberNo0 to 100 (input tax recoverable)100120 -> 'Recovery runs from 0 to 100 percent.'; 'x' -> 'Recovery is a percentage.'
Reverse charge / Importالاحتساب العكسي / استيرادCheckboxNotrue/false only(API) 'yes' -> 'Use true or false.'
Exemption reasonسبب الإعفاءTextNoMax 160Export or qualifying supply
ActiveنشطCheckboxNoAn inactive code is refused on documentsOnInactive code on a line -> 'SR Standard rated 5% is no longer in use.'

Taxes > New rate

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
RateالنسبةNumberYesNot negative5-1 -> 'A rate cannot be negative.'; 'abc' -> 'Enter a rate.'
From / Toمن / إلىDateFrom yesTo empty = 'Until further notice'; windows of one code never overlapTo before From -> 'The closing date cannot precede the opening date.'; overlap -> 'SR already has a rate covering 2026-01-01. Close the existing window first.'; a document dated where no rate exists -> 'SR has no rate for <date>. ...'

Taxes > Install a country's taxes

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
CountryالدولةSelectYesAE, SA, BH, OM, QA, KW; codes already present are left aloneAE (SR 5%, ZR, EX, OS, RC 5%, IM 5%, BL 5% non-recoverable)(API) 'IN' -> 'There is no tax pack for IN.'

Fiscal position

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
CodeالرمزTextYesMax 24; uniqueEXPORTExisting -> 'EXPORT is already a fiscal position.'
Position nameاسم المركزTextYesMax 120Export customersEmpty -> 'Enter valid text (maximum 120 characters).'
Arabic nameالاسم بالعربيةTextNoMax 120عملاء التصدير
How it is appliedطريقة التطبيقSelectYesAutomatically (by tax country) / Only where assigned to a customer. A position set on the partner always winsOnly where assigned
Tax countryالدولة الضريبيةText (2)NoPartner's tax country (or first address country) must match; empty = any country; a country rule beats an empty oneSA
Registered onlyالمسجلون فقطYes/NoNoApplies only to partners with a TRNNo
NoteملاحظةTextNoMax 240

Fiscal position > Tax substitutions

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Instead of -> Charge / postبدلاً من -> احتسب / رحّلPair of tax codesBothUp to 200; one rule per source tax; target 'Nothing at all' removes the tax (not the same as zero rated)SR -> ZRSame source twice -> 'SR is substituted twice. One rule per tax.'; SR -> SR -> 'SR cannot be substituted for itself.'; missing side -> 'A tax substitution names a source and a target.'

Fiscal position > Account substitutions

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Instead of -> Post toبدلاً من -> رحّل إلىPair of accountsBothUp to 200; one rule per source accountSame account twice -> '<code> is substituted twice. One rule per account.'

Applications > Tax > Features

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Determination rules and simulatorقواعد التحديد والمحاكيToggle-Off: Simulate/Determinations hidden; simulate/record refusedOn
Corporate-tax workpapersأوراق عمل ضريبة الشركاتToggle-Off refused while a workpaper is not approvedOnOff with a draft workpaper -> '1 workpaper(s) are not approved yet. Approve them first.'
Withholding taxضريبة الاستقطاعToggle-Off: not worked out or recorded; menus hiddenOn
Tax groupsالمجموعات الضريبيةToggle-Off: a return covers its own company only; refused while an active registration names a groupOnOff with a group registration -> '1 active registration(s) file as a group. Archive or change them first.'
Return approval controls and ledger checkضوابط اعتماد الإقرار ومطابقة الدفاترLocked-Protected - cannot be turned off

Applications > Tax > Fields

FieldArabic labelTypeRequiredRules and limitsDefaultExampleRefused when
Authority reference on submissionمرجع الجهة عند التقديمMode-Optional / RequiredOptional