التوثيق

دليل شامل لاستخدام حسَّاب وإدارة أعمالك بكفاءة

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

تعلم كيفية البدء مع حسَّاب خطوة بخطوة

دليل نقطة البيع

تعلم كيفية استخدام نظام نقاط البيع لإدارة المبيعات

دليل المحاسبة

تعلم كيفية إدارة الحسابات والعمليات المالية

دليل إدارة العملاء

تعلم كيفية إدارة علاقات العملاء والمبيعات

وثائق API

مرجع كامل لـ API للتحكم في المنصة برمجياً

الإعدادات والتكوين

تعلم كيفية تكوين وإعداد المنصة حسب احتياجاتك

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

1. إنشاء حساب

ابدأ بإنشاء حساب جديد. إذا كنت مدير نظام، يمكنك إنشاء حساب مستأجر جديد.

2. إعداد بياناتك

قم بإضافة معلومات شركتك، المنتجات، والعملاء. هذه البيانات ضرورية لبدء استخدام النظام.

3. بدء الاستخدام

ابدأ بإنشاء أول عملية بيع أو إدخال معاملة محاسبية. استكشف الوحدات المختلفة للمنصة.

نظام نقاط البيع (POS)

إدارة المنتجات

أضف منتجاتك وخدماتك مع الأسعار والتفاصيل. يمكنك تنظيم المنتجات في فئات لتسهيل البحث.

المبيعات

أنشئ فواتير المبيعات بسهولة. النظام يحسب الضريبة تلقائياً ويولد فواتير إلكترونية متوافقة مع ZATCA.

إدارة المخزون

تتبع مستويات المخزون وتلقي تنبيهات عند انخفاض المخزون عن الحد الأدنى.

نظام المحاسبة

دليل الحسابات

قم بإعداد دليل الحسابات الخاص بك. يمكنك إنشاء حسابات رئيسية وحسابات فرعية.

القيد المزدوج

النظام يستخدم القيد المزدوج لضمان دقة السجلات المحاسبية. كل معاملة لها مدين ودائن.

التقارير المالية

احصل على تقارير مالية شاملة مثل قائمة الدخل والميزانية العمومية والدائنون والمدينون.

إدارة علاقات العملاء (CRM)

إدارة الاتصالات

احتفظ بسجل كامل لجميع عملائك ومورديك مع معلومات الاتصال والتاريخ.

إدارة المبيعات

تتبع صفقاتك من البداية حتى الإغلاق. استخدم لوحة Kanban لإدارة المراحل المختلفة.

الأنشطة والمهام

سجل جميع الأنشطة والمهام المتعلقة بعملائك وصفقاتك.

وثائق API

المصادقة

جميع طلبات API تتطلب مصادقة. استخدم NextAuth.js للحصول على token.

Authorization: Bearer {token}

نقاط النهاية الرئيسية

  • GET /api/tenant - قائمة المستأجرين
  • POST /api/tenant - إنشاء مستأجر
  • POST /api/contact - إرسال نموذج اتصال
  • GET /api/zatca/invoice - إنشاء فاتورة ZATCA

الإعدادات والتكوين

دليل شامل لإعدادات المنصة وتكوينها حسب احتياجاتك

إعدادات المستأجر

كل مستأجر لديه إعدادات خاصة به يمكن إدارتها من قبل مدير المستأجر (Admin).

معلومات الشركة

  • اسم الشركة
  • البريد الإلكتروني للشركة
  • رقم الهاتف
  • العنوان والمدينة

الفترة التجريبية

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

  • خلال الفترة التجريبية: يمكن استكشاف جميع الميزات
  • طباعة الفواتير غير متاحة خلال الفترة التجريبية
  • بعد انتهاء الفترة التجريبية: يمكن الترقية إلى حساب مدفوع

إدارة المستخدمين

يمكن لمدير المستأجر (Admin) إنشاء وإدارة المستخدمين داخل مؤسسته.

الأدوار المتاحة

ADMIN

مدير المستأجر - صلاحيات كاملة على جميع الوحدات

ACCOUNTANT

محاسب - صلاحيات كاملة على المحاسبة، قراءة فقط على POS

