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 (UAE)

The Wage Protection System (WPS) is mandated by the UAE Ministry of Human Resources and Emiratisation (MoHRE). Employers must submit a Salary Information File (SIF) to their bank or exchange house each month before paying salaries.

SIF File Format

The generated SIF file is pipe-delimited (|) with two record types:

Setup

1. Go to Settings → Gulf Compliance → WPS
2. Click Configure
3. Enter your Employer Code (assigned by MoHRE or your WPS agent bank)
4. Enter your Bank Code (your bank's WPS routing code)
5. Toggle Enable WPS
6. Save

Generating the Monthly SIF File

1. First, generate and finalize the monthly payroll for UAE employees (Payroll Guide)
2. Go to Settings → Gulf Compliance → WPS → WPS Files
3. Click Generate SIF
4. Select the month and year — click Generate
5. Download the .txt file and upload to your bank's 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