Integrations

The Integrations module is where Nama keeps its ready-made links to outside platforms that a customer is required to report to. Today it holds two, both Saudi, and they have nothing in common beyond sharing a menu:

• Eltezam is for government agencies. The Ministry of Civil Service (MCS) expects every agency to report its employees — who they are, their jobs, their monthly payslips, qualifications, vacations and appraisals — to its Eltezam service, in the ministry's own codes. Nama reads all of that from the HR module, translates it through code tables, and sends it one request at a time over the Government Service Bus.
• Alwatania Distributors is for companies that distribute for Alwatania. Nama pushes the distributor's master data — customers, salesmen, items and the places they belong to — and every sales invoice and return to Alwatania's platform. It is one-way: Nama sends, and reads back only the platform's answer to each request.

Each one has its own licence, its own screens and its own way of being sent, so read only the part you need. Neither has a Send button: in both, data leaves Nama when an entity flow or a task schedule runs one of the integration's actions.

The menu has the same shape for both: the configuration screens under Master Files, and — for Eltezam only — the submission document under Documents. The root of the menu reads integrations in both languages.

Looking for another integration?

The platform-wide integrations — the Nama ERP API, attendance machines, the invoice retriever, SFDA drug track and trace and others — are in External Integrations. E-commerce platforms have their own e-commerce Integration module.

Eltezam — reporting employees to the Ministry of Civil Service

Licence integrations-ksa-estidamah-eltezam. Three screens: the configuration, the code tables and the submission document.

🏛️Eltezam OverviewWhat the ministry expects, the seven operations Nama sends, and the workflow from HR data to a sent submission.⚙️Setting up EltezamThe configuration: service address, agency IDs, the employee group, employee-field templates and which operations to send.🔣Eltezam Code TablesCreating all 29 tables at once and mapping Nama records and values to the ministry's codes.📋What Nama Sends to EltezamWhere every value of every operation comes from, and which documents count as in the period.📤Submissions and SendingThe submission document, the two sending actions, the request log and resending the employees that failed.🩺Eltezam TroubleshootingReading the error codes, the three-failures stop rule, and every message the integration raises.

Alwatania Distributors — pushing master data and sales to Alwatania

Licence integrations-ksa-watania-samil. One screen, the config, which also holds both send logs.

🚚Alwatania OverviewWhat is sent, how Nama records map onto the platform, and the three rules that shape every run.🔑Setting up the Alwatania ConfigThe token and API addresses, the client credentials and the batch sizes.📦Sending Master Data and InvoicesThe three actions, their parameters, and ready-to-copy task schedules and entity flows.🧾Send Logs and ResendingReading the two logs, why something was refused, forcing a resend, and the messages you may see.