مركز المساعدة — شروحات وأدلة نظام بصمتك

مركز المساعدة — شروحات وأدلة نظام بصمتك

دليل استخدام نظام بصمتك: شروحات خطوة بخطوة للحضور والانصراف والرواتب والطلبات، أدلة الربط مع أنظمة ERP، والأسئلة الشائعة.

البداية السريعة

الموظفون

الفروع والأقسام والورديات

تطبيق الجوال

الحضور والانصراف

الطلبات والاعتمادات

الرواتب

التقارير

الأجهزة

المستخدمون والصلاحيات

الإعدادات والحساب

التكامل وواجهة البرمجة

  • ربط نظام آخر (مفتاح API)

    أصدر مفتاح API محدود الصلاحية ليتمكن نظام ERP (أودو، ساب، أوراكل، دايناميكس) أو تطبيقك من المزامنة مع بصمتك.

أدلة الربط مع أنظمة ERP

  • Odoo

    تُثبَّت إضافة بصمتك مباشرة في أودو وتُبقيه متزامناً: تزايدية بعد الاستيراد الأول، وقابلة للاستئناف للشركات الكبيرة (تكمل عبر تشغيلات المجدول بدلاً من انتهاء المهلة)، وآمنة من التكرار — كل سجل يُطابَق بمعرّف بصمتك وتفرضه قاعدة البيانات، والموظفون الموجودون مسبقاً في أودو يُربطون بدلاً من إنشائهم مرتين. الحذف والإلغاء في بصمتك ينعكسان، ويمكن دفع الموظفين المُنشأين في أودو إلى بصمتك.

  • SAP SuccessFactors

    طريقتان للتشغيل: iFlow في SAP Integration Suite (CPI) تستورده وتنشره، أو مزامنة مرجعية قابلة للتشغيل. كلاهما يبحث عن الشخص في SuccessFactors قبل الكتابة، ويعيّن بالترتيب الذي توثّقه SAP، ويحدّث ما تغيّر فقط، وينهي خدمة المغادرين، ويفحص حالة كل سجل في كل upsert (لأن SuccessFactors يُرجع HTTP 200 حتى عند فشل السجلات). وتعكس المزامنة المرجعية أيضاً الإجازات المعتمدة كـ EmployeeTime (والملغاة تُضبط CANCELLED) وتوفّر ‎--verify للتحقق دون تعديل.

  • Oracle Fusion HCM

    طريقتان للتشغيل: وصفة Oracle Integration Cloud (OIC)، أو مزامنة مرجعية تبني ملفات HCM Data Loader (HDL) وترفعها وتنتظر اكتمال التحميل وتفحص كل سطر خطأ. التعيينات الجديدة تحمل كل المكوّنات الإلزامية، والعاملون الموجودون في Fusion يُطابَقون بدلاً من تعيينهم مرتين، والمغادرون تُنهى خدمتهم، والإجازات المعتمدة تصبح قيود غياب تُسحب إذا أُلغيت الإجازة. تزايدية عبر مؤشر الخادم، والتحميل الفاشل لا يحرّك المؤشر أبداً. ويقرأ ‎--verify بيانات Fusion ويقارنها ببصمتك.

  • Microsoft Dynamics 365

    موصّل مخصص لـ Power Platform لواجهة شركاء بصمتك، قابل للاستخدام عبر بيئتك، مع تدفق سحابي جاهز للتكييف لمزامنة الموظفين (Recurrence ← ListEmployees ← Upsert row).

  • Dynamics 365 Business Central

    يُزامن موظفي بصمتك إلى Business Central عبر BC REST API v2.0 بمصادقة Microsoft Entra (OAuth 2.0 client credentials). مفتاح الموظف هو رقم BC = الرقم الوظيفي في بصمتك (أو BSM-<id> عند غيابه أو طوله الزائد)، ويُتبنّى الموظفون الموجودون في BC بدلاً من تكرارهم، ولا تُكتب إلا الحقول المتغيّرة مع etag الحقيقي (فلا تُستبدل تعديلات BC)، ويصبح المغادرون غير نشطين/منتهية خدمتهم، ويقرأ ‎--verify بيانات BC ويقارنها ببصمتك. شغّله كإضافة AL قابلة للتثبيت أو كسكربت مرجعي أو كتدفق Power Automate.

  • SAP Business One

    يرسل موظفي بصمتك إلى EmployeesInfo في SAP Business One عبر Service Layer، بمفتاح ExternalEmployeeNumber (أو BSM-<id> عند غياب الرقم الوظيفي أو تجاوزه الطول المسموح في B1). يُطابَق الموظفون الموجودون في B1 بالمفتاح أو البريد بدلاً من تكرارهم، وتحترم الحقول أطوال أعمدة B1، ويُعطَّل المغادرون مع تاريخ انتهاء الخدمة، ولا يوقف سجل خاطئ واحد التشغيل، ويقرأ ‎--verify بيانات B1 للتحقق. يبقى التحقق من شهادة TLS مفعّلاً (استخدم ca_bundle لشهادة Service Layer الموقّعة ذاتياً). لا تملك B1 بيانات حضور/رواتب رئيسية أصلية، لذا يغطي هذا بيانات الموظفين.

  • ERPNext

    طريقتان للتشغيل: تطبيق Frappe قابل للتثبيت (صفحة إعدادات، زر Sync now، مجدول ساعي، حقول basmtak_id المخصصة)، أو سكربت مزامنة REST مستقل. كلاهما تزايدي (updated_since) وغير مُكرِّر (basmtak_id).

  • Oracle NetSuite

    يرسل موظفي بصمتك إلى NetSuite عبر SuiteTalk REST بمصادقة Token-Based Authentication (OAuth 1.0a، HMAC-SHA256). يُحدَّث الموظف عبر المعرّف الخارجي BSM-<رقم بصمتك> (ثابت وصالح للروابط حتى لو احتوى الرقم الوظيفي على مسافات أو شرطات)، ويُتبنّى الموجودون مسبقاً في NetSuite بمطابقة المعرّف الخارجي أو رقم الموظف أو البريد بدلاً من تكرارهم، ويُعطَّل المغادرون، ويقرأ ‎--verify بيانات NetSuite ويفشل عند أي موظف ناقص أو قديم أو مكرر أو يتيم.