CASHIER

كاشير - صلاحيات على نقطة البيع فقط

إنشاء المستخدمين

  1. اذهب إلى الإعدادات > المستخدمين
  2. اضغط على "إضافة مستخدم جديد"
  3. املأ المعلومات المطلوبة (الاسم، البريد الإلكتروني، كلمة المرور)
  4. اختر الدور المناسب
  5. احفظ التغييرات

إعداد المحاسبة

عند إنشاء مستأجر جديد، يتم إنشاء حسابين افتراضيين تلقائياً.

الحسابات الافتراضية

  • حساب النقدية (Cash Account) - لحساب الأصول
  • حساب رأس المال (Capital Account) - لحساب حقوق الملكية

يمكن لمدير المستأجر إنشاء حسابات إضافية حسب احتياجاته.

تفضيلات اللغة

المنصة تدعم اللغة العربية والإنجليزية بشكل كامل. يمكنك التبديل بين اللغات في أي وقت.

كيفية تغيير اللغة

  • انقر على زر تغيير اللغة في أعلى الصفحة
  • الواجهة والاتجاه (RTL/LTR) سيتغيران تلقائياً
  • جميع النصوص والواجهات ستظهر باللغة المختارة

تكامل الأسواق الإلكترونية

يمكنك دمج المنصة مع منصات التسوق الإلكترونية الرئيسية لإدارة جميع مبيعاتك من مكان واحد.

المنصات المدعومة

Salla

منصة التسوق الإلكترونية الرائدة في السعودية

ZED

منصة تسوق إلكترونية سعودية متخصصة

NOON

منصة التسوق الإلكترونية الرائدة في المنطقة

Shopify

منصة التجارة الإلكترونية العالمية

Amazon

منصة التجارة الإلكترونية الأكبر في العالم

مميزات التكامل

  • مزامنة المنتجات تلقائياً من وإلى المنصات
  • إدارة المخزون الموحد عبر جميع المنصات
  • تتبع الطلبات والمبيعات من مكان واحد
  • توليد فواتير ZATCA تلقائياً للطلبات
  • تقارير مبيعات شاملة تجمع بيانات جميع المنصات
  • إدارة العملاء الموحدة من جميع القنوات

كيفية إعداد التكامل

  1. اذهب إلى الإعدادات > التكاملات
  2. اختر المنصة التي تريد التكامل معها
  3. أدخل بيانات الاعتماد (API Key أو OAuth)
  4. قم بتفعيل المزامنة التلقائية
  5. راجع إعدادات المنتجات والمخزون
  6. اختبر التكامل بإنشاء طلب تجريبي

ملاحظة: تأكد من الحصول على API Keys من كل منصة قبل بدء التكامل.

تكوين النظام

إعدادات متقدمة لتكوين النظام حسب احتياجاتك.

إعدادات ZATCA المرحلة الثانية

النظام متوافق تلقائياً مع متطلبات ZATCA. جميع الفواتير تُولد مع رموز QR تلقائياً. يمكنك تفعيل المرحلة الثانية لإرسال الفواتير الإلكترونية مباشرة إلى ZATCA.

تفعيل المرحلة الثانية

لتفعيل إرسال الفواتير الإلكترونية تلقائياً إلى ZATCA:

  1. اذهب إلى الإعدادات > إعدادات ZATCA المرحلة الثانية
  2. فعّل خيار "تفعيل المرحلة الثانية من ZATCA"
  3. اختر البيئة (المحاكاة للإختبار أو الإنتاج للاستخدام الفعلي)
  4. قم بتحميل ملف الشهادة (.p12 أو .pfx)
  5. أدخل كلمة مرور الشهادة
  6. احفظ الإعدادات
البيئات المتاحة
  • بيئة المحاكاة (SIMULATION): استخدمها للاختبار والتجربة قبل الانتقال إلى الإنتاج. آمنة ولا تؤثر على البيانات الفعلية.
  • بيئة الإنتاج (PRODUCTION): للاستخدام الفعلي. تأكد من صحة جميع المعلومات قبل التفعيل.
