Corporate-tax workpapers and withholding
Work out corporate tax from the ledger with adjustments and three-person sign-off, and work out and record withholding on payments.
Before you begin
- The features Corporate-tax workpapers and Withholding tax are on in Applications > Tax > Features. If they are off, the menus Tax > Corporate tax and Tax > Withholding are hidden.
- A tax administrator has created and a second administrator has activated the Corporate-tax policy and the Withholding rule you need (Tax > Configuration).
Corporate tax workpaper
A workpaper takes accounting profit from the ledger, applies your adjustments and works out the taxable basis and the tax.
Set up the policy
In Tax > Configuration > Corporate-tax policies a policy holds the Rate % (0 to 100; 0 means a workpaper only, no tax worked out), the Threshold before tax (for example 375,000) and the Allowed adjustments: permanent, temporary, exempt income and loss relief.
Steps: prepare
- Choose Tax > Corporate tax.
- Press New.
- Choose the Corporate-tax policy (or none to show profit only).
- Type the First day and Last day, for example 2026-01-01 and 2026-12-31.
- Confirm. The workpaper opens as a draft.
- Press Edit adjustments and enter them as a JSON list. Each needs a kind, a description, an amount and optionally an account and evidence.
- Save.
Example adjustment: [{"kind":"permanent","description":"Entertainment 50% disallowed","amount":"20000"}].
Worked example
Posted income 1,000,000 and expense 500,000 in 2026. Policy: 9 % above 375,000.
- Accounting profit 500,000.00. Taxable basis 500,000.00. Tax = (500,000 - 375,000) x 9 % = 11,250.00.
- With a permanent adjustment of +20,000: taxable 520,000.00, tax = (520,000 - 375,000) x 9 % = 13,050.00.
- With a policy rate of 0 or no policy: tax 0.00 and the message 'No rate configured: no tax worked out'.
Review, approve, reopen
- Person A creates the workpaper.
- Person B presses Review. The figures are recomputed from the ledger.
- Person C presses Approve. The workpaper is locked.
- Reopen returns a workpaper to draft (before approval).
The creator cannot review or approve; the reviewer cannot approve. A reviewed or approved workpaper cannot be edited: 'A reviewed or approved workpaper is not edited. Reopen it first.'
Refusals
| Situation | Message |
|---|---|
| Kind not allowed | 'Adjustment 1: bonus is not an allowed kind.' |
| No description | 'Adjustment 1 needs a description: what it is and why.' |
| Not a JSON list | 'Adjustments are a JSON list.' |
| Last day before first | "Give the period's first and last day." |
| Draft policy | 'Choose an active corporate-tax policy.' |
Withholding
Withholding works out how much to hold back from a payment to a payee, using a rule with a threshold per period.
Steps
- Choose Tax > Withholding.
- Press Work out.
- Choose the Rule (code), the Payee (code), the Date and the Gross payment. Optionally add a Payment reference.
- Read the result: accumulated payments, amount subject, amount withheld and net payment.
- Press Record to save it.
The rule needs Payee class, Threshold per period (default 0), Period (monthly, quarterly, yearly), Rate % and On (payment or invoice).
Worked example
Rule: yearly threshold 50,000 AED, rate 5 %.
| Payment | Accumulated before | Subject | Withheld | Net |
|---|---|---|---|---|
| 30,000 | 0 | 0 | 0.00 | 30,000.00 |
| 40,000 | 30,000 | 20,000 | 1,000.00 | 39,000.00 |
The second payment pushes the year to 70,000, so 20,000 is above the threshold and 5 % of that is withheld.
Refusals
| Situation | Message |
|---|---|
| Rule inactive or unknown | 'Choose an active withholding rule.' |
| Date outside the rule | '<CODE> does not apply on <date>.' |
| Payee unknown | 'Choose the payee.' |
| Gross amount zero | 'Choose between 0.01 and 1E+15.' |
Good to know
- Withholding rules and tax groups masters can be created while their features are off; the feature controls the menus and the work-out screens.
- Turning corporate tax off is refused while a workpaper is not approved: '1 workpaper(s) are not approved yet. Approve them first.'