Gulf Compliance

1. Overview — How Gulf Compliance Works

Gulf compliance in MAttendance is per-employee, not per-organization. A single organization can have employees across India, UAE, Saudi Arabia, Qatar, and Kuwait — each employee's statutory deductions and documents follow their own Compliance Country setting.

Where to configure: Go to Settings → Gulf Compliance. You will find four tabs: EOSB/Gratuity, WPS, Social Insurance, and Ramadan Periods.

2. EOSB / Gratuity

End-of-Service Benefit (EOSB) — also called gratuity — is a statutory payment made to employees upon end of service. Rules vary by country and are calculated from Basic Salary and total service duration.

UAE — Federal Decree-Law No. 33 of 2021

Under UAE law (effective Feb 2022), all employees are entitled to EOSB regardless of resignation, subject to notice period compliance.

Saudi Arabia

Full rate: 15 days' wage per year for the first 5 years, then 1 month per year thereafter.

Qatar & Kuwait

Setup

1. Go to Settings → Gulf Compliance → EOSB / Gratuity
2. Click Configure next to the relevant country
3. Toggle Enable EOSB
4. Save

EOSB Liability Report

Click Liability Report to see the current EOSB exposure for all active Gulf employees — useful for provisioning and board-level reporting.

Calculate EOSB for a Leaving Employee

From the EOSB tab, use the Calculate EOSB button:

1. Select employee
2. Set exit date and exit reason (resignation / termination / retirement)
3. The engine returns: years served, daily basic rate, gratuity amount, country-specific breakdown

3. WPS — Wage Protection System

The Wage Protection System (WPS) requires employers to submit a monthly salary file to their bank or the government portal before paying salaries. MAttendance generates the correct file for each country — pick the country, and the right format is produced automatically.

File Formats by Country

Setup

1. Go to Settings → Gulf Compliance → WPS
2. Select the country from the dropdown
3. Click Configure — the form shows the fields that country needs:
   • UAE: MoHRE Employer Code, Bank Code
   • Saudi Arabia: MOL / Qiwa Establishment ID, GOSI Number, Bank Code, Routing Code
   • Qatar: Establishment ID, Employer EID, Bank Code, Routing Code
4. Toggle Enable WPS and Save

Generating the Monthly File

1. First, generate and finalize the monthly payroll for that country's employees (Payroll Guide)
2. Go to Settings → Gulf Compliance → WPS and choose the country
3. Click Generate File, select the month and year, then Generate
4. Review any warnings shown (e.g. employees missing an IBAN or national ID) and fix them
5. Download the file (.sif for UAE, .csv for Saudi / Qatar) and upload it to your bank or government WPS portal

WPS File Status Tracking

4. Social Insurance (GPSSA / GOSI)

Gulf countries require social insurance contributions for Gulf National citizens only. Expatriate employees are exempt.

Setup

1. Go to Settings → Gulf Compliance → Social Insurance
2. Select the country from the dropdown
3. Enter your Scheme Code (employer registration number with GPSSA / GOSI)
4. Set Employee Rate and Employer Rate (%)
5. Set Applies To — select Nationals
6. Toggle Enable
7. Save

Activation on Employees

Social insurance deductions only apply to employees who have both:

• Compliance Country = the matching Gulf country
• Gulf National = Yes (toggle in the employee's statutory section)

When payroll runs, the engine checks both conditions and adds an Employee GPSSA / GOSI deduction line item to the payslip.

5. Ramadan Periods

Gulf countries legally reduce working hours during Ramadan (typically by 2 hours per day). MAttendance lets you configure Ramadan periods so the attendance engine uses the correct expected hours for that period.

Setup

1. Go to Settings → Gulf Compliance → Ramadan Periods
2. Click Add Period
3. Enter the Year (e.g. 2025)
4. Set Start Date and End Date of Ramadan (check official Moon Committee announcements each year)
5. Set Reduced Hours Per Day — typically 2 hours less than normal (standard working day becomes 6 hours)
6. Save

6. Visa & Travel Document Tracking

MAttendance tracks visa and immigration documents per employee and proactively alerts HR before expiry. This prevents employees from working on expired visas, which carries significant legal risk for the employer.

Supported Document Types

Adding Documents (per employee)

1. Open Employees → [Employee Name]
2. Click the Visa Documents tab (visible only for employees with Compliance Country = Gulf)
3. Click Add Document
4. Select document type, enter document number, issuing country, issue date, and expiry date
5. Save

Expiry Alerts

The automated VisaExpiryAlertJob runs daily at 7:00 AM and sends push notifications + emails when documents are approaching expiry:

Each alert sends a push notification to the employee and an email to both the employee and the HR admin.

Expiry Colour Coding

The expiry date column on the Visa Documents table is colour-coded:

• 🟢 Green — expires > 30 days from today
• 🟡 Amber — expires within 30 days
• 🔴 Red — document has expired

7. Employee Setup

For Gulf compliance to activate, set these fields on each employee's profile:

Steps

1. Open Employees → [Employee Name] → Edit
2. Scroll to the Statutory / Compliance section
3. Set Compliance Country = UAE / Saudi / Qatar / Kuwait
4. Fill in Nationality, Passport Number, National ID / Iqama, IBAN, Bank Name
5. Toggle Gulf National to Yes if the employee holds that country's citizenship
6. Save
7. Navigate to the Visa Documents tab → add Passport and Work Visa / Residency Permit with expiry dates

8. Payslip Breakdown

Once Gulf compliance is active, the payslip shows relevant sections:

┌─────────────────────────────────────────────────────────────┐
│  EARNINGS                            │  DEDUCTIONS           │
│  Basic Salary        AED  8,000      │                       │
│  Housing Allowance   AED  2,500      │  Social Insurance:    │
│  Transport           AED    500      │  Employee GPSSA       │
│                                      │     AED  400  (5%)    │
│  Gross Salary        AED 11,000      │                       │
│                                      │  Total Deductions     │
│                                      │     AED   400         │
│                                      │                       │
│  Net Payable                          │     AED 10,600       │
└─────────────────────────────────────────────────────────────┘

EOSB Accrual (memo — not deducted from employee):
  Years Served: 3.5 | Daily Basic: AED 266.67
  EOSB Accrued to Date: AED 19,600

Employer Contributions (CTC):
  Employer GPSSA  AED 1,000 (12.5%)
  CTC = AED 11,000 + AED 1,000 = AED 12,000
          

Quick Setup Checklist