The General Organization for Social Insurance (GOSI) Integration
ZenHR’s integration with The General Organization for Social Insurance (GOSI) is designed to help you perform several actions on GOSI's system directly from within ZenHR.
Companies can review their employees' data and complete their GOSI transactions online, anytime and anywhere on multiple GOSI branches.
By activating ZenHR’s native integration with GOSI, you will be able to perform the below actions directly from within ZenHR:
Add Saudi and non-Saudi contributors
Update a contributor
Terminate a contributor
Update salaries
Get a list of all contributors
TABLE OF CONTENTS
New Roles Added to Manage GOSI
The new roles, GOSI Admin and Read-only GOSI, have been added to KSA branches only.
GOSI Admin:
This new role gives users full access to Muqeem-related pages, such as the GOSI Management page and its tabs.
Read-only GOSI:
This new role gives users access to view GOSI-related pages, such as the GOSI Management page and its tabs only. These users will not be able to perform any actions, and the actions column will be hidden from all pages.
These roles can be assigned to users on the User Info page.
How to Activate This Integration
User Menu → System Preferences → Integration Setup → GOSI Integration Setup
On the GOSI Integration Setup page, GOSI integration must be activated on ZenHR in order to be able to perform any actions. The Superadmin or the Financial Officer can activate this integration.
On this page, click “Activate” to enable the integration so you can add multiple GOSI branches. To add a GOSI branch click “Add GOSI Branch” and a slider will then appear for you to fill in your desired GOSI branch name (noting that will be used in later stages within the integration). After filling out the previous information, you will be directed to “Masdr URL”.
After completing the integration steps on Masdr, the GOSI branch will be added to the GOSI branches tables with all of its respective details. The user can Activate or Deactivate each GOSI branch on its own through this table.
In the GOSI branches table, the user will be able to view the integration details by clicking “Details” in the actions column. All records with integration statuses except for "Active" are open for editing.
GOSI Management Page
Main Menu → Employees → Employee Affairs → GOSI Management
On the GOSI Management page, there are three tabs, Saudis, Non-Saudis, and Actions Log, where GOSI actions can be made.
“Saudis” Tab
This is the default tab the user will see once they go to this page. You can then perform the following actions:
Sync Data
Add Contributor
Terminate Contributor
Update Contributor
Sync Salary
Link Employee
This tab shows all the employees on the GOSI branch with their info, including their GOSI Status, Added if the employee is registered on GOSI, Not Added and Terminated if the employee is terminated from GOSI. Employees that are not added to any GOSI branch will appear under all branches until they are assigned to one.
Regarding the GOSI salary on ZenHR and the Salary on GOSI, the GOSI salary on ZenHR will be the same employee salary added to ZenHR. The Salary on GOSI is the employee salary as it appears in The General Organization for Social Insurance (GOSI) system. Next to “Salary on GOSI”, an icon will appear to indicate if the salary on GOSI is synced with the salary on ZenHR.
Sync Data
Once the “Sync Data” button is clicked, the Saudi contributors added to the organization’s registration number will be shown. Next to the Sync button, the last sync and who performed it will be shown as well as the date and time stamp. The contributors will be automatically linked to employees on ZenHR, by checking the National ID then the Iqama Number.
Adding a Contributor
To add a Saudi contributor to GOSI, go to the “Saudis” tab and click “Add Contributor”, noting that this button will only appear if the GOSI status is “Not Added”. The GOSI branch will be filled by default but the user is free to change it to any other active GOSI branch. Enter the required information on the GOSI Info page. Some of the fields on this page will already be extracted from the employee’s existing data on ZenHR, and any changes on this page will not be reflected on ZenHR. Once “Save” is clicked, the employee will be added to GOSI .
Terminate a Contributor
On the Saudis tab; the user can terminate an employee on GOSI by clicking the “Terminate Contributor” button and filling in the termination date and reason.
Update a Contributor
On the Saudis tab, the user can update an employee on GOSI by clicking the “Update Contributor” button and filling in the fields.
Sync Salary
“Sync salary” will sync the GOSI Salary on ZenHR to the Salary On GOSI. This means that the salary on ZenHR will be reflected on GOSI’s system to match the same value.
The GOSI salary on ZenHR is the GOSI salary in the salary package, which includes housing and other allowances.
Housing is any fixed active recurring transaction added to the employee’s salary package.
Other allowances are any non-fixed active recurring transactions added to the employee’s salary package.
Also, the user can sync salaries for more than one contributor by checking the box in the first column.
Link Employee
If the ZenHR Status is “Not onboarded,” the button “Link Employee” will guide the user to a pop-up showing a dropdown list of all the employees that aren’t linked on GOSI and their employment # in the branch.
A linked employee can be unlinked by clicking the button “Unlink Employee”.
Note: If a “Saudi employee” is added to GOSI and the info is changed in their profile, the records in this tab will not be updated unless “Update Contributor” is clicked.
Non-Saudis Tab
This tab will show the Non-Saudi contributors added to the registered organization on GOSI as well as the pending contributors. In this table, the non-Saudi contributors' info will be shown along with their status on ZenHR as follows: Onboarded (Contributor exists on ZenHR), Not onboarded (Contributor does not exist on ZenHR, Terminated (Contributor is terminated on ZenHR).
The actions that can be done on this page are as follows:
Sync Data
Approve Contributor
Link Employee
Terminate Contributor
Update Contributor
Sync Salary
Sync Data
Once the “Sync Data” button is clicked, the Non-Saudi contributors added to the organization’s registration number will be shown as well as the pending contributors. Next to the Sync button, the last sync and who performed it will be shown as well as the date and time stamp.
Approve Contributor
To approve a non-Saudi contributor on GOSI, go to the “Non-Saudis” tab and click “Add Contributor”, noting that this button will only appear if the GOSI status is “Not Added”. Enter the required information on the GOSI Info page. The GOSI branch will be filled by default but the user is free to change it to any other active GOSI branch. Some of the fields on this page will already be extracted from the employee’s existing data on ZenHR, and any changes on this page will not be reflected on ZenHR. Once “Save” is clicked, the employee will be added to GOSI.
Link Employee
If the ZenHR Status is “Not onboarded,” the button “Link Employee” will guide the user to a pop-up showing a dropdown list of all the employees that aren’t linked on GOSI and their employment # in the branch.
A linked employee can be unlinked by clicking the “Unlink Employee” button.
Terminate Contributor: This button allows you to terminate a contributor in the “non-Saudis” tab.
Update Contributor: This button allows you to update a contributor in the “non-Saudis” tab.
Sync Salary: This button allows you to sync the salary for a “non-Saudis” tab.
Also, the user can sync salaries for more than one contributor by checking the box in the first column.
Actions log Tab
This page will show the actions that were taken on GOSI, the Action Type, the GOSI Status for the employee, and the GOSI response for each action.
View & Track Records Sent to GOSI:
GOSI Event Viewer
User Menu → System Preferences → Integration Setup → GOSI Integration Setup
On the Event Viewer page, users will be able to track the records that have been sent to GOSI.
Deactivating GOSI Integration
User Menu → System Preferences → Integration Setup → GOSI Integration Setup
To deactivate the GOSI integration, on the GOSI Integration Setup page, click “Deactivate” to stop the integration for all GOSI branches at once.
GOSI Info Section in the Employee Profile
If the integration is activated; in the employee profile, a GOSI section will be added under the recurring section in the employee's salary package.
In this section, the user can sync the employee salary and send it to GOSI.
If the GOSI Salary and the Salary on GOSI are different and the package is active, then the “Sync Salary” button will appear next to the Add GOSI Info button.