الأسئلة الشائعة

كيف أعيد تعيين كلمة المرور؟

في صفحة تسجيل الدخول اضغط نسيت كلمة المرور واتبع رابط البريد. يمكن للمشرفين أيضاً إعادة تعيين وصول أي مستخدم من صفحة المستخدمين.

هل يمكنني استخدام بصمتك بالعربية والإنجليزية؟

نعم. بدّل لغة الواجهة في أي وقت من أيقونة اللغة في الشريط العلوي. تُرسَل الإشعارات كذلك بلغة كل موظف المفضلة.

هل بياناتي آمنة؟

بياناتك معزولة لكل شركة، ومشفّرة أثناء النقل، والوصول مضبوط بالأدوار والصلاحيات. تُخزَّن مفاتيح API مُجزّأة وتُعرض مرة واحدة فقط.

لماذا لا يستطيع الموظف تسجيل الحضور؟

غالباً لأنه خارج النطاق الجغرافي للفرع، أو سياسة موقعه محددة بفرع معيّن. تحقق من نصف قطر الفرع وسياسة حضور الموظف.

نسي موظف تسجيل الانصراف — ماذا أفعل؟

افتح تقرير الحضور، صفِّ حسب الانصراف المفقود، افتح السجل وأدخل الوقت الصحيح. يمكن للموظف أيضاً رفع طلب انصراف مفقود من التطبيق.

هل أحتاج جهاز بصمة؟

لا. يمكن للموظفين تسجيل الحضور من التطبيق مع النطاق الجغرافي. جهاز البصمة اختياري للمواقع التي تفضّله، ويمكن استخدام الاثنين معاً.

كيف تُحسب خصومات التأخير والغياب؟

من القواعد التي تضبطها في سياسة الحضور. يطبّق بصمتك فترات السماح والشرائح تلقائياً أثناء مسير الرواتب، وفق إعدادات نظام العمل عند الحاجة.

هل يرى الموظفون قسائم رواتبهم؟

نعم، بعد اعتماد المسير وإصدار القسائم، يمكن للموظفين رؤيتها في التطبيق. يمكنك أيضاً تصديرها أو طباعتها.

كم تكلفة الربط مع مُدد؟

600 ريال سنوياً للمنشأة كاملة (690 ريالاً شاملة الضريبة) مهما كان عدد الموظفين. وهي خدمة إضافية اختيارية لخدمة الرواتب، تُحتسب بالسنة حتى عند إضافتها أثناء الاشتراك (600 ريال لكل سنة متبقية منه، لا بالشهر)، ولا تنطبق عليها أكواد الخصم.

هل يمكنني الاشتراك في الربط مع مُدد بدون خدمة الرواتب؟

