Kuwait WPS Payroll File for Odoo
Generate the Kuwait Wage Protection System salary file with PIFSS social security, Civil ID and Kuwaiti IBAN validation — built on Odoo HR, no Enterprise payroll required.
WPS salary file PIFSS Civil ID Kuwaiti IBAN Odoo 18 & 19
What It Does
This module covers Kuwait payroll compliance on top of the standard hr app. It builds the Wage Protection System salary file — a header record, one employee record per worker and a control trailer — that you upload to your bank, which forwards the wage-payment data to the Public Authority for Manpower (PAM) Wage Protection Division. It computes PIFSS social-security contributions for Kuwaiti and GCC nationals, and validates Kuwaiti IBANs and Civil IDs with their official checksums. The salary file is produced inside Odoo and you upload it through your own bank channel (BYOK).
Key Features
WPS Salary File
Comma-delimited WPS file with a header record, one employee record per worker (Civil ID, IBAN, bank code, basic, allowances, deductions, net, days in pay period) and a control trailer, in Kuwaiti Dinar with fils precision. Days in pay period default to the real calendar length of the salary month. Record tags and column order are a configurable convention to match your bank's template.
PIFSS Social Security
Public Institution for Social Security contributions for Kuwaiti / GCC nationals (employee 8%, employer 11.5%) on the contributory wage bounded by the statutory floor and ceiling; expatriates excluded automatically.
Kuwaiti IBAN Validation
ISO 13616 / ISO 7064 mod-97 check on the 30-character Kuwaiti IBAN (KW + 2 check digits + 4-letter bank code + 22-character account), with automatic bank-code extraction.
Civil ID Validation
PACI 12-digit Civil ID with the weighted mod-11 check digit and date-of-birth decoding, used as the employee key in the salary file.
How It Works
- Fill the Civil ID, IBAN, bank code and salary structure on each employee's Kuwait WPS tab.
- Set the company's Employer Civil / File No. and Bank / Establishment Code.
- Create a monthly WPS batch — it populates lines from your employees and computes PIFSS totals.
- Generate the WPS salary file and download it, ready to upload through your bank.
Compatibility & Disclosure
Built on hr and account — runs on Odoo 18 and 19, Community and Enterprise, with no Enterprise hr_payroll dependency.
Layout note: Kuwait does not publish a single public field-level WPS/Shaml file specification; officially the WPS validates a single net salary figure per worker keyed on Civil ID, IBAN and pay period, and the exact record layout is defined by each accredited bank in its own portal template. The record tags and column order produced here are a clearly-disclosed, configurable convention, not an official government spec. The PIFSS calculator covers the headline core-scheme rates (employee 8%, employer 11.5%); the optional supplementary-insurance tier is not modelled.
Disclosure: This module generates the WPS salary file and computes PIFSS contributions from the data you maintain in Odoo. It does not submit data to any government or bank system on your behalf and does not constitute legal, tax or payroll advice; verify the output against your bank's current WPS/Shaml template before upload.
Screenshots
Generated Wps Sif Salary Bat
Update date: 2026-07-10