تحذيرات مهمة
  • تأكد من استخدام بيئة المحاكاة للاختبار أولاً
  • تحقق من صحة ملف الشهادة وكلمة المرور قبل التفعيل
  • الرقم التسلسلي للشهادة يتم استخراجه تلقائياً من الملف (اختياري)
  • بعد التفعيل، سيتم إرسال جميع الفواتير الجديدة تلقائياً إلى ZATCA

أمان البيانات

جميع البيانات معزولة حسب المستأجر. كل مستأجر يرى فقط بياناته الخاصة.

النسخ الاحتياطي

يُنصح بالنسخ الاحتياطي المنتظم للبيانات. يمكنك تصدير البيانات من قسم التقارير.

إعدادات الفواتير

يمكنك تخصيص مظهر الفواتير وتنسيق أرقام الفواتير حسب احتياجاتك.

خيارات التخصيص

  • تنسيق أرقام الفواتير (مثل: INV-001, 2024/001)
  • تخصيص مظهر الفاتورة (الألوان، الشعار، التذييل)
  • إضافة حقول مخصصة للفواتير
  • تحديد معلومات الشركة المعروضة على الفواتير

كيفية الوصول إلى إعدادات الفواتير

  1. اذهب إلى الإعدادات
  2. انقر على "إعدادات الفواتير"
  3. قم بتخصيص الإعدادات حسب احتياجاتك
  4. احفظ التغييرات

تعيين المخزن الافتراضي

يمكن لكل مستخدم تعيين مخزن افتراضي لمعاملات نقاط البيع. سيتم استخدام هذا المخزن تلقائياً عند إنشاء المبيعات.

كيفية تعيين المخزن الافتراضي

  1. اذهب إلى الإعدادات
  2. انتقل إلى قسم "المخزن الافتراضي"
  3. اختر المخزن الافتراضي من القائمة المنسدلة
  4. سيتم حفظ التغييرات تلقائياً

ملاحظات مهمة

  • إذا لم يتم تعيين مخزن، سيستخدم النظام المخزن الافتراضي للمستأجر
  • يمكن تغيير المخزن أثناء إنشاء عملية البيع
  • المخزن الافتراضي يؤثر على تتبع المخزون والتقارير
  • يمكن للمستخدمين المختلفين تعيين مخازن مختلفة

إدارة الملف الشخصي

يمكن لجميع المستخدمين تحديث معلومات ملفهم الشخصي وتغيير كلمة المرور.

تحديث معلومات الملف الشخصي

  • الاسم: يمكن تحديثه في أي وقت
  • الهاتف: يمكن إضافة أو تحديث رقم الهاتف
  • البريد الإلكتروني: لا يمكن تغييره (يتم تعيينه من قبل المدير)

للوصول: اذهب إلى الإعدادات > معلومات الحساب

تغيير كلمة المرور

  1. اذهب إلى الإعدادات > معلومات الحساب
  2. انقر على "تغيير كلمة المرور"
  3. أدخل كلمة المرور الجديدة (8 أحرف على الأقل)
  4. أكد كلمة المرور الجديدة
  5. احفظ التغييرات

نصيحة أمنية: استخدم كلمة مرور قوية تحتوي على أحرف كبيرة وصغيرة وأرقام ورموز

إدارة الصلاحيات والأدوار المخصصة

يمكن لمدير المستأجر (Admin) إدارة صلاحيات الأدوار وإنشاء أدوار مخصصة لتلبية احتياجات مؤسسته.

إدارة صلاحيات الأدوار

يمكنك تحديد الوحدات التي يمكن لكل دور الوصول إليها:

  • POS (نقاط البيع)
  • المحاسبة
  • إدارة علاقات العملاء (CRM)
  • المشتريات
  • المبيعات
  • الموارد البشرية (HR)
  • العمليات
  • المخزون
  • التقارير

للوصول: اذهب إلى الإعدادات > إدارة صلاحيات الأدوار

إنشاء أدوار مخصصة

يمكنك إنشاء أدوار مخصصة مع صلاحيات محددة:

  1. اذهب إلى الإعدادات > الأدوار المخصصة
  2. انقر على "إضافة دور جديد"
  3. أدخل اسم الدور ووصفه
  4. اختر الوحدات والصلاحيات المطلوبة
  5. احفظ الدور الجديد