لا — مُدد تحوّل المسير الذي يُعدّه بصمتك، لذا تعمل الإضافة على خدمة الرواتب. وإن لم يشمل اشتراكك الرواتب تُضاف الخدمتان معاً. وهي غير إلزامية أبداً، حتى للمنشآت الأقل من 20 موظفاً.

هل يمر الاعتماد عبر أكثر من شخص؟

نعم. أنشئ مسار اعتماد متعدد المستويات (تسلسلي أو متوازٍ) لكل نوع طلب من الطلبات ← مسار الاعتماد.

هل يمكنني إنشاء أنواع طلبات خاصة؟

نعم. إلى جانب الأنواع المدمجة (إجازة، سلفة، استئذان…) يمكنك إضافة أنواع طلبات مخصصة بأيقونتها وحقولها ومسار اعتمادها.

ما الأنظمة التي يمكنني التكامل معها؟

تتوفر موصّلات جاهزة لأودو، وSAP SuccessFactors، وSAP Business One، وOracle Fusion HCM، وOracle NetSuite، وMicrosoft Dynamics 365، وDynamics 365 Business Central، وERPNext. يمكن لأي نظام آخر استخدام واجهة الشركاء REST مباشرة.

فقدت مفتاح API. هل يمكن إعادة إرساله؟

لا — لأسباب أمنية يُعرض السر مرة واحدة فقط ويُخزَّن مُجزّأً. ألغِ المفتاح القديم وأصدر آخر من ربط نظام آخر.

هل يمكن قصر التكامل على فرع واحد؟

نعم. عند إصدار المفتاح يمكنك قصره على فروع وأقسام محددة، ومنح صلاحيات القراءة/الكتابة التي يحتاجها التكامل فقط.

جهازي يظهر غير متصل. ماذا أفحص؟

تأكد من الطاقة والاتصال بالإنترنت أولاً — أغلب المشاكل سببها الشبكة. ثم شغّل مزامنة يدوية. إذا استمرت، تواصل مع الدعم مع الرقم التسلسلي.

ما أجهزة البصمة المدعومة؟

أجهزة ZKTeco التي تدعم بروتوكول الدفع مدعومة. تواصل معنا برقم الموديل لنؤكد التوافق ونساعدك في ربطه.

Help Center — Basmtak HR Guides & Tutorials

Step-by-step guides for Basmtak HR: attendance, payroll, requests and reports, plus ERP integration guides and frequently asked questions.

Getting Started

Employees

Branches, Departments & Shifts

Mobile App

Attendance

Requests & Approvals

Payroll

Reports

Devices

Users & Permissions

Settings & Account

Integrations & API

