🇸🇦 Saudi Arabia — SAP ECP 6-Chapter Configuration Framework

Molga: 99 | Currency: SAR | Module: PYSA | Country Grouping: SA

CHAPTER 1 — Foundation & System Landscape

1.1 System Landscape

1. Provision ECP with KSA country add-on (Molga 99, country key SA)

2. Activate GOSI (General Organization for Social Insurance) integration

3. Configure Arabic RTL support in SICF + UI5 apps

4. Enable WPS (Wage Protection System) — mandatory for KSA

5. Import Saudi Best Practice config via STMS

6. Set calendar type: Hijri (Islamic) + Gregorian dual calendar support

1.2 Authentication & Security

1. Configure SAML 2.0 with NCA (National Cybersecurity Authority) compliant IAS

2. Enable IQAMA (Residence Permit) number field in user provisioning

3. Set up NAFIS integration endpoint (Saudi nationalization portal)

4. Configure Absher authentication for Saudi nationals (optional)

5. Assign PCC and WPS submission roles

6. Enable data localization: KSA sovereign region

1.3 OData & PCC

1. Activate all standard PCC OData services

2. Configure GOSI online portal API credentials in HTTP destinations

3. Register KSA SAP System in Admin Center

4. Enable Mudad (WPS) file generation endpoint

5. Set PCC KPIs: Saudization (Nitaqat) ratio, GOSI compliance rate

6. Activate Pay Statement ESS in Arabic and English

1.4 User Provisioning

1. Provision users with IQAMA / National ID fields

2. Configure SCIM for GOSI employee registration sync

3. Assign Payroll Area KSA_M to all KSA employees

4. Set up Saudization quota tracking roles

5. Configure GOSI report submission user (technical user)

6. Define authorization per region: Riyadh, Jeddah, Dammam offices

1.5 Transport & Config

1. Set up DEV → QA → PROD transport for KSA

2. Import GOSI rate tables (current: 9% EE + 9% ER for Saudis)

3. Import WPS SIF schema for Saudi Central Bank (SAMA)

4. Configure Zakat year-end processing tables

5. Generate Providers for KSA validation rules in PCC

6. Enable bgRFC for KSA payroll process triggers

1.6 De-clustering

1. Register KSA cluster tables for HANA de-clustering

2. Activate P2RX_RT for PCC analytics performance

3. Configure logical transport objects for KSA

4. Import NITAQAT (Saudization) configuration data

5. Set up GOSI online submission batch job schedule

6. Verify PCC Configuration Workbench for KSA imports

CHAPTER 2 — Enterprise Structure

2.1 Company & Personnel Areas

1. Create Company Code SA01 (SAR, SA, fiscal year = Hijri or Gregorian)

2. Define Personnel Areas: SA01=Riyadh, SA02=Jeddah, SA03=Dammam, SA04=Makkah, SA05=Madinah, SA06=Khobar, SA07=Tabuk

3. Define PSA per city: Industrial City, Economic City, Downtown

4. Assign all PA to SA01; Molga = 99

5. Configure Hajj season leave provisions (PA/PSA-specific)

6. Set fiscal year: Hijri (1445H–1446H) or Gregorian per company

2.2 Employee Groups

1. EG: Saudi National, GCC National, Non-GCC Expat, Domestic Worker

2. ESG: Staff, Senior, Manager, Director, Executive

3. Configure Nitaqat category: Platinum/Green/Yellow/Red band tracking

4. Define Payroll Areas: KSA_M Monthly, KSA_W Weekly (construction)

5. Configure GOSI grouping: Saudi National (GOSI) vs Expat (no GOSI)

6. Set WPS eligibility: all employees receiving salary via KSA bank

2.3 Personnel Actions

1. Define UAE-style actions adapted for KSA: Hire includes IQAMA capture

2. Configure IQAMA expiry alert (IT0016 contract elements)

3. Set up Exit/Re-entry Visa tracking for expat employees

4. Configure Umrah/Hajj Leave action type

5. Define GOSI registration trigger on hire action

6. Set number range: SA employees 20000000–29999999

