Complete User Guide for Egyptian Payroll Calculation Engine
Version 1.1.1 - Professional Edition
دليل المستخدم لمنصة حساب المرتبات المصرية
الإصدار 1.1.1 - النسخة الاحترافية
Complete User Guide for Egyptian Payroll Calculation Engine
دليل المستخدم لمنصة حساب المرتبات المصرية
Nexus is a salary calculation platform by Aliateck for payroll professionals and ERP-based systems. It supports a bilingual user interface (English / Arabic), batch processing, salary grossing-up, multi-currency handling, reconciliation, multiple employment types, full compliance with all Egyptian regulations, and API integration for automated and ERP-based systems.
28 complete insurance cases including comprehensive health insurance, plus 8 tax treatment scenarios.
Complete annual reconciliation calculations covering tax years from 2020 to 2027.
Process all employees simultaneously with batch calculations. 10k Employees / 1 Sec.
Calculate from Gross to Net salary or from Net to Gross salary with precision.
Handle payroll calculations in multiple currencies with automatic conversion and compliance.
Import from CSV/Excel files and export detailed results with formatting.
API access for system integration and automated payroll processing.
Seamless switching between English and Arabic with full RTL support and localized content.
Fully compliant with Egyptian tax law and social insurance regulations.
Nexus هو نظام احترافي لحساب المرتبات من تطوير Aliateck، لمتخصصي المرتبات وأنظمة الـ ERP. يدعم النظام واجهة استخدام ثنائية اللغة (العربية / الإنجليزية)، والمعالجة المجمعة للبيانات، وحساب المرتب بطريقة الـ Gross-Up، ودعم العملات المتعددة، وحساب التسويات، ويشمل جميع أنواع التعاقدات والالتزام بجميع القوانين واللوائح المصرية بالإضافة إلى التكامل عبر واجهات برمجية (API) للأنظمة المؤتمتة وأنظمة تخطيط الموارد المؤسسية.
28 حالة تأمينية كاملة بالإضافة إلى التأمين الصحي الشامل، مع 8 حالات معاملة ضريبية.
حسابات تسويات سنوية كاملة تغطي السنوات الضريبية من 2020 إلى 2027.
معالجة جميع الموظفين دفعة واحدة باستخدام الحسابات المجمعة. 10 آلاف موظف / ثانية واحدة.
حساب المرتب من الإجمالي إلى الصافي أو من الصافي إلى الإجمالي بدقة عالية.
معالجة حسابات المرتبات بعملات متعددة مع التحويل التلقائي والامتثال الكامل.
استيراد البيانات من ملفات CSV و Excel وتصدير النتائج بتنسيق احترافي.
إتاحة واجهات برمجية للتكامل مع الأنظمة الأخرى وأتمتة عمليات المرتبات.
التبديل السلس بين العربية والإنجليزية مع دعم كامل للكتابة من اليمين لليسار والمحتوى المحلي.
متوافق بالكامل مع قانون الضرائب المصري ولوائح التأمينات الاجتماعية.
| Feature | Description | Benefits |
|---|---|---|
| Gross to Net Calculation | Calculate net salary from gross salary including all deductions | Accurate payroll processing |
| Net to Gross Calculation | Calculate required gross salary to achieve target net salary | Salary planning and budgeting |
| Multi-Employee Processing | Process unlimited employees in a single batch operation | Time-saving bulk operations |
| Real-time Validation | Instant validation of employee data as you type | Prevent errors before calculation |
| Excel Import/Export | Import CSV files and export formatted Excel results | Easy integration with existing systems |
| Bilingual Interface | Full Arabic and English support with RTL layout | Accessible to all users |
| الميزة | الوصف | الفوائد |
|---|---|---|
| حساب من الإجمالي إلى الصافي | حساب الراتب الصافي من الراتب الإجمالي شاملاً جميع الخصومات | معالجة دقيقة للرواتب |
| حساب من الصافي إلى الإجمالي | حساب الراتب الإجمالي المطلوب للوصول إلى الراتب الصافي المستهدف | تخطيط الرواتب والميزانية |
| معالجة متعددة الموظفين | معالجة عدد غير محدود من الموظفين في عملية واحدة | توفير الوقت في العمليات المجمعة |
| التحقق في الوقت الفعلي | التحقق الفوري من بيانات الموظف أثناء الكتابة | منع الأخطاء قبل الحساب |
| استيراد/تصدير Excel | استيراد ملفات CSV وتصدير نتائج Excel منسقة | تكامل سهل مع الأنظمة الموجودة |
| واجهة ثنائية اللغة | دعم كامل للعربية والإنجليزية مع تخطيط RTL | في متناول جميع المستخدمين |
Navigate to the Nexus Engine from your dashboard.
Select the appropriate tax year and month for calculations.
Add employee information either by uploading a CSV file or manually.
Choose calculation type and process the data.
اختر Nexus من لوحة التحكم.
اختر السنة والشهر الضريبي المناسب للحسابات.
أضف معلومات الموظف إما يدوياً أو برفع ملف CSV.
اختر نوع الحساب ومعالجة البيانات.
| Field Name | Required | Description | Example |
|---|---|---|---|
| Employee Code | ✅ Yes | Unique identifier for the employee (1-10 characters). | EMP001, A123 |
| Employee Name | ❌ No | Full name of the employee. | Ahmed Ali |
| Nationality | ✅ Yes | Nationality / Contractual Status (1-4). | 1 |
| Duration of Employment | ✅ Yes | Number of days worked in the period. | 30, 22, 15 |
| Insurance Status | ✅ Yes | Social insurance status code (1-28). | 1 |
| Comprehensive Wage | ❌ No | Comprehensive Wage, Used to calculate the Insurance wage. It is calculated automatically if left blank. | 5000.00 |
| Allowances not subject to insurance | ❌ No | Allowances not subject to insurance. It is calculated automatically if left blank. | 1,000.00 |
| Comprehensive health insurance status | ✅ Yes | Comprehensive health insurance status method (1-2). | 1 |
| Number of non-working wives | ✅ Yes | Number of non-working wives (comprehensive health insurance) (0-4). | 1 |
| Number of dependents | ✅ Yes | Number of dependents (comprehensive health insurance). | 1 |
| Tax Treatment | ✅ Yes | Tax calculation method ( 1 - 8 ). | 1 |
| Entitlements | ✅ Yes | Entitlements | 10,000.00 |
| Amounts exempted by special laws | ❌ No | Total amounts exempted by special laws. Will be added to Entitlements to get the total Entitlements | 1,000.00 |
| Deductions | ❌ No | Total Deductions | 500.00 |
| Currency | ❌ No | Currency | EGP |
| Exchange rate | ❌ No | Default 1 | 1 |
Input the gross salary (Entitlements + Amounts exempted by special laws) and all other inputs, the system calculates the net salary after all deductions
including:
• Income tax
• Social insurance contributions
• Health insurance
• Martyrs fund contribution
Input the desired net salary (Entitlements + Amounts exempted by special laws) and all other inputs, the
system calculates the required gross salary to achieve that net amount after all deductions including:
• Income tax
• Social insurance contributions
• Health insurance
• Martyrs fund contribution
• Other Deductions
| اسم الحقل | إلزامي | الوصف | مثال |
|---|---|---|---|
| كود الموظف | ✅ نعم | المعرف الفريد للموظف (من 1 إلى 10 أحرف). | EMP001 ، A123 |
| اسم الموظف | ❌ لا | الاسم الكامل للموظف. | أحمد محمد علي |
| الجنسية | ✅ نعم | الجنسية / الحالة التعاقدية (1-4). | 1 |
| مدة العمل | ✅ نعم | عدد أيام العمل خلال الفترة. | 30 ، 22 ، 15 |
| حالة التأمين الاجتماعي | ✅ نعم | كود حالة التأمين الاجتماعي (من 1 إلى 28). | 1 |
| الأجر الشامل | ❌ لا | الأجر الشامل، يُستخدم لحساب الأجر التأمينى. يتم احتسابه تلقائيًا في حالة تركه فارغًا. | 5000.00 |
| بدلات غير خاضعة للتأمين | ❌ لا | البدلات غير الخاضعة للتأمين، يتم احتسابها تلقائيًا في حالة تركها فارغة. | 1,000.00 |
| حالة التأمين الصحي الشامل | ✅ نعم | طريقة حساب التأمين الصحي الشامل (1–2). | 1 |
| عدد الزوجات غير العاملات | ✅ نعم | عدد الزوجات غير العاملات (للتأمين الصحي الشامل) (من 0-4). | 1 |
| عدد المعالين | ✅ نعم | عدد المعالين (للتأمين الصحي الشامل). | 1 |
| المعاملة الضريبية | ✅ نعم | طريقة حساب الضريبة (1–8). | 1 |
| الاستحقاقات | ✅ نعم | جميع المبالغ المستحقة ماعدا المبلغ المعفاة. | 10,000.00 |
| مبالغ معفاة بموجب قوانين خاصة | ❌ لا | إجمالي المبالغ المعفاة بموجب قوانين خاصة. يتم إضافتها إلى الاستحقاقات للحصول على إجمالي الاستحقاقات. | 1,000.00 |
| الاستقطاعات | ❌ لا | إجمالي الاستقطاعات. | 500.00 |
| العملة | ❌ No | العملة | EGP |
| سعر الصرف | ❌ No | القيمة الافتراضية 1 | 1 |
أدخل الراتب الإجمالي وسيحسب النظام الراتب الصافي بعد جميع الخصومات شاملة:
• ضريبة الدخل
• مساهمات التأمين الاجتماعي
• التأمين الصحي
• مساهمة صندوق الشهداء
أدخل صافي الراتب المطلوب (الاستحقاقات + المبالغ المعفاة بموجب قوانين خاصة)، وسيقوم النظام بحساب إجمالي الراتب المطلوب للوصول إلى هذا الصافي، مع مراعاة جميع الشرائح الضريبية والاستقطاعات.
Format your employee data according to the required structure.
Supported format: CSV UTF-8 (Comma delimited)
Windows Region Settings (Required):
.,Click the upload button and select your prepared CSV file.
قم بتنسيق بيانات موظفيك وفقاً للهيكل المطلوب.
التنسيق المدعوم: CSV UTF-8 (Comma delimited)
إعدادات المنطقة في Windows (مطلوب):
.,انقر على زر الرفع واختر ملف CSV المُعد.
Red borders appear around invalid fields.
File upload doesn't work or data appears incorrect.
Calculations fail or return unexpected results.
تظهر حدود حمراء حول الحقول غير الصالحة.
رفع الملف لا يعمل أو البيانات تظهر غير صحيحة.
فشل الحسابات أو إرجاع نتائج غير متوقعة.