ERP integration guides

  • Odoo

    The Basmtak addon installs straight into Odoo and keeps it in sync: incremental after the first import, resumable for large companies (it continues across scheduler runs instead of timing out), and duplicate-safe — every record is matched by its Basmtak ID, enforced by the database, and employees that already exist in Odoo are linked rather than created twice. Deletions and cancellations in Basmtak are mirrored, and employees created in Odoo can be pushed back to Basmtak.

  • SAP SuccessFactors

    Two ways to run it: an SAP Integration Suite (CPI) iFlow you import and deploy, or a runnable reference sync. Both look each person up in SuccessFactors before writing, hire in SAP's documented order, update only what changed, terminate leavers, and check the per-record status of every upsert (SuccessFactors answers HTTP 200 even when records fail). The reference sync also mirrors approved leave as EmployeeTime (cancelled leave is set CANCELLED) and offers a read-only --verify.

  • Oracle Fusion HCM

    Two ways to run it: an Oracle Integration Cloud (OIC) recipe, or a reference sync that builds HCM Data Loader (HDL) files, submits them, waits for the load and checks every error line. New hires carry every mandatory component, existing Fusion workers are matched instead of hired twice, leavers are terminated, and approved leave becomes absence entries that are withdrawn if the leave is cancelled. Incremental via the server cursor; a failed load never advances it. `--verify` reads Fusion back and compares it with Basmtak.

  • Microsoft Dynamics 365

    A Power Platform Custom Connector for the Basmtak Partner API, usable across your tenant, plus a ready-to-adapt employee-sync cloud flow (Recurrence → ListEmployees → Upsert row).

  • Dynamics 365 Business Central

    Syncs Basmtak employees into Business Central (BC's SMB ERP) through the BC REST API v2.0, secured with Microsoft Entra (Azure AD) OAuth 2.0 client credentials. Employees are keyed by BC No. = the Basmtak HR number (or BSM-<id> when it is missing or too long for BC), existing BC employees are adopted rather than duplicated, only changed fields are written with the real etag (so edits made in BC are not overwritten), leavers become Inactive/Terminated, and --verify reads BC back and compares it with Basmtak. Run it as an installable AL extension with a Sync now button, a reference script, or a Power Automate flow.

  • SAP Business One

    Pushes Basmtak employees into SAP Business One's EmployeesInfo through the Service Layer, keyed by ExternalEmployeeNumber (BSM-<id> when the HR number is missing or longer than B1 allows). Existing B1 employees are matched by key or email instead of duplicated, fields respect B1's column sizes, leavers are set inactive with a termination date, one bad record never stops the run, and --verify reads B1 back. TLS verification stays on (use ca_bundle for a self-signed Service Layer certificate). B1 has no native attendance/payroll master, so this covers the employee master.

  • ERPNext

    Two ways to run it: an installable Frappe app (settings page, Sync now button, hourly scheduler, basmtak_id custom fields), or a standalone REST sync script. Both are incremental (updated_since) and idempotent (basmtak_id).

  • Oracle NetSuite

    Pushes Basmtak employees into NetSuite via SuiteTalk REST, secured with Token-Based Authentication (OAuth 1.0a, HMAC-SHA256). Employees upsert by NetSuite external id BSM-<Basmtak id> (stable and URL-safe even when HR numbers contain spaces or slashes); people who already exist in NetSuite are matched by external id, employee id or email and adopted instead of duplicated; leavers are set inactive; --verify reads NetSuite back and fails on missing, stale, duplicate or orphan employees.

Frequently asked questions

How do I reset my password?

On the login page click Forgot password and follow the email link. Admins can also reset a user's access from the Users page.

Can I use Basmtak in Arabic and English?

Yes. Switch the interface language any time from the language icon in the top bar. Notifications are also sent in each employee's preferred language.

Is my data secure?

Your data is isolated per company, encrypted in transit, and access is controlled by roles and permissions. API keys are hashed and shown only once.

Why can't an employee check in?

Usually they're outside the branch geofence, or their location policy is set to a specific branch. Check the branch radius and the employee's check-in policy.

An employee forgot to check out — what now?

Open the attendance report, filter by missing check-out, open the record and enter the correct time. The employee can also raise a missing check-out request from the app.

Do I need a fingerprint device?

No. Employees can check in from the mobile app with geofencing. A fingerprint device is optional for sites that prefer it, and both can be used together.

How are late and absence deductions calculated?

From the rules you set in Attendance policy. Basmtak applies grace periods and tiers automatically during the payroll run, following labor-law defaults where relevant.

Can employees see their own payslips?

Yes, once a payroll run is finalized and payslips are generated, employees can view them in the mobile app. You can also export or print them.

How much does the Mudad integration cost?

SAR 600 a year for the whole company (SAR 690 including VAT), whatever the number of employees. It is an optional add-on to Payrolls, charged by the year even when you add it mid-subscription (600 for each year left on your plan, never by the month), and promo codes don't apply to it.

Can I have the Mudad integration without Payrolls?

No — Mudad transfers the payroll Basmtak prepares, so the add-on works on top of the Payrolls service. If your plan doesn't include Payrolls, both are added together. It is never mandatory, even for companies under 20 employees.

Can approvals go through more than one person?

Yes. Build a multi-level approval workflow (serial or parallel) per request type from Requests → Approvals flow.

Can I create my own request types?

Yes. Alongside the built-in types (vacation, advance, excuse…) you can add custom request types with their own icon, fields and approval flow.

Which systems can I integrate with?

Ready-made connectors exist for Odoo, SAP SuccessFactors, SAP Business One, Oracle Fusion HCM, Oracle NetSuite, Microsoft Dynamics 365, Dynamics 365 Business Central and ERPNext. Any other system can use the REST Partner API directly.

I lost my API key. Can you resend it?

No — for security the secret is shown only once and stored hashed. Revoke the old key and issue a new one from Connect another system.

Can I limit an integration to one branch?

Yes. When issuing a key you can restrict it to specific branches and departments, and grant only the read/write scopes the integration needs.

My device shows offline. What should I check?

Confirm power and internet connection first — most issues are network related. Then trigger a manual resync. If it persists, contact support with the serial number.

Which fingerprint devices are supported?

ZKTeco push-protocol devices are supported. Contact us with your model number and we'll confirm compatibility and help you link it.