Complete User Guide for Egyptian Payroll Calculation Engine
Version 1.2.0 - Professional Edition
دليل المستخدم لمنصة حساب المرتبات المصرية
الإصدار 1.2.0 - النسخة الاحترافية
Complete User Guide for Egyptian Payroll Calculation Engine
دليل المستخدم لمنصة حساب المرتبات المصرية
Nexus is a salary calculation platform by Aliateck for payroll professionals and ERP-based systems. Supports salary grossing-up, smart payroll cost optimization, multi-currency handling, and annual reconciliation.
Optimize payroll structures while maintaining employees' take-home pay, helping reduce tax costs with full compliance with Egyptian tax and social insurance regulations.
28 complete insurance cases including Universal 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، والتحسين الذكي لتكلفة المرتبات، ودعم العملات المتعددة، وحساب التسويات السنوية.
حسّن هيكل المرتبات مع الحفاظ على صافي دخل الموظفين، بما يساهم في خفض التكلفة الضريبية مع الالتزام الكامل بقوانين ضريبة كسب العمل والتأمينات الاجتماعية المصرية.
28 حالة تأمينية كاملة بالإضافة إلى التأمين الصحي الشامل، مع 8 حالات معاملة ضريبية.
حسابات تسويات سنوية كاملة تغطي السنوات الضريبية من 2020 إلى 2027.
معالجة جميع الموظفين دفعة واحدة باستخدام الحسابات المجمعة. 10 آلاف موظف / ثانية واحدة.
حساب المرتب من الإجمالي إلى الصافي أو من الصافي إلى الإجمالي بدقة عالية.
معالجة حسابات المرتبات بعملات متعددة مع التحويل التلقائي والامتثال الكامل.
استيراد البيانات من ملفات CSV و Excel وتصدير النتائج بتنسيق احترافي.
إتاحة واجهات برمجية للتكامل مع الأنظمة الأخرى وأتمتة عمليات المرتبات.
التبديل السلس بين العربية والإنجليزية مع دعم كامل للكتابة من اليمين لليسار والمحتوى المحلي.
متوافق بالكامل مع قانون الضرائب المصري ولوائح التأمينات الاجتماعية.
| Feature | Description | Benefits |
|---|---|---|
| Smart Payroll Cost Optimization | Optimize payroll structures while maintaining employees' take-home pay, helping reduce payroll costs with full compliance with Egyptian tax and social insurance regulations | Lower payroll costs with full compliance |
| 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 Available only on 'Nexus' or manually.
Choose calculation type and process the data.
اختر Nexus من لوحة التحكم.
اختر السنة والشهر الضريبي المناسب للحسابات.
أضف معلومات الموظف إما يدوياً أو برفع ملف CSV. متاح فقط فى 'Nexus'
اختر نوع الحساب ومعالجة البيانات.
| Field Name | Required | Description | Example |
|---|---|---|---|
| Employee Code | ❌ No | 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 | Automatically calculated if left empty. Used to calculate the insurance wage, the contribution share for the Universal Health Insurance, and non-insurable allowances. | 5000.00 |
| Non-insurable allowances | ❌ No | Automatically calculated if left empty. The entered value is adjusted to comply with the law. Maximum: 25% of the gross salary for calculating the contribution share of Universal Health Insurance, and 30% of the insurance wage. | 1,000.00 |
| Universal health insurance status | ✅ Yes | Universal health insurance status method (1-2). | 1 |
| Number of non-working wives | ✅ Yes | Number of non-working wives (universal health insurance) (0-4). | 1 |
| Number of dependents | ✅ Yes | Number of dependents (universal 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 |
| بدلات غير خاضعة للتأمين | ❌ لا | يتم حسابها تلقائيًا في حالة تركها فارغة. يتم تعديل القيمة المدخلة لتتماشى مع صحيح القانون. الحد الأقصى 25% من الأجر الشامل لحساب حصة الأشتراك فى التأمين الصحي الشامل ، 30% من الأجر التأمينى. | 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 |
أدخل الراتب الإجمالي وسيحسب النظام الراتب الصافي بعد جميع الخصومات شاملة:
• ضريبة الدخل
• مساهمات التأمين الاجتماعي
• التأمين الصحي
• مساهمة صندوق الشهداء
أدخل صافي الراتب المطلوب (الاستحقاقات + المبالغ المعفاة بموجب قوانين خاصة)، وسيقوم النظام بحساب إجمالي الراتب المطلوب للوصول إلى هذا الصافي، مع مراعاة جميع الشرائح الضريبية والاستقطاعات.
When an employee's exchange rate is set to a value other than 1, all monetary inputs are internally converted to EGP before tax and insurance calculations — as required for Egyptian law compliance. After calculation the system automatically converts the results back to the employee's original currency so you can review, print, and share the full breakdown in the currency the employee is actually paid in.
Enter a rate other than 1 in the Exchange Rate field for any employee. Optionally fill in the Currency field (e.g. USD, EUR).
Click Gross to Net or Net to Gross as usual. The engine converts all monetary inputs to EGP internally, calculates tax and insurance, then divides each result by the exchange rate to restore the original currency values.
Results appear automatically.
Use the Print button inside the Foreign Currency Results popup (Nexus) or the standard print / share / download actions (TAX EG Expert) to generate pay slips. When a foreign currency is active, slips are automatically produced for both EGP and the original currency.
عند ضبط سعر الصرف لأي موظف بقيمة تختلف عن 1، يُحوِّل النظام تلقائياً جميع المدخلات النقدية إلى الجنيه المصري قبل إجراء حسابات ضريبة كسب العمل والتأمينات — وذلك امتثالاً للقانون المصري. بعد الحساب يُعيد النظام تحويل النتائج إلى العملة الأصلية للموظف، ليتمكن المستخدم من مراجعة المفردات الكاملة وطباعتها ومشاركتها بالعملة التي يتقاضى بها الموظف مرتبه فعلياً.
أدخل قيمة مختلفة عن 1 في حقل سعر الصرف لأي موظف. يمكنك اختياريًا تعبئة حقل العملة (مثل USD أو EUR).
انقر "من الإجمالي إلى الصافي" أو "من الصافي إلى الإجمالي" كالمعتاد. يُحوِّل المحرك جميع المدخلات النقدية إلى جنيه مصري داخلياً، يحسب الضريبة والتأمينات، ثم يقسم كل نتيجة على سعر الصرف لاسترداد قيم العملة الأصلية.
تظهر النتائج تلقائياً.
استخدم زر الطباعة داخل نافذة نتائج العملات الأجنبية (Nexus) أو أزرار الطباعة / المشاركة / التنزيل المعتادة (TAX EG Expert) لإنشاء المفردات. عند تفعيل عملة أجنبية تُنشأ المفردات تلقائياً لكلتا العملتين: الجنيه المصري والعملة الأصلية.
After a Gross-to-Net calculation, the app can check for a lower-cost alternative automatically. It shows you the alternative gross salary required to deliver that same net amount — and highlights the tax impact of the adjustment.
Enter employee data and click Gross to Net. The system saves the resulting tax amount as a baseline for comparison.
An Optimize Payroll Cost button appears automatically.
The app automatically checks whether the same take-home pay can be delivered at a lower total payroll cost, and shows you the reduction when one is available. No manual data entry is required.
A tax difference indicator appears showing the change in tax between the two calculations.
بعد الحساب من الإجمالي إلى الصافي، يمكن للتطبيق البحث تلقائياً عن بديل أقل تكلفة. يُظهر لك الإجمالي البديل المطلوب لتحقيق نفس الصافي — مع إبراز الأثر الضريبي للتعديل.
أدخل بيانات الموظف وانقر من الإجمالي إلى الصافي. يحفظ النظام مبلغ الضريبة الناتج كأساس للمقارنة.
يظهر تلقائياً زر حسّن تكلفة المرتبات.
يتحقق التطبيق تلقائياً مما إذا كان يمكن تحقيق نفس صافي المرتب بتكلفة إجمالية أقل، ويعرض لك قيمة الخفض المتاح إن وُجد. لا حاجة لإدخال يدوي.
يظهر مؤشر فرق الضريبة يوضح التغيُّر في الضريبة بين الحسابين.
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 المُعد.
After running a calculation, you can generate a formatted pay slip for every employee with a single click. Slips print in the current UI language (Arabic or English) and include a full breakdown of entitlements, deductions, exemptions, net pay, and the employer's share.
Complete a Gross-to-Net or Net-to-Gross calculation first.
Find the print button in the results header area.
Your browser's print dialog opens with slips ready to print.
| Section | Items Included |
|---|---|
| Header | Employee name, tax period, currency, print date |
| Entitlements | Basic salary, other exempt allowances, total entitlements, comprehensive wage, insurance wage, non-insurable allowances |
| Deductions & Exemptions | Worker social insurance, health insurance deduction, special-law exemptions, personal exemption, net income, annual bracket, tax for period, martyrs fund |
| Net Pay | Net wage, total deduction columns, net final pay |
| Employer Share | Company social insurance share, company health insurance share |
Available on TAX EG Expert only
After calculating, click the Share Pay Slip button next to the print button. The system packages the formatted slip as a self-contained HTML file and opens your device's native share sheet.
The button appears in the results action row, next to Print.
On mobile the native share sheet opens automatically.
The shared file is a standalone .html file.
بعد تشغيل الحساب، يمكنك إنشاء إيصال راتب منسق لكل موظف بنقرة واحدة. تُطبع الإيصالات بلغة الواجهة الحالية (العربية أو الإنجليزية) وتتضمن تفصيلاً كاملاً للاستحقاقات والخصومات والإعفاءات وصافي الراتب وحصة صاحب العمل.
أكمل حساب من الإجمالي إلى الصافي أو العكس أولاً.
ابحث عن زر الطباعة في منطقة رأس النتائج.
تفتح نافذة الطباعة الخاصة بالمتصفح مع الإيصالات جاهزة.
| القسم | البنود المضمّنة |
|---|---|
| الرأسية | اسم الموظف، الفترة الضريبية، العملة، تاريخ الطباعة |
| الاستحقاقات | الراتب الأساسي، بدلات معفاة أخرى، إجمالي الاستحقاقات، الأجر الشامل، الأجر التأميني، البدلات غير الخاضعة للتأمين |
| الخصومات والإعفاءات | حصة العامل في التأمينات، خصم التأمين الصحي، إعفاءات قوانين خاصة، الإعفاء الشخصي، صافي الدخل، الشريحة السنوية، ضريبة الفترة، مساهمة صندوق الشهداء |
| صافي الراتب | صافي الأجر، إجمالي أعمدة الخصم، صافي الراتب النهائي |
| حصة صاحب العمل | حصة الشركة في التأمينات الاجتماعية، حصة الشركة في التأمين الصحي |
متاح في TAX EG Expert فقط
بعد الحساب، انقر زر مشاركة مفردات المرتب بجانب زر الطباعة. يقوم النظام بتجميع الإيصال المنسق في ملف HTML مستقل ويفتح نافذة المشاركة الأصلية على جهازك.
يظهر زر في صف الإجراءات بجانب زر الطباعة.
على الجوال تفتح نافذة المشاركة الأصلية تلقائياً.
الملف المُشارَك هو ملف .html مستقل.
Red borders appear around invalid fields.
File upload doesn't work or data appears incorrect.
Calculations fail or return unexpected results.
تظهر حدود حمراء حول الحقول غير الصالحة.
رفع الملف لا يعمل أو البيانات تظهر غير صحيحة.
فشل الحسابات أو إرجاع نتائج غير متوقعة.
