What is Muqeem?
Muqeem is a service provided by the General Directorate of Passports in Saudi Arabia, which allows companies to manage their employees' Iqamas and Exit-Reentry Visas online, instead of visiting the office in person.
Services available on the Muqeem web portal for companies include issuing their employees new Iqama, renewing Iqama, issuing Final Exit visa, issuing and managing Exit-Reentry visas.
How to Set up the Integration
In order to use the integration, you must be subscribed to Muqeem comprehensive (Shamel) package.
You must also subscribe to using the Bayzat integration on the Muqeem web portal. To do this follow the below steps:
Login to your web Muqeem account from your browser
Go to the section Organization Information
Choose the Points and Packages Tab
Click new subscription in the Company Packages section
Choose Indirect API Package
Select Bayzat as the name of the integrator and click subscribe
Wait for approval for the subscription
Receive the invoice on Muqeem portal
Make the payment to Muqeem using Sadad for the subscription fee
The Bayzat subscription on Muqeem will be active and you can proceed with integration on Bayzat platform
11. Ensure that the user being used to connect Muqeem integration has permission to access API services. This can be checked by clicking on the username in the top right of the Muqeem portal and looking for necessary API permissions. The main user for Muqeem will always have API permissions by default.
If the username being used to connect the Muqeem integration does not have API permissions:
The company's main Muqeem user needs to log into Muqeem and go to Organization Information -> User Management.
From here the Main User needs to click on edit beside the Username being selected for integration and give permission to access the relevant Muqeem API services, as shown in the below screenshot
After completing these steps. to set up the integration on Bayzat, any user with the role of People Manager or Super Admin can visit the Configurations page on the Bayzat web platform and then go to the Integrations Tab. From there, you can click the Connect now button on the Muqeem integration card to proceed with the integration.
Following that simply input any username and password currently active for your company on the Muqeem portal into the dialog box on Bayzat, and this will be used to connect your Bayzat account to your Muqeem account.
If you don't already have a Muqeem account you can create one by visiting https://muqeem.sa/#/reg/request and filling out the form there.
What can you do through the integration?
By integrating Muqeem and Bayzat, you can initiate the following critical Muqeem transactions directly on Bayzat's web and mobile portals:
What is the cost of using the integration?
There is no charge from Bayzat's side to use the integration. However, Muqeem charges a fee of 12-20% of the pro-rata Muqeem subscription cost to enable the use of API. The exact cost for your company can be calculated on the Muqeem web portal.
Additionally, for using specific services such as renew Iqama, there is a cost to be paid to the government of Saudi Arabia, which will be the same as it is directly through the Muqeem portal. This payment can be made through the Sadad portal, simliar to the process followed on the Muqeem web portal.
How can you manage the integration after it is set up?
Once Muqeem has been connected to Bayzat, you manage the integration by visiting the Integration tab within the Configuration section and clicking the View Integration details button on the Muqeem card.
Following that you will be able to disconnect Bayzat from Muqeem by pressing the Deactivate integration button.
You can also change the username and password used for connecting Bayzat to Muqeem by clicking the Update Muqeem credentials button.
You can also view logs to see all actions that have been performed via the Bayzat-Muqeem integration by clicking logs tab. The logs will show what time actions were performed, what type of action was performed and who performed the action.