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 contributors
Update a contributor
Approve pending non-saudi contributors
Terminate a contributor
Update salaries
Receive a list of pending non-saudi contributors

TABLE OF CONTENTS

New Roles Added to Manage GOSI
How to Activate This Integration
GOSI Management Page
View & Track Records Sent to GOSI:
GOSI Event Viewer
Deactivating GOSI Integration
GOSI Info Section in the Employee Profile

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 → Marketplace Integrations → Integration Setup → GOSI Integration Setup

On the GOSI Integration Setup page, GOSI integration must be activated on ZenHR in order 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 of 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 branch 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:

Import GOSI Contributors
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 who 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.

Import GOSI Contributors

Click “Import GOSI Contributors”, and then a pop-up will appear with a link that guides you on how to download GOSI contributors. After downloading the files from the GOSI website, upload the Excel file here, in the pop-up.

Before uploading the sheet, make sure that the registration number in the sheet is the same as the GOSI branch you’re importing the contributors to.

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 Pending Non-Saudi Contributors
Approve Contributor
Link Employee
Terminate Contributor
Update Contributor
Sync Salary

Sync Pending Non-Saudi Contributors

Once you click the “Sync Pending Non-Saudi Contributors” button, 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.

Import GOSI Contributors

Before uploading the sheet, make sure that the registration number in the sheet is the same as the GOSI branch you’re importing the contributors to.

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

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.