Field reference
Every field on every Employee Self Service form: label in English and Arabic, type, whether it is required, its limits, a valid example and what the system refuses.
On this page (38)
Attendance > TodayRequests > Attendance correctionLeave > Apply LeaveLeave > Withdraw / Request cancellationRequests > OvertimeRequests > LoanRequests > Salary advanceRequests > Bank changeRequests > Air ticketRequests > AssetRequests > LetterRequests > TrainingRequests > Business tripRequests > Add dependentRequests > QualificationRequests > ResignationRequests > Shift swap / Other requestMy Profile > Request a profile changeDocuments > RenewEmployment > Contract actionExpenses > claimTimesheets > Log timeTasks > New taskTasks > open a taskProbation Reviews > ReviewApprovals > Approve / RejectHome > CustomiseSelf-service setup > Work locationsSelf-service setup > Attendance policiesSelf-service setup > ShiftsSelf-service setup > Shift assignmentsSelf-service setup > Request workflowsSelf-service setup > Country rulesSelf-service setup > AnnouncementsSelf-service setup > Asset assignments / Enrolments / Benefits / Dependents / Salary accountsPayroll runsESS feature switchesESS field settings
Attendance > Today
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Method (sent automatically) | طريقة التسجيل | Select (web, mobile, biometric, qr, gps, geofence, manual, import, kiosk) | No | The portal sends 'web', or 'gps' when the browser gives a location. Must be one of the methods the employee's attendance policy allows; with no policy the allowed methods are web and mobile | web | web | A method outside the policy -> 'Your attendance policy does not allow this method.'; an unknown method -> 'That is not an attendance method.' |
| Location (latitude / longitude) | الموقع | Number pair (read at the punch only) | Conditional | Required only when the attendance policy says 'Require location'. Compared with the nearest permitted active work location; inside its radius = within fence. Never tracked between punches | 25.2048, 55.2708 (Dubai) | No location when required -> 'Allow location to record attendance here.'; outside the radius with 'Enforce geofence' -> 'You are outside your permitted work location. Raise a field duty or remote work correction instead.' | |
| Offline punch time (captured at) | وقت البصمة دون اتصال | Date and time (automatic) | Conditional | Set by the browser when the punch could not be sent. Not more than 2 minutes in the future; not older than 72 hours; the policy must allow offline punches | A punch made 3 hours ago while offline | Older than 72 hours -> 'An offline punch older than 72 hours needs a correction request.'; in the future -> 'A punch cannot be in the future.'; policy forbids -> 'Offline attendance is not allowed for you.' |
Requests > Attendance correction
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Correction | التصحيح | Select (Missing check-in, Missing check-out, Wrong time, Wrong shift, Forgot break, Field duty, Remote work correction) | Yes | One of the 7 options | Missing check-out | Empty -> 'Correction is required.'; other text -> 'Choose one of the options.' | |
| Date | التاريخ | Date | Yes | A day that has happened (today or earlier, company Dubai date) | Thursday 1 Oct 2026 | Tomorrow -> 'A correction is for a day that has happened.'; 31/02/2026 -> 'Enter a valid date.' | |
| Check-in time | وقت الدخول | Time (HH:MM) | Conditional | Required for 'Missing check-in' and 'Wrong time' | 09:05 | Missing check-in with no time -> 'Say what time you checked in.'; '25:99' -> 'Enter a valid time.' | |
| Check-out time | وقت الخروج | Time (HH:MM) | Conditional | Required for 'Missing check-out' | 18:10 | Missing check-out with no time -> 'Say what time you checked out.' | |
| Reason | السبب | Long text (kept to 2,000 characters) | Yes | Free text | Forgot to tap out, left in a hurry | Empty -> 'Reason is required.' |
Leave > Apply Leave
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Leave type | نوع الإجازة | Select (active leave types) | Yes | Archived types are refused; types with a minimum service need it | First type in the list | Annual leave | An archived type (API) -> 'That leave type is archived.'; minimum service -> 'Sick leave needs 3 months of service.' (type name and months vary) |
| From / To | من / إلى | Date range | Yes | End on or after start; must overlap no pending or approved leave; days that are all weekend or holiday are refused; must not run past a termination's last day | Mon 5 Oct 2026 to Thu 8 Oct 2026 | To before From -> 'Leave cannot end before it starts.'; empty -> 'Choose the dates.'; overlap -> 'This time overlaps Annual leave already requested (...)'; Sat+Sun only -> 'Those days are not worked, so there is no leave to take.' | |
| Half day at start / end | نصف يوم في البداية / النهاية | Option | No | Only for leave types that allow half days | Whole day | Half day on the first day | On a whole-day-only type (API) -> 'This leave type is taken in whole days.' |
| Part of day / hours | جزء من اليوم / ساعات | Morning, Afternoon or from-to hours | No | Hours only for leave types taken in hours | Whole day | Afternoon | Hours on a day-only type -> 'This leave type is not taken in hours.' |
| Reason | السبب | Long text | No | Kept to 1,000 characters together with the extra answers below, which are appended to it | Family visit | Over 1,000 characters is cut, not refused | |
| Emergency contact | جهة الاتصال للطوارئ | Text | No | Appended to the reason as 'emergency contact: ...' | Sara Khan 050 000 0000 (test) | None | |
| Work handed to | تسليم العمل إلى | Text | No | Appended to the reason as 'delegate: ...' | Omar Haddad | None | |
| Travelling abroad? | السفر للخارج؟ | Select (No, Yes) | No | Appended to the reason as 'travel required: yes' | No | Yes | None |
| Air ticket | تذكرة الطيران | Select (Not needed, Request my ticket) | No | Appended to the reason as 'ticket request: requested' | Not needed | Request my ticket | None |
Leave > Withdraw / Request cancellation
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Reason | السبب | Long text | Conditional | Optional on screen; the HR leave engine requires it to cancel approved leave | Plans changed | Cancelling approved leave with no reason (API) -> 'Say why the approved leave should be cancelled.'; on a leave that is neither pending nor approved -> 'Only pending or approved leave can be cancelled.' |
Requests > Overtime
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Date | التاريخ | Date | Yes | Any valid date | Wednesday 30 Sep 2026 | 'Enter a valid date.' | |
| Hours | الساعات | Number | Yes | Greater than zero | 2.5 | 0 or -1 -> 'Enter a positive number.'; 'abc' -> 'Enter a number.' | |
| Reason | السبب | Long text | Yes | Free text | Month-end closing | Empty -> 'Reason is required.' |
Requests > Loan
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Amount | المبلغ | Money (AED) | Yes | Greater than zero | 6000 | 0 -> 'Enter a positive number.' | |
| Monthly installments | عدد الأقساط الشهرية | Number | Yes | Greater than zero; the instalment is Amount / this number rounded to 2 decimals | 12 | 0 -> 'Enter a positive number.' | |
| Purpose | الغرض | Long text | Yes | Free text | Car repair | Empty -> 'Purpose is required.' |
Requests > Salary advance
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Amount | المبلغ | Money (AED) | Yes | Greater than zero; recovered in one instalment | 2000 | 'Enter a positive number.' |
Requests > Bank change
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Bank | البنك | Text | Yes | Free text | Emirates NBD (test) | Empty -> 'Bank is required.' | |
| IBAN | رقم الآيبان | Text | Yes | No format or length check at all; spaces removed and upper-cased on approval | AE07 0331 2345 6789 0123 456 | Empty -> 'IBAN is required.'; but 'hello' is accepted | |
| Account name | اسم الحساب | Text | Yes | Free text | Aisha Khan | Empty -> 'Account name is required.' | |
| SWIFT / BIC | سويفت | Text | No | Free text | EBILAEAD | None |
Requests > Air ticket
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Destination | الوجهة | Text | Yes | Free text | Kochi | Empty -> 'Destination is required.' | |
| Travel date | تاريخ السفر | Date | Yes | Valid date | 15 Dec 2026 | 'Enter a valid date.' | |
| Take as cash instead | استلام نقداً بدلاً منها | Select (No, Yes) | No | No or Yes | No | Other value -> 'Choose one of the options.' |
Requests > Asset
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Request / Asset | الطلب / الأصل | Select + asset list | Yes | Request: New asset, Report an issue, Replacement, Return. The asset must be one currently assigned to the employee | Return, Laptop L-0012 | An asset held by someone else -> 'That asset is not assigned to you.' | |
| Details | التفاصيل | Long text | Yes | Free text | Battery swollen | Empty -> 'Details is required.' |
Requests > Letter
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Letter type | نوع الخطاب | Select (Salary certificate, Employment certificate, NOC, Experience certificate, Bank salary letter, Embassy letter, Visa letter, Custom HR letter) | Yes | One of 8 | Salary certificate | 'Choose one of the options.' | |
| Language | اللغة | Select (English, Arabic, Bilingual) | Yes | One of 3 | English | Bilingual | Empty -> 'Language is required.' |
| Purpose | الغرض | Text | Yes | Printed in NOC, Embassy, Visa and Custom letters | Bank loan application | Empty -> 'Purpose is required.' | |
| Addressed to | موجّه إلى | Text | No | Printed after 'To:'; blank prints 'To whom it may concern' | Emirates NBD | None |
Requests > Training
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Course / Or describe the training | الدورة / أو صف التدريب | Select + text | Conditional | Choosing a course creates an enrolment on approval; a free-text title does not | Course: Fire Safety | None | |
| Why | السبب | Long text | Yes | Free text | Required for my new role | Empty -> 'Why is required.' |
Requests > Business trip
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Departs / Returns | المغادرة / العودة | Dates | Yes | Return on or after departure | 2 Nov 2026 to 5 Nov 2026 | Return before departure -> 'The trip cannot end before it starts.' | |
| Estimated cost | التكلفة التقديرية | Money (AED) | No | Greater than zero when given; becomes the request amount | 3500 | 0 -> 'Enter a positive number.' |
Requests > Add dependent
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Name / Relationship | الاسم / صلة القرابة | Text + select (Spouse, Child, Parent) | Yes | Both required | Maryam Khan, Child | Empty name -> 'Name is required.' | |
| Add to medical insurance | إضافة إلى التأمين الطبي | Select (Yes, No) | No | Yes marks the dependent insured on approval | Yes | None |
Requests > Qualification
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Kind / Title | النوع / العنوان | Select + text | Yes | Kind: Education, Experience, Qualification, Professional licence | Qualification, PMP certificate | Empty title -> 'Title is required.' |
Requests > Resignation
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Proposed last working day | آخر يوم عمل مقترح | Date | Yes | Valid date (notice period is not checked here) | 31 Dec 2026 | 'Enter a valid date.' | |
| Reason | السبب | Long text | Yes | Free text | Relocating | Empty -> 'Reason is required.' |
Requests > Shift swap / Other request
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Swap with / Subject and Details | التبديل مع / الموضوع والتفاصيل | Text | Yes | Shift swap: Date, Swap with required. Other request: Subject, Details required | Swap with Omar on 8 Oct | Empty Subject -> 'Subject is required.' |
My Profile > Request a profile change
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Work phone | هاتف العمل | Text (max 40) | No | At least one field must change | Current value | 04 000 0000 (test) | Nothing changed -> 'Change at least one field.'; 41+ characters -> a length message from the form check |
| Personal email | البريد الشخصي | Email (max 254) | No | One '@', no spaces; hidden if the company hides it | Current value | aisha.test@example.com | 'aisha.test' -> the message starts 'Value error, Use a valid email address.'; hidden by the company -> refused (see Features and Fields) |
| Personal phone | الهاتف الشخصي | Text (max 40) | No | Free text | Current value | 050 000 0001 (test) | None |
| Emergency contact (name, relationship, phone) | جهة الطوارئ / صلة القرابة / هاتف الطوارئ | Text (160 / 60 / 40) | No | Hidden together if the company hides emergency contact | Current value | Sara Khan, Sister, 050 000 0002 (test) | A second change while one is pending -> 'Finish or cancel the pending profile change first.' |
| Reason | السبب | Long text (max 500) | No | Free text | New number | Over 500 characters is cut |
Documents > Renew
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| New number | الرقم الجديد | Text | No | Free text; never shown to managers | 784-1990-1234567-1 (test) | None | |
| Issuing authority | جهة الإصدار | Text | No | Prefilled from the document | Current | ICP | None |
| Issued on / Expires on | تاريخ الإصدار / تاريخ الانتهاء | Dates | Yes (Expires on) | Expiry not before issue date | Issued 1 Oct 2026, expires 30 Sep 2028 | Expiry before issue -> 'A document cannot expire before it was issued.' | |
| Reason | السبب | Text | Yes (server) | Not starred on screen | Card expired | Empty -> 'Say why this document is being renewed.' | |
| The new copy (PDF or image) | النسخة الجديدة (PDF أو صورة) | Files | Yes (server) | 1 to 5 files, 20 MB together, PDF or image only | new-eid.pdf | None -> 'Attach at least one renewal document.'; 6 files -> 'Attach no more than 5 files.'; 21 MB -> 'Keep the combined renewal evidence under 20 MB.'; a second renewal -> 'A renewal request is already pending.' |
Employment > Contract action
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Note | ملاحظة | Long text (kept to 500) | Conditional | Required for 'Ask a question' and 'Request amendment'; optional for Acknowledge | Is the housing allowance included? | Empty on a question -> 'Say what should change or what is unclear.' |
Expenses > claim
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| What is it for? (claim title) | ما الغرض منها؟ | Text | Yes | Opens a draft claim for the signed-in employee | Client visit - Abu Dhabi | Empty -> the message 'Give the claim a title.' (shown under 'Check the highlighted fields.') | |
| Category | الفئة | Select (expense categories) | Yes | Active categories; each has a receipt threshold and a per-line limit | First category | Meals | None chosen (API) -> 'Choose a category.'; over the limit at submit -> 'Above the Meals limit of 150.00.' |
| Date | التاريخ | Date | Yes | YYYY-MM-DD | Today | 1 Oct 2026 | Bad date (API) -> 'Send the date as YYYY-MM-DD.' |
| Merchant | التاجر | Text | Per company setting | Hidden, Shown or Required by Features and Fields > Expense merchant | Salam Restaurant | Required and empty -> 'Expense merchant is required by this company before this step.' (text varies by label); hidden and sent -> 'Expense merchant is turned off for this company.' | |
| Amount | المبلغ | Money (AED, 2 decimals) | Yes | Not negative | 120.50 | -5 -> 'An expense cannot be negative.'; 'abc' -> 'Send the amount as a decimal string.' | |
| Business purpose | الغرض من العمل | Text | Yes | Needed to submit | Lunch with client | Empty at submit -> 'Say what this was for.' |
Timesheets > Log time
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Date | التاريخ | Date | Yes | Not more than 7 days after today | Selected day | Thursday 1 Oct 2026 | Empty -> 'Choose the date.'; 15 Oct 2026 (today is 2 Oct) -> 'That date is too far ahead.' |
| Hours | الساعات | Number (step 0.25, kept to 2 decimals) | Yes | More than 0 and not more than 24; the day's total across entries not over 24 | 7.5 | 0 or 25 -> 'Enter between 0 and 24 hours.'; blank -> 'Enter the hours.'; 8 + 16.5 on one day -> 'A day has 24 hours; this would log more.' | |
| Task | المهمة | Select (my open tasks) | No | Only a task assigned to me | No task | TSK-00004 | Someone else's task (API) -> 'That task is not yours.' |
| Project | المشروع | Text (max 120) | No | Filled from the task | Marina Tower fit-out | None | |
| What was done | ما تم إنجازه | Text (max 300) | No | Free text | Site survey | Over 300 is cut | |
| Billable to a client | قابل للفوترة | Tick box | No | Yes / No | No | Yes | None |
Tasks > New task
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Title | العنوان | Text (max 200) | Yes | Not blank | Prepare Q4 budget | Blank -> 'Give the task a title.' | |
| Project | المشروع | Text (max 120) | No | Free text | Finance | None | |
| Due date | تاريخ الاستحقاق | Date | No | Valid date | 9 Oct 2026 | 'Enter a valid date.' | |
| Priority | الأولوية | Select (Low, Medium, High, Urgent) | Yes | One of 4 | Medium | High | Other value (API) -> 'Choose a priority.' |
| Repeats | التكرار | Select (Does not repeat, Daily, Weekly, Monthly) | No | One of 4 | Does not repeat | Weekly | Other value (API) -> 'Choose how it repeats.' |
| Assign to | إسناد إلى | Select (Myself + my team) | No | Shown only to people who manage someone; anyone outside my team is refused | Myself | Omar Haddad (a team member) | Someone not in my team (API) -> 'You can assign tasks only to yourself or your team.' |
| Checklist (one per line) | قائمة التحقق | Long text, one item per line | No | Each item kept to 200 characters; blank lines dropped | Collect quotes Compare Send | None |
Tasks > open a task
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Progress | التقدم | Slider 0-100 (step 5) | No | Whole number 0-100; above 0 moves 'Not started' to 'In progress'; when a checklist exists progress is the share of ticked items | 0 | 50 | 'abc' or 120 (API) -> 'Progress is a number from 0 to 100.' |
| Hours / Note (log time) | الساعات / ملاحظة | Number + text | Yes (hours) | Hours plus optional minutes, 1 minute to 24 hours, date today or earlier; also creates a draft timesheet line | 1.5 | 0 or 25 -> 'Enter between a minute and a day.'; a future date (API) -> 'Time is logged for today or earlier.' | |
| Comment | تعليق | Long text (max 4,000) | Yes | Not blank | Waiting for quotes | Blank -> 'Write the comment.' | |
| Status | الحالة | Select (Not started, In progress, Waiting, Blocked, Completed, Cancelled) | No | Completed goes through Mark complete | Not started | Waiting | Other value (API) -> 'Choose a status.' |
Probation Reviews > Review
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Rating (1-5) | التقييم (1-5) | Select 5..1 | Yes | Whole number 1 to 5 | 4 | 4 | 0 or 6 (API) -> 'Rate 1 to 5.' |
| Recommendation | التوصية | Select (Confirm, Extend, End employment) | Yes | confirm, extend or terminate | Confirm | Extend | Other (API) -> 'Choose a recommendation.' |
| How did it go? | كيف كان الأداء؟ | Long text (4,000) | Yes | Not blank | Good progress, needs more client exposure | Blank -> 'Say how the probation went.' |
Approvals > Approve / Reject
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Note / Why | ملاحظة / السبب | Long text | Conditional | Optional when approving; mandatory when rejecting | Approved, enjoy the break | Reject with no reason -> 'Say why it is rejected.' (requests), 'Say why it was refused.' (leave), 'Say what needs correcting.' (timesheet) |
Home > Customise
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Quick actions / Hidden cards / Order | الإجراءات السريعة / البطاقات المخفية / الترتيب | Choices | Yes (at least one quick action) | Up to 8 quick actions from the 10 offered; 9 cards that can be hidden and re-ordered; saved per person | 6 quick actions | Hide 'assistant', keep 5 quick actions | No quick action -> 'Choose at least one quick action.' |
Self-service setup > Work locations
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name | الرمز / الاسم | Text | Yes | Both required | DXB-HQ, Dubai Head Office | Empty -> 'Code is required.' | |
| Latitude / Longitude / Geofence radius (m) | خط العرض / خط الطول / نصف قطر السياج | Numbers | No | Decimal numbers; radius whole metres | 25.2048, 55.2708, 150 | 'abc' -> 'Latitude is not valid.' |
Self-service setup > Attendance policies
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Employee (empty = everyone) | الموظف (فارغ = الجميع) | Select | No | An employee policy beats the company-wide one | Empty | Aisha Khan | An employee of another company -> 'Choose a employee from this company.' |
| Allowed methods | طرق التسجيل المسموحة | Multi-select of 9 methods | Yes | At least one | Web, Mobile, GPS | None chosen -> 'Choose at least one allowed methods.' | |
| Require location / Enforce geofence / Allow offline punches | اشتراط الموقع / تطبيق السياج / السماح دون اتصال | Tick boxes | No | Enforce geofence needs a location; offline default for no policy is allowed | Off | Require + Enforce on | None |
Self-service setup > Shifts
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code, Name, Starts, Ends, Break, Grace in/out, Overtime after (h) | الرمز، الاسم، البداية، النهاية، الاستراحة، السماح، الإضافي بعد | Text, times, numbers | Yes (code, name, starts, ends) | Times HH:MM; crosses midnight tick for night shifts | DAY, 09:00-18:00, break 60, grace 10 | Empty start -> 'Starts is required.'; '9am' -> 'Starts is not valid.' |
Self-service setup > Shift assignments
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Employee, Shift, Ramadan shift, From, To, Work location, Rotation | الموظف، الوردية، وردية رمضان، من، إلى، موقع العمل، التناوب | Selects + dates | Yes (employee, shift, from) | Latest assignment valid on the day wins; the Ramadan shift is used while the country rule's Ramadan period covers the day | Aisha Khan, DAY, Ramadan 09:00-15:00, from 1 Jan 2026 | No shift -> 'Shift is required.' |
Self-service setup > Request workflows
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Request type / Approval steps / Active | نوع الطلب / خطوات الموافقة / نشط | Select + multi-select (Manager review, HR review, Finance review) | Yes | Steps run in the order listed; linked types (leave, expense, profile, renewal) cannot be given steps | Loan: Manager, HR, Finance | No step -> 'Choose at least one approval steps, in order.' |
Self-service setup > Country rules
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Country, Rule, Version, Effective from/to, Values (JSON), Source | الدولة، القاعدة، الإصدار، ساري من/إلى، القيم، المصدر | Selects, integer, dates, JSON object | Yes (country, rule, version, effective from, values) | The rule valid on a calculation's own date is used; the GCC starter pack is created on first use | ARE working_hours v2 from 1 Jan 2027 | Bad JSON -> 'That is not valid JSON.'; a list instead of an object -> 'Give an object of values.' |
Self-service setup > Announcements
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Title, Category, Published, Expires, Pinned, Active, Text | العنوان، الفئة، النشر، الانتهاء، مثبت، نشط، النص | Text, select, dates, ticks | Yes (title, category, published) | Shown from the published date until the expiry date, pinned first | Eid holiday notice | No title -> 'Title is required.' |
Self-service setup > Asset assignments / Enrolments / Benefits / Dependents / Salary accounts
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Employee and master-specific fields | الموظف وحقول كل بيان | Selects, dates, text | Yes (employee and key fields) | References must belong to this company; saving an assignment flips the asset to Assigned / Available; a new enrolment notifies the employee | Laptop L-0012 to Aisha Khan from 1 Oct 2026 | A record from another company -> 'Choose a asset from this company.' |
Payroll runs
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Period | الفترة | Month (YYYY-MM) | Yes | Calendar month | Last month | 2026-09 | Bad period (API) -> 'Send the period as YYYY-MM.' |
ESS feature switches
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Time off / Time and attendance / Expenses switches | مفاتيح الإجازات / الحضور والوقت / المصروفات | Switch (on, off) | No | Off refuses changes through ess/leave, ess/attendance + ess/timesheets, ess/expenses and drops the menus; reads still work | On | Turn Expenses off | A change through a switched-off route -> 409 'capability_disabled' ('... is disabled for this company.') |
ESS field settings
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Personal email / Emergency contact / Expense merchant / Receipt reference | البريد الشخصي / جهة الطوارئ / جهة المصروف / مرجع الإيصال | Mode (Shown, Hidden, Required) | No | Hidden fields vanish from the ESS form and a value sent through the API is refused; the receipt reference is never demanded in the portal because it has no box | Shown | Hide Personal email | Hidden but sent -> '... is turned off for this company.' (400) |