ملاحظة: الأدوار المخصصة تمنحك مرونة أكبر في إدارة الصلاحيات حسب احتياجات مؤسستك

إعداد تكاملات التجارة الإلكترونية

دليل خطوة بخطوة لإعداد التكامل مع منصات التجارة الإلكترونية.

خطوات الإعداد التفصيلية

  1. الحصول على API Keys:
    • سجل الدخول إلى حسابك في المنصة (Amazon، Noon، Shopify، إلخ)
    • انتقل إلى إعدادات المطور أو API
    • أنشئ API Key جديد أو OAuth credentials
    • انسخ API Key و Secret Key (إن وجد)
  2. إعداد التكامل في المنصة:
    • اذهب إلى الإعدادات > تكاملات التجارة الإلكترونية
    • اختر المنصة التي تريد التكامل معها
    • أدخل API Key و Secret Key
    • أدخل معلومات المتجر (Store ID، إلخ)
  3. تفعيل المزامنة:
    • فعّل المزامنة التلقائية للمنتجات
    • فعّل المزامنة التلقائية للمخزون
    • فعّل المزامنة التلقائية للطلبات
    • حدد اتجاه المزامنة (من المنصة، إلى المنصة، أو كلا الاتجاهين)
  4. اختبار التكامل:
    • أنشئ طلب تجريبي في المنصة
    • تحقق من وصول الطلب إلى النظام
    • تحقق من تحديث المخزون تلقائياً
    • تحقق من إنشاء الفاتورة تلقائياً

نصائح استكشاف الأخطاء

  • تأكد من صحة API Keys وعدم انتهاء صلاحيتها
  • تحقق من إعدادات الأمان في حساب المنصة (IP whitelist، إلخ)
  • راجع سجلات الأخطاء في قسم التقارير
  • تأكد من أن المنتجات في المنصة تحتوي على SKU أو Barcode
  • في حالة فشل المزامنة، حاول إعادة المزامنة يدوياً

إدارة بيانات نقاط البيع

يمكن لمدير المستأجر إعادة تعيين بيانات نقاط البيع. هذا الإجراء خطير ولا يمكن التراجع عنه.

تحذير: هذا الإجراء خطير

إعادة تعيين بيانات نقاط البيع سيقوم بـ:

  • إنشاء قيود محاسبية ملخصة لجميع المبيعات
  • حذف جميع بيانات المبيعات بشكل دائم
  • لن يتم تغيير مخزون المنتجات (سيبقى كما هو)
  • لا يمكن التراجع عن هذا الإجراء

قبل تنفيذ هذا الإجراء:

  • تأكد من عمل نسخة احتياطية من جميع البيانات المهمة
  • راجع القيود المحاسبية الملخصة قبل الحذف
  • تأكد من أن جميع الفواتير تم إصدارها للعملاء
  • تأكد من عدم وجود عمليات بيع معلقة

كيفية إعادة تعيين بيانات نقاط البيع

  1. اذهب إلى الإعدادات
  2. انتقل إلى قسم "إدارة بيانات نقاط البيع"
  3. اقرأ جميع التحذيرات بعناية
  4. انقر على "إعادة تعيين بيانات نقاط البيع"
  5. تأكد من الإجراء في النافذة المنبثقة
  6. انتظر حتى يكتمل الإجراء (قد يستغرق بعض الوقت)

ملاحظة: بعد إعادة التعيين، سيتم إنشاء قيود محاسبية ملخصة فقط. جميع بيانات المبيعات التفصيلية سيتم حذفها.

أفضل الممارسات

  • قم بتغيير كلمة المرور الافتراضية فور تسجيل الدخول لأول مرة
  • أنشئ مستخدمين منفصلين لكل دور لضمان الأمان والمحاسبة
  • راجع إعدادات الأمان بانتظام
  • استخدم الفترة التجريبية لاستكشاف جميع الميزات قبل الاشتراك
  • احتفظ بنسخ احتياطية منتظمة من بياناتك المهمة