2.4 Wage Types

1. /SA01 Basic Salary, /SA02 Housing Allowance (25% of basic minimum), /SA03 Transport

2. /SA10 GOSI Employee (9%), /SA11 GOSI Employer (9% + 2% OHSE)

3. /SA20 Overtime (1.5x after 8hrs per day), /SA21 Rest Day OT (2x)

4. /SA30 End of Service (EOSI: 0.5 month/yr first 5yrs, 1 month/yr thereafter)

5. /SA40 Annual Bonus, /SA41 Ramadan Allowance

6. Configure GOSI wage base: Basic + Housing (capped SAR 45,000/month)

2.5 Pay Scale

1. Pay Scale Type: KSA_PVT (private sector), KSA_GOV (government-linked)

2. Minimum wage: SAR 4,000/month for Saudi nationals

3. Configure IT0008 Basic Pay with Housing Allowance split

4. Set probation period: 90 days (extendable to 180)

5. Configure performance bonus IT0015 in SAR

6. Set working hours: 8hrs/day, 48hrs/week (40hrs Ramadan)

2.6 Benefits

1. GOSI mandatory: medical insurance, workmen’s compensation

2. Define Private Health Insurance plan (Cooperative Health Insurance mandatory)

3. Configure CCHI (Council of Cooperative Health Insurance) compliance

4. Define Life Insurance and AD&D per employer policy

5. Configure End of Service (Gratuity) provision posting

6. Map all benefit deductions to payroll IT0014 wage types

CHAPTER 3 — Integration

3.1 PTP Setup

1. Configure RFC for KSA ECP with IQAMA field mapping

2. Enable Compound Employee API with Saudi-specific fields

3. Configure GOSI online API HTTP destination

4. Test WPS (Mudad) file generation endpoint

5. Set Full Transmission Date for KSA go-live

6. Enable NAFIS (nationalization portal) webhook integration

3.2 Master Data Mapping

1. Map EC Employment Status → KSA EG/ESG (Saudi/Expat distinction)

2. Map EC Job → GOSI occupation code (mandatory for GOSI registration)

3. Configure event: Hire (70) → auto-trigger GOSI registration

4. Map EC Location → Personnel Area (city)

5. Configure IQAMA custom field replication to IT0016

6. Map Nitaqat job category to EC job classification

3.3 Wage Type Replication

1. Map Basic Salary → /SA01 IT0008

2. Map Housing Allowance → /SA02 IT0014 (25% minimum mandatory)

3. Map Transport → /SA03 IT0014

4. Map Annual Bonus → /SA40 IT0015

5. Derive GOSI /SA10 + /SA11 via schema PCR (not EC replication)

6. Run diagnostic for all KSA pay component mappings

3.4 Org Mapping

1. Key map: EC Legal Entity KSA Corp → SA01

2. Map Riyadh, Jeddah, Dammam locations → PA SA01–SA03

3. Configure Hijri/Gregorian work schedule mapping

4. Map Friday/Saturday weekend (KSA standard)

5. Replicate Jobs for GOSI occupation code assignment

6. Map cost centers: Riyadh vs Jeddah vs Eastern Province

3.5 Time Integration

1. Map Annual Leave: 21 days (<5 yrs), 30 days (≥5 yrs)

2. Map Hajj Leave → AE_HJ (once per service, 15 days)

3. Map Eid Al Fitr (3 days) + Eid Al Adha (4 days) as public holidays

4. Map Sick Leave: 30 days full pay, 60 days 75%, 30 days unpaid

5. Configure Ramadan: 6-hr working day, DWS_KSA_RAM

6. Maternity Leave: 10 weeks (70 days)

3.6 Advanced

1. Configure GOSI online submission: monthly /SA10 + /SA11 totals

2. Set up WPS Mudad file: SAMA-compliant SIF v2.0

3. Configure IQAMA expiry workflow (60-day alert via EC notification)

4. Enable Zakat provision calculation for year-end

5. Monitor SLG1 for KSA replication errors

6. Set up GOSI audit trail for inspection readiness

CHAPTER 4 — Payroll Engine

4.1 Schema & PCR

1. Copy schema X000 → XKSA with GOSI and EOSI sub-schemas

2. PCR for GOSI: calculate 9% on capped wage base (SAR 45,000)

3. PCR for EOSI: 0.5/1.0 month salary per year of service bracket

4. Add Ramadan schema branch: reduce working hours, adjust OT threshold

5. Configure retro for GOSI rate changes (annual government adjustment)

6. Set period parameters: Hijri or Gregorian month definition

4.2 Payroll Control

1. Payroll Area KSA_M: 1st–30th/31st Gregorian, pay date by 10th (WPS)

2. Configure Hijri calendar dates for Eid holidays in period parameters

3. Off-cycle: Eid advance, EOSI final settlement, GOSI corrections

4. Set retro: trigger on IT0008 change, GOSI rate change

5. Enable GOSI return generation as post-payroll activity

6. Configure PA03 lifecycle for KSA monthly payroll

4.3 Work Schedules

1. DWS_KSA_FD: 8hrs (08:00–17:00), Fri+Sat off

2. DWS_KSA_RAM: 6hrs (09:00–15:00) during Ramadan month

3. PWS_KSA_5D: Sun–Thu 5-day work week

4. Generate schedules including Ramadan period DWS override

5. Configure prayer time breaks (cultural accommodation)

6. Handle 48hr/week cap for overtime threshold

4.4 Holiday Calendar

1. KSA_NAT Calendar: Foundation Day (22 Feb), National Day (23 Sep)

2. Eid Al Fitr: 3–4 days floating (Hijri Shawwal 1–3)

3. Eid Al Adha: 4 days floating (Hijri Dhul Hijjah 9–12)

4. Prophet’s Birthday (Hijri Rabi’ Al-Awwal 12)

5. Update Hijri dates annually using official KSA government announcements

6. Configure Gregorian/Hijri calendar dual-date display on payslip

4.5 Absence Management

1. AL_KSA_S: Annual Leave Short Service (<5 yrs) = 21 days

2. AL_KSA_L: Annual Leave Long Service (≥5 yrs) = 30 days

3. SL_KSA: Sick Leave 30 full + 60 at 75% + 30 unpaid

4. ML_KSA: Maternity Leave 70 days full pay

5. HJ_KSA: Hajj Leave 15 days once per career

6. Configure leave encashment on termination at daily rate

4.6 Finance Integration

1. Chart of Accounts KSA: Salary Expense, GOSI Liability, EOSI Provision

2. Map symbolic accounts → KSA GL codes

3. Configure WPS Mudad file export with SAMA bank routing

4. Set up Al Rajhi Bank, NCB, SABB SWIFT codes for DME

5. GOSI monthly return: auto-generate /SA11 employer contribution report

6. Zakat provision: calculate and post to liability account (2.5% of Nisab)

CHAPTER 5 — Payroll Control Center

5.1 PCC Config

1. GOSI validation: /SA10 deduction ≥ 9% of capped basic+housing

2. WPS validation: IBAN format SA + 22 digits, salary by Day 10

3. KPI: Saudization (Nitaqat) % by department

4. KPI: GOSI contribution total vs prior month variance >5%

5. Configure Eid advance process type in PCC

6. Set up EOSI calculation review checklist before termination

5.2 Operations

1. Pre-payroll: GOSI data lock, WPS IBAN validation

2. Payroll calculation: run RPCALCX0 for KSA_M

3. Post-payroll: GOSI return, WPS Mudad file, management reports

4. Configure Nitaqat report as monthly PCC activity

5. Automate IQAMA expiry alerts as PCC validation rule

6. Set sign-off: HR Manager + Finance Director + Compliance Officer

5.3 Pay Statement

1. Arabic + English bilingual payslip

2. Show GOSI deduction, EOSI accrual, net pay in SAR

3. Display IQAMA number and GOSI ID on payslip header

4. Configure Hijri date on payslip alongside Gregorian

5. Enable ESS pay statement via SFEC portal

6. Configure Ramadan period payslip variant

5.4 Payroll Unified Config

1. Register KSA in Admin Center Payroll Unified Configuration

2. Link KSA ECP backend

3. Enable WPS Status portlet for payroll admins

4. Configure GOSI submission tracking portlet

5. Set Payroll Tasks: Hire (GOSI register), Termination (EOSI calc)

6. Assign RBP per KSA region (Riyadh/Jeddah/Dammam)

5.5 Country-Specific

1. Activate Saudi Labour Law compliance (Article 80, 84, 87 EOSI)

2. Configure GOSI online portal automated submission

3. Set up Nitaqat quarterly headcount report

4. Configure Zakat deduction for eligible employees (rare)

5. Enable CCHI health insurance compliance report

6. WPS Mudad: configure bank-wise split for multi-bank payroll

5.6 Payroll Run

1. Simulation run: verify GOSI, EOSI, OT for 5 test employees

2. Live run: monitor PCC error rate target <0.3%

3. Generate GOSI monthly return file

4. Generate WPS Mudad file; submit to SAMA portal

5. Lock payroll; post FI entries; archive cluster data

6. Send payslips via ESS and email in Arabic + English

CHAPTER 6 — Testing & Go-Live

6.1 Unit Tests

1. GOSI: Saudi vs non-Saudi, capped vs uncapped wage base

2. EOSI: years-of-service brackets, resignation vs termination rules

3. WPS file: SAMA schema validation, IBAN format, bank codes

4. Overtime: 1.5x and 2x scenarios, Ramadan reduced-hour OT

5. Annual Leave: 21-day vs 30-day entitlement switch at 5 years

6. Hijri calendar: holiday detection in payroll period boundaries

6.2 Integration Tests

1. EC Hire (Saudi National) → ECP → GOSI registration → first payroll

2. IQAMA expiry → EC alert → HR action → visa change replication

3. Termination → EOSI calculation → FI posting → WPS final payment

4. Parallel run: 2 months vs legacy payroll system; SAR-level reconciliation

5. WPS file: submit test file to Al Rajhi/NCB sandbox; verify acceptance

6. GOSI online: test submission with sandbox GOSI portal credentials

6.3 UAT

1. HR Admin: hire Saudi and expat, verify GOSI distinction

2. Payroll Admin: full KSA cycle — run, WPS submit, GOSI return

3. Finance: GL posting verification, EOSI liability account

4. Employee: Arabic payslip ESS access, GOSI deduction visible

5. Compliance: Nitaqat report and CCHI insurance report validation

6. Sign-off: CHRO + CFO + Legal + IT Security

6.4 Security & Compliance

1. NCA cybersecurity compliance: data encryption at rest and in transit

2. PDPL (Saudi Personal Data Protection Law): mask IQAMA in non-prod

3. WPS audit trail: every Mudad submission timestamped and stored 5 years

4. GOSI audit readiness: contribution history extractable on demand

5. Role test: payroll admin cannot view Nitaqat strategy data

6. Penetration test: GOSI API endpoint, WPS Mudad portal

6.5 Go-Live

1. Migrate GOSI historical contributions from legacy system

2. Go-live checklist: GOSI employer code, SAMA WPS credentials, IBAN master data

3. Initial load: all KSA employees; reconcile vs GOSI portal headcount

4. PA03: set to Released for KSA_M first ECP payroll

5. Hypercare: dedicated KSA payroll team 4 weeks; WPS SLA = Day 10

6. Handover: GOSI submission runbook, Nitaqat tracker, EOSI calculator

6.6 AMS & Roadmap

1. Monthly: WPS 100% submission success; GOSI zero-error returns

2. Annual: Hijri holiday calendar update (KSA official gazette)

3. Annual: GOSI rate review, minimum wage update, CCHI premium renewal

4. Quarterly: Nitaqat ratio review; Saudi Vision 2030 HR compliance updates

5. Roadmap: NAFIS real-time Saudization tracking via API

6. Roadmap: AI anomaly detection in PCC for GOSI base discrepancies