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 masterRegistrationTax authorityDetermination ruleClassificationExemption certificateRounding policyReturn formTax groupWithholding ruleCorporate-tax policyCountry packageLegal sourceNew return dialogReturn record > Explain differenceReturn record (API)Return record > SubmitReturn record > AcknowledgementReturn record > AmendSimulatorSimulator > lineNew workpaper dialogWorkpaper > Edit adjustmentsWithholding > Work out / RecordBad-debt relief dialogBad-debt relief / Import VAT dialogImport VAT dialogAdjustments > RejectTax settingsTaxes > tax codeTaxes > New rateTaxes > Install a country's taxesFiscal positionFiscal position > Tax substitutionsFiscal position > Account substitutionsApplications > Tax > FeaturesApplications > Tax > Fields
Any tax master
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code | الرمز | Text | Yes | 2-30: capital letter first, then capitals, digits, _ . -; made capitals; unique per kind; create only | AE-VAT | '1AE' -> 'A code is capitals, digits, _ . and - (2-30).'; existing -> 'A tax registration with that code exists.' (kind named) | |
| Name | الاسم | Text | Yes | Max 160 | UAE VAT | Empty -> 'This is required.' | |
| Arabic name | الاسم بالعربية | Text | No | Max 160 | ضريبة القيمة المضافة | ||
| Valid from / Valid to | يسري من / يسري حتى | Date | No | To not before From; outside the window the master does not apply | To before From -> 'The end comes after the start.'; '01-01-2026' -> 'Send the date as YYYY-MM-DD.' | ||
| Notes | ملاحظات | Long text | No | Max 4000 | |||
| Country | الدولة | Select | Yes | GCC only: AE, SA, BH, OM, QA, KW | AE | (API) 'IN' -> 'A GCC country: AE, SA, BH, OM, QA or KW.' |
Registration
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Tax | الضريبة | Select | Yes | VAT, Excise, Withholding, Corporate tax, Zakat | VAT | (API) 'gst' -> 'Choose from: vat, excise, withholding, corporate, zakat.' | |
| Registration number (TRN) | رقم التسجيل الضريبي | Text | Yes (to activate) | Max 40, spaces removed. AE: exactly 15 digits. SA: 15 digits starting and ending with 3 | 100123456700003 | AE '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) | الجهة (رمز) | Text | No | Code of a tax authority of this company | FTA | 'XYZ' -> 'No tax authority XYZ.' | |
| Tax group (code) | المجموعة الضريبية (رمز) | Text | No | Max 30; set when this registration files as a group | GRP-01 | ||
| Evidence (certificate reference) | الدليل (مرجع الشهادة) | Text | No | Max 300 | FTA certificate 2026-001 | ||
| Branch (API) | الفرع | Id | No | Empty = whole company | Activate with dates overlapping an active registration of the same country/tax/branch -> '<CODE> already covers these dates for this tax and branch.' |
Tax authority
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Tax | الضريبة | Select | Yes | As registration | VAT | ||
| Settlement currency | عملة السداد | Text | Yes | 3 letters, capitals | AED | 'DIRHAM' -> 'Keep this to 3 characters or fewer.' | |
| Returns every | الإقرار كل | Select | No | Monthly / Quarterly / Yearly | Quarterly | ||
| Due days after period end | أيام الاستحقاق بعد نهاية الفترة | Number | No | 0 to 365 | 28 | 400 -> 'Choose between 0 and 365.' |
Determination rule
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| For | لـ | Select | Yes | Sales / Purchases / Both | Sales | ||
| Priority (lower wins) | الأولوية (الأقل يفوز) | Number | Yes | 1 to 9999 | 100 | 0 -> 'Choose between 1 and 9999.' | |
| Gives tax code | يعطي الرمز الضريبي | Select | Yes | A 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 | حصري | Checkbox | No | Two exclusive rules matching at the same priority are a conflict | On | Activate 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 | بشهادة إعفاء سارية فقط | Checkbox | No | The partner must hold an active certificate for the code on the tax date | Off | ||
| Conditions (JSON) | الشروط (JSON) | JSON list | No | [{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 | الحقائق المطلوبة | Lines | No | Known facts only | place_of_supply | 'colour' -> 'Not facts: colour.' | |
| Legal source (code) | المصدر القانوني | Text | No | Max 30 | |||
| Explanation shown with the result | التفسير | Long text | No | Max 500 | Export of goods - zero rated |
Classification
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Classifies | يصنّف | Select | Yes | Customer / supplier, Product, Supply | Product | ||
| Category | الفئة | Text | No | Max 80 | Healthcare | ||
| Needs evidence | يحتاج دليلاً | Checkbox | No | Stored; not checked by determination | |||
| Members | الأعضاء | Lines (codes) | No | Partner codes (party) or product codes (product) of this company | MED-001 | 'NOPE' -> 'No product NOPE in this company.' |
Exemption certificate
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Customer / supplier (code) | العميل / المورد (رمز) | Text | Yes | Partner id or code of this company | Unknown -> '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 | الرمز الضريبي | Select | Yes | Tax code of this company | EX | ||
| Certificate reference | مرجع الشهادة | Text | No | Max 80 | |||
| SHA-256 of the scan | بصمة النسخة | Text | No | Max 64 |
Rounding policy
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Company default | الافتراضي للشركة | Checkbox | No | One active default; used when a request names no policy | |||
| Prices include tax | الأسعار شاملة الضريبة | Checkbox | No | Amounts are gross: net = amount / (1 + rate) | Off | ||
| Round | التقريب | Select | No | Each line / Whole document (largest-remainder spread) | Each line | ||
| Decimal places | المنازل العشرية | Number | No | 0 to 6 | 2 | 7 -> 'Choose between 0 and 6.' | |
| Mode | الطريقة | Select | No | Half up / Half to even / Down | Half up |
Return form
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Tax | الضريبة | Select | No | Must equal the registration's tax when a return is created | VAT | ||
| Form version | إصدار النموذج | Text | No | Max 20 | 1 | ||
| Ledger difference that may stand unexplained | الفرق المسموح دون تفسير | Number | No | 0 to 1000 (AED) | 0 | 1001 -> 'Choose between 0 and 1000.' | |
| Boxes (JSON) | الخانات (JSON) | JSON list | Yes (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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Group registration number | رقم تسجيل المجموعة | Text | No | Max 40 | |||
| Members (JSON) | الأعضاء (JSON) | JSON list | No | [{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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Payee class | فئة المستفيد | Text | No | Max 30 | NONRESIDENT | ||
| Threshold per period | الحد لكل فترة | Number | No | 0 to 10^15 | 0 | ||
| Period | الفترة | Select | No | Monthly / Quarterly / Yearly | Yearly | ||
| Rate % | النسبة % | Number | Yes | 0 to 100 | 101 -> 'Choose between 0 and 100.' | ||
| On | على أساس | Select | No | Payment / Invoice | Payment | (API) 'accrual' -> 'payment or invoice.' |
Corporate-tax policy
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Rate % | النسبة % | Number | No | 0 to 100; 0 = workpaper only (no tax worked out) | 0 | 9 | |
| Threshold before tax | الحد قبل الضريبة | Number | No | 0 to 10^15 | 0 | 375000 | |
| Allowed adjustments | التعديلات المسموحة | Lines | No | permanent, temporary, exempt_income, loss_relief | All four | 'bonus' -> 'Not adjustment kinds: bonus.' |
Country package
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Version | الإصدار | Text | Yes | Max 20 | 1 | ||
| Legal sources (codes) | المصادر القانونية | Lines | Yes (to activate) | At least one ACTIVE legal source of the same country | Activate 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 text | No | Max 500 |
Legal source
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Authority / Document / Version | الجهة / المستند / الإصدار | Text | No | Max 120 / 200 / 40 | FTA / Federal Decree-Law No. 8 of 2017 / 2017 | ||
| Where it is (URL) | الرابط | Text | No | Max 500 | |||
| SHA-256 of the copy kept | بصمة SHA-256 | Text | No | Empty or 64 hexadecimal characters (made lower-case) | 'abc' -> 'A SHA-256 is 64 hexadecimal characters.' | ||
| What it applies to | نطاق التطبيق | Long text | No | Max 500 | |||
| Superseded by (code) / Published on / Reviewed on | استُبدل بـ / تاريخ النشر / تاريخ المراجعة | Text / Date | No | Max 30; dates YYYY-MM-DD |
New return dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Registration | التسجيل | Select | Yes | Active registration of this company | (API) draft one -> 'Choose an active registration of this company.' | ||
| Return form | نموذج الإقرار | Select | Yes | Active form whose country and tax equal the registration's | SA form for an AE registration -> '<FORM> is a SA vat form; the registration is AE vat.' | ||
| First day / Last day | اليوم الأول / اليوم الأخير | Date | Yes | Last not before first; no overlap with another non-amended return of the registration | This 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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Explanation | التفسير | Long text | Yes | Max 1000; only in Draft/Prepared | On 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)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Boxes / payable / output_tax | الخانات / المستحق | - | - | Never typed | Sending boxes -> 'Box amounts come from the posted documents. Correct the documents and prepare again.' |
Return record > Submit
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Authority reference (if any) | مرجع الجهة | Text | Per Fields setting | Max 80 | FTA-ACK-2026-0001 | Required mode and empty -> 'Enter the authority's reference: this company requires it on submission.' |
Return record > Acknowledgement
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Authority reference | مرجع الجهة | Text | Yes | Max 80 | Empty -> 'This is required.' |
Return record > Amend
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Why | السبب | Long text | Yes | Max 1000 | Empty -> 'This is required.' |
Simulator
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| For | لـ | Select | Yes | Sale / Purchase | Sale | (API) none -> 'Say whether this is a sale or a purchase.' | |
| Tax date | تاريخ الضريبة | Date | Yes | The date of supply the law uses | Today | Empty (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) | العميل / المورد (رمز) | Text | No | Partner 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) | No | Made capitals; max 2 | SA | ||
| Goods or services | سلع أو خدمات | Select | No | From the product / Goods / Services | From the product | ||
| Place of supply | مكان التوريد | Text | No | Emirate/region code, made capitals | DXB | ||
| Amounts include tax | المبالغ شاملة الضريبة | Checkbox | No | Overrides the rounding policy's setting |
Simulator > line
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Product (code) | المنتج (رمز) | Text | No | Product of this company | 'NOPE' -> 'No product NOPE in this company.' | ||
| Tax code (if no rule) | الرمز (إن لم توجد قاعدة) | Select | When no rule decides | By the rules | No 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 | المبلغ | Number | Yes | A number | 1000 | Empty -> "Give the line's amount (or price and quantity)."; 'abc' -> 'Send a number.'; no lines -> 'Give at least one line.' |
New workpaper dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Corporate-tax policy | سياسة ضريبة الشركات | Select | No | Active policy; none = no tax worked out | (API) draft policy -> 'Choose an active corporate-tax policy.' | ||
| First day / Last day | اليوم الأول / اليوم الأخير | Date | Yes | Last not before first | 1 Jan / 31 Dec (help) | Last before first -> "Give the period's first and last day." |
Workpaper > Edit adjustments
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Adjustments (JSON) | التعديلات (JSON) | JSON list | Yes | [{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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Rule (code) | القاعدة (رمز) | Text | Yes | Active withholding rule; must cover the date | Unknown/draft -> 'Choose an active withholding rule.'; outside its dates -> '<CODE> does not apply on <date>.' | ||
| Payee (code) | المستفيد (رمز) | Text | Yes | Partner code or id | Unknown -> 'Choose the payee.' | ||
| Date | التاريخ | Date | Yes | Today | |||
| Gross payment | إجمالي الدفعة | Number | Yes | 0.01 to 10^15 | 50000 | 0 -> 'Choose between 0.01 and 1E+15.' | |
| Payment reference | مرجع الدفعة | Text | No | Max 80 |
Bad-debt relief dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Invoice written off | الفاتورة المشطوبة | Select | Yes | A posted customer invoice with an amount written off in Accounting | Draft 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 | تاريخ إشعار العميل | Date | Yes | Empty -> 'Say when the customer was told the debt was written off.' | |||
| Amount to relieve (with tax) | المبلغ (شاملاً الضريبة) | Number | No | Blank = all written off and not yet relieved; above 0 and not more than that | More than left -> 'Relieve up to the <amount> written off and not yet relieved.' |
Bad-debt relief / Import VAT dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Tax date | التاريخ الضريبي | Date | Yes | Bad 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 | السبب | Text | Yes for bad debt | Max 300 | Empty (bad debt) -> 'This is required.' |
Import VAT dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Customs declaration | البيان الجمركي | Text | Yes | Max 80; unique among proposed/posted import VAT | DXB-IMP-2026-0001 | Repeat -> 'That customs declaration is already recorded.' | |
| Customs value | القيمة الجمركية | Number | Yes | At least 0.01 | 20000 | 0 -> 'Choose between 0.01 and None.' | |
| Tax code | رمز الضريبة | Text | Yes | Purchase or both direction; has a rate on the tax date | IM | 'SR' if sale-only -> 'SR is not used on purchases.'; unknown -> 'XX is not a tax code in this company.' | |
| VAT on the declaration | الضريبة في البيان | Number | No | Within 0.05 of value x rate | 1000.00 | 20000 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 | طريقة الاحتساب | Select | Yes | Reverse charge on the return / Paid at the border | Reverse charge | (API) 'cash' -> 'Reverse charged on the return, or paid at the border.' | |
| Paid from (account) | مدفوعة من (حساب) | Text | When Paid | Max 20; account code credited | Empty -> 'This is required.' |
Adjustments > Reject
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Why | السبب | Text | Yes | Max 200 | Empty -> 'This is required.' |
Tax settings
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Documents take their tax code from the determination rules | تأخذ المستندات رمز الضريبة من قواعد التحديد | Checkbox | No | On + at least one active rule: a line with no tax code gets the rules' code at save; the determination is frozen at posting | On | ||
| Unrecoverable VAT on goods received goes into their cost | تُضاف الضريبة غير المستردة على البضائع المستلمة إلى تكلفتها | Checkbox | No | Off | |||
| Bad-debt relief: months after the date of supply | إعفاء الديون المعدومة: الأشهر بعد تاريخ التوريد | Number | No | 0 to 60 | 6 | 61 -> 'Choose between 0 and 60.' |
Taxes > tax code
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Tax code | رمز ضريبي | Text | Yes | 2-30 letters, digits, _ or -; made capitals; unique | SR | 'S' -> 'Use 2–30 letters, digits, underscores or hyphens.'; existing -> 'Another tax code already uses that code.' | |
| Tax name | اسم الضريبة | Text | Yes | Max 120 | Standard rated 5% | Empty -> 'Enter valid text (maximum 120 characters).' | |
| Arabic name | الاسم بالعربية | Text | No | Max 120 | خاضع للنسبة الأساسية ٥٪ | ||
| Tax type | نوع الضريبة | Select | Yes | vat, withholding, excise, corporate, zakat | vat | (API) 'gst' -> 'Choose a tax type: vat, withholding, excise, corporate, zakat.' | |
| Treatment | المعالجة | Select | Yes | Standard 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) | يُطبَّق على | Select | Yes | Both / Sales / Purchases | Both | Purchase-only code on an invoice line -> 'RC is not used on a invoice document.' | |
| Recoverable percent | نسبة الاسترداد | Number | No | 0 to 100 (input tax recoverable) | 100 | 120 -> 'Recovery runs from 0 to 100 percent.'; 'x' -> 'Recovery is a percentage.' | |
| Reverse charge / Import | الاحتساب العكسي / استيراد | Checkbox | No | true/false only | (API) 'yes' -> 'Use true or false.' | ||
| Exemption reason | سبب الإعفاء | Text | No | Max 160 | Export or qualifying supply | ||
| Active | نشط | Checkbox | No | An inactive code is refused on documents | On | Inactive code on a line -> 'SR Standard rated 5% is no longer in use.' |
Taxes > New rate
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Rate | النسبة | Number | Yes | Not negative | 5 | -1 -> 'A rate cannot be negative.'; 'abc' -> 'Enter a rate.' | |
| From / To | من / إلى | Date | From yes | To empty = 'Until further notice'; windows of one code never overlap | To 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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Country | الدولة | Select | Yes | AE, SA, BH, OM, QA, KW; codes already present are left alone | AE (SR 5%, ZR, EX, OS, RC 5%, IM 5%, BL 5% non-recoverable) | (API) 'IN' -> 'There is no tax pack for IN.' |
Fiscal position
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code | الرمز | Text | Yes | Max 24; unique | EXPORT | Existing -> 'EXPORT is already a fiscal position.' | |
| Position name | اسم المركز | Text | Yes | Max 120 | Export customers | Empty -> 'Enter valid text (maximum 120 characters).' | |
| Arabic name | الاسم بالعربية | Text | No | Max 120 | عملاء التصدير | ||
| How it is applied | طريقة التطبيق | Select | Yes | Automatically (by tax country) / Only where assigned to a customer. A position set on the partner always wins | Only where assigned | ||
| Tax country | الدولة الضريبية | Text (2) | No | Partner's tax country (or first address country) must match; empty = any country; a country rule beats an empty one | SA | ||
| Registered only | المسجلون فقط | Yes/No | No | Applies only to partners with a TRN | No | ||
| Note | ملاحظة | Text | No | Max 240 |
Fiscal position > Tax substitutions
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Instead of -> Charge / post | بدلاً من -> احتسب / رحّل | Pair of tax codes | Both | Up to 200; one rule per source tax; target 'Nothing at all' removes the tax (not the same as zero rated) | SR -> ZR | Same 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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Instead of -> Post to | بدلاً من -> رحّل إلى | Pair of accounts | Both | Up to 200; one rule per source account | Same account twice -> '<code> is substituted twice. One rule per account.' |
Applications > Tax > Features
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Determination rules and simulator | قواعد التحديد والمحاكي | Toggle | - | Off: Simulate/Determinations hidden; simulate/record refused | On | ||
| Corporate-tax workpapers | أوراق عمل ضريبة الشركات | Toggle | - | Off refused while a workpaper is not approved | On | Off with a draft workpaper -> '1 workpaper(s) are not approved yet. Approve them first.' | |
| Withholding tax | ضريبة الاستقطاع | Toggle | - | Off: not worked out or recorded; menus hidden | On | ||
| Tax groups | المجموعات الضريبية | Toggle | - | Off: a return covers its own company only; refused while an active registration names a group | On | Off 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
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Authority reference on submission | مرجع الجهة عند التقديم | Mode | - | Optional / Required | Optional |