What is a WPS TXT file?
Published
A WPS TXT file is a structured text file used to submit payroll data to an approved wage protection platform or authority process. The file extension alone is not enough. The column order, encoding, values, and format must match the receiver's requirements.
The examples on this page use a fictional business (Al Waha Office Supplies). Figures are illustrative only and are not real business data or sector benchmarks.
Short answer
A WPS TXT file is a sensitive operational file, not just a text file. Any small mismatch between it and the payroll sheet can cause rejection, salary delay, or compliance issues, so it must be checked before upload.
Common content
| Data type | Examples |
|---|---|
| Employer data | Establishment number, payroll period |
| Employee data | ID or Iqama, name, IBAN |
| Salary data | Basic salary, allowances, deductions, net salary |
| Payment data | Bank, date, transfer status |
Control example
The payroll sheet shows SAR 9,300 net salary for an employee. If the TXT file shows SAR 9,000, there is a SAR 300 difference. The file should not be uploaded until the difference is explained as an advance, deduction, export error, or unapproved adjustment.
Common mistakes
| Mistake | Effect |
|---|---|
| Editing the file manually after export | The file may no longer match the payroll sheet |
| Using an unaccepted encoding | The file is rejected or Arabic characters render incorrectly |
| IBAN differing from the employee record | Failed transfer or an internal violation |
Pre-upload checks
| Check | Why |
|---|---|
| Employee count equals payroll sheet | Prevents missing or extra employees |
| Net salary total equals transfer total | Prevents bank differences |
| IBANs are valid | Reduces failed transfers |
| Encoding is preserved | Prevents Arabic text corruption |
Example 2: file total mismatch
If total net salaries in the payroll sheet are SAR 186,400 and the TXT file total is SAR 185,900, the difference is SAR 500. Do not upload before identifying the affected employee and reason.
Possible rejection reasons
| Reason | Example |
|---|---|
| Invalid format | Wrong number of columns |
| Invalid IBAN | Missing digits or bank mismatch |
| Negative or illogical amount | Deductions exceed salary |
| Wrong encoding | Arabic names appear as broken characters |
Best practice
Export the file from the system after payroll approval, and avoid manual edits unless necessary and permissioned. Any manual change should leave an audit trail.
Frequently asked questions
Can a TXT file be opened in Excel?
Yes, but opening and saving it may change separators or encoding. Handle it carefully.
Does the WPS file replace the payroll sheet?
No. The file is a submission format. The payroll sheet is the accounting and review record.
Is the file format fixed?
Do not assume so. Use the latest template or specification from the approved platform.