ZenHR’s Native Integration with The General Organization for Social Insurance (GOSI)
The General Organization for Social Insurance (GOSI) was established to implement the provisions of the Social Insurance Law and follow up on the process of achieving compulsory insurance coverage, collecting contributions from employers, and paying benefits to eligible contributors or their family members. ZenHR’s native integration with GOSI is designed to help you perform several actions on GOSI's system directly from within ZenHR.
ZenHR’s native integration with GOSI allows you to:
Add Saudi and non-Saudi contributors.
Update and terminate contributors.
Update salaries.
Generate a list of all contributors.
How to
-
Activate
Activating the GOSI Integration on ZenHR:
Click your user icon in the upper right corner and go to System Preferences →Marketplace Integrations → GOSI Integration Setup.
On the Marketplace Integrations page, go to GOSI Integration and click Setup. The Superadmin or the Financial Officer can activate this integration.
On this page, click “Activate”.
A slider will then appear for you to fill in your GOSI registration number for the establishment, Establishment National Unified Number, signatory gov ID, signatory name, and signatory email.
After filling out the previous information, you will be directed to the “Masdr URL”.
That’s it; your GOSI integration will now be complete!
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 them 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.
-
Use the Integration
Using the GOSI Integration:
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 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.
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 and 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”. 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. 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.
-
Deactivate
Deactivating the GOSI Integration:
User Menu → System Preferences → Integration Setup → GOSI Integration Setup.
To deactivate the GOSI integration, on the GOSI Integration Setup page, click the “Deactivate” button.
Activating the GOSI Integration on ZenHR:
Click your user icon in the upper right corner and go to System Preferences →Marketplace Integrations → GOSI Integration Setup.
On the Marketplace Integrations page, go to GOSI Integration and click Setup. The Superadmin or the Financial Officer can activate this integration.
On this page, click “Activate”.
A slider will then appear for you to fill in your GOSI registration number for the establishment, Establishment National Unified Number, signatory gov ID, signatory name, and signatory email.
After filling out the previous information, you will be directed to the “Masdr URL”.
That’s it; your GOSI integration will now be complete!
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 them 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.
Using the GOSI Integration:
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 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.
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 and 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”. 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. 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 the GOSI Integration:
User Menu → System Preferences → Integration Setup → GOSI Integration Setup.
To deactivate the GOSI integration, on the GOSI Integration Setup page, click the “Deactivate” button.
