هذه الصفحة مرجع الحقول لصفحة الإعدادات في لوحة معلومات التاجر، وهي ما يفتحه زر مساعدة أعلى الصفحة في تبويب جديد. لخطوات العمل اليومي راجع الإعدادات والمستخدمون.
الغرض من الشاشة: تجمع هذه الصفحة إعدادات المنشأة على مسار واحد: نظرة عامة على نطاقات الإعدادات والنسخة التي يشغّلها كل جهاز، ثم أربعة تبويبات في وضع الإدارة للمنشأة وفروعها، والمستخدمين وصلاحياتهم، والفوترة الإلكترونية، والتنبيهات. تُعرض الأقسام التي تصلها صلاحياتك فقط، ويعرض الخادم بطاقة تشرح الصلاحية الناقصة مكان أي قسم آخر.
رأس الصفحة
| الحقل | المعنى |
|---|
| إضافة مستخدم | الإجراء الرئيسي: يفتح تبويب المستخدمين في وضع الإدارة ونافذة «إضافة مستخدم» بنموذج فارغ دائمًا، حتى بعد تعديل موظف آخر. يظهر فقط لمن يملك صلاحية إعدادات المستخدمين setting-users. |
|---|
| وضع الصفحة | مفتاح بين «نظرة عامة» و«الإدارة». الوضع والتبويب المفتوح محفوظان في عنوان الصفحة فيمكن مشاركة رابط لأي تبويب. |
|---|
| تعذر الحفظ | ملاحظة تحذيرية تظهر أعلى الصفحة عندما يرفض الخادم أي حفظ في الصفحة؛ راجع الصلاحية ورقم الإصدار الحالي ثم أعد المحاولة. |
|---|
بطاقات النظرة العامة
| الحقل | المعنى |
|---|
| الفروع | عدد فروع المنشأة كما يعيدها الخادم للمالك، أو عدد الفروع المسندة إليك لغير المالك. |
|---|
| النسخة المنشورة | أول اثني عشر حرفًا من بصمة أحدث لقطة إعدادات منشورة على الأجهزة، وتحتها اسم مجال الإعدادات. شرطة مع «لم تُقرأ حالة النشر» عندما لا تملك صلاحية إعدادات نقطة البيع أو لم يُعيَّن أي جهاز. |
|---|
| مؤكَّدة | عدد الأجهزة التي أقرّت باللقطة الحالية من إجمالي الأجهزة المعيّنة، مثل «٢ / ٣». تتلوّن تحذيريًا حتى يقرّ كل جهاز. |
|---|
| الرقم الضريبي | رقم ضريبة القيمة المضافة المسجّل للمنشأة كما يظهر على كل فاتورة، مع «على كل فاتورة». شرطة مع «غير مسجّل بعد» عندما قُرئ السجل ولا رقم فيه، وشرطة مع «خارج صلاحيات دورك» لمن لا يقرأ بيانات المنشأة (تحتاج admin.*)، وشرطة مع «غير مقروء» عندما تعذّرت القراءة؛ فلا يُقال لمدير إن الرقم غير مسجّل لمجرد أنه لا يراه. |
|---|
| نظرة عامة على الإعدادات غير متاحة | بطاقة تحل محل البطاقات والجدول كلها لمن لا يملك admin.* ولا setting-pos، لأن كل رقم فيها يأتي من قراءة إحداهما. تبويب المستخدمين والصلاحيات يعمل كالمعتاد. |
|---|
جدول نطاقات الإعدادات
| الحقل | المعنى |
|---|
| النطاق | صف لكل جهاز معيّن: «جهاز ·» ثم رمزه، وتحته اسمه. الجدول يقرأ حالة النشر ويحتاج صلاحية setting-pos؛ بدونها يظهر «تعذر قراءة حالة النشر لهذا الحساب»، و«لا توجد أجهزة معيّنة بعد» عندما لا يوجد جهاز. |
|---|
| المجال | اسم مجال الإعدادات الذي تُنشر لقطاته، بخط لاتيني. شرطة عندما لم تُقرأ حالة النشر. |
|---|
| النسخة | أول ثمانية أحرف من بصمة اللقطة التي يُفترض أن يشغّلها هذا الجهاز. |
|---|
| الحالة | مؤكَّدة: أقرّ الجهاز باللقطة الحالية. متأخرة: لم يسحبها بعد. فاشلة: أقرّ بخطأ؛ افتح «نشر الإعدادات» من الأجهزة والطباعة لرؤية رمز الخطأ. |
|---|
نافذة التقارير والملاحظات
| الحقل | المعنى |
|---|
| المنطقة الزمنية | المنطقة الزمنية للمنشأة التي تُقطع عليها التقارير والاتجاهات، فتقع مبيعة متأخرة في يومها الصحيح. شرطة لغير المالك. |
|---|
| العملة | عملة المنشأة التي تُعرض بها كل المبالغ. شرطة لغير المالك. |
|---|
| المجال | مجال الإعدادات نفسه المعروض في الجدول، أو شرطة. |
|---|
| الإصدار المتوقع expected_version | رقم إصدار سجل المنشأة الذي يُرسل مع حفظ اسمها لمنع الكتابة فوق تغيير أحدث. شرطة عندما لم تُقرأ المنشأة. |
|---|
| فصل اليوم التجاري غير متاح | حالة غير متاحة صريحة: فصل اليوم التجاري وبداية الأسبوع يعيشان في إعدادات نقطة البيع التي لا تقرأها هذه اللوحة بعد، فلا يُعرض وقت مُختلق مكانهما. |
|---|
| النطاقات متتالية | ملاحظة تشرح ترتيب الغلبة: المنشأة يغلبها الفرع، والفرع الجهاز، والجهاز نقطة البيع، ولا يوسّع جهاز سياسة دفعه بنفسه. |
|---|
| نشر نسخة ليس على هذه الشاشة | حالة غير متاحة صريحة: لا تستدعي أي شاشة في هذه اللوحة مسار نشر لقطة إعدادات جديدة؛ ما تعرضه الصفحة هو نتيجة النشر لا أداته. |
|---|
تبويبات الإدارة
| الحقل | المعنى |
|---|
| المنشأة | بيانات المنشأة وفروعها وإجراءات الأجهزة. يحتاج تحرير المنشأة والفروع إلى admin.*، وإجراءات الأجهزة إلى setting-pos؛ مكان كل قسم لا تملكه بطاقة تسمّي الصلاحية. |
|---|
| المستخدمون والصلاحيات | دليل موظفي الفرع المختار ومصفوفة الصلاحيات. يعرض عدد المستخدمين على التبويب بعد قراءتهم. يحتاج setting-users، وبدونها تظهر بطاقة «دليل المستخدمين غير متاح». |
|---|
| الفوترة الإلكترونية | حالة غير متاحة صريحة: حالة المرحلة الثانية من ZATCA وعدّاد الفواتير يعيشان على وحدة الفوترة الخاصة بكل فرع، ولا يعرض العقد الحالي قائمة بها لهذه الشاشة، فلا يُعرض رقم مُختلق. |
|---|
| التنبيهات | حالة غير متاحة صريحة: قنوات التنبيه وحدودها تُدار مع قواعد التنبيه في صفحة التنبيهات والملخص، ولا توجد نقطة نهاية لتفضيلات القنوات بعد. |
|---|
المنشأة: البيانات والفروع
| الحقل | المعنى |
|---|
| الاسم | اسم المنشأة الذي يظهر على الفواتير والتقارير. يُحرَّر الاسم بلغة الواجهة الحالية فقط: العربي في الواجهة العربية والإنجليزي في الإنجليزية. يظهر على الفواتير الجديدة فقط بعد الحفظ. |
|---|
| الإصدار المتوقع expected_version | حقل للقراءة فقط يعرض إصدار سجل المنشأة الذي سيُرسل مع الحفظ؛ نسخة قديمة تعيد ٤٠٩ فأعد تحميل الصفحة. |
|---|
| حفظ | يحفظ اسم المنشأة. معطّل حتى تُقرأ المنشأة وأثناء الحفظ. |
|---|
| شعار المنشأة | الشعار الحالي أو «أفلت الشعار هنا أو استعرض الملفات»، مع السحب والإفلات. اختيار ملف PNG أو JPEG أو WebP (أقل من ٢ ميغابايت، ٤٠٩٦ بكسل كحد أقصى لكل بُعد) يرفعه فورًا ويقول السطر تحته أين وصل؛ عند الفشل تُعيد «أعد المحاولة» الطلب نفسه، وإزالة تتخلّى عن ملف لم يُحفظ. ملف SVG يُرفض قبل الإرسال. إزالة الشعار الحالي تطلب تأكيدًا. يظهر الشعار أيضًا بجانب اسم المنشأة أعلى لوحة التحكم. |
|---|
| الاسم النظامي (عربي) / الاسم النظامي (إنجليزي) | في «الهوية الضريبية (ZATCA)»: اسم المنشأة كما في السجل التجاري، باللغتين، حتى ٢٤٠ حرفًا لكل منهما. تصدر به كل فاتورة ورمزها، وتعرضه نقاط البيع للقراءة فقط في الإعدادات › بيانات المنشأة. مسح أحدهما يحذفه من السجل. |
|---|
| الرقم الضريبي | خمسة عشر رقمًا أولها ٣ وآخرها ٣، ولا يُمسح بعد حفظه. تغييره يعيد فحص الجاهزية الضريبية، ويرفضه الخادم ما دامت وحدة فوترة إلكترونية فعّالة أو مسجّلة على بيئة الإنتاج لأن شهادتها تحمل الرقم؛ تقول الصفحة عندئذ إن إيقاف الوحدة يكون بتذكرة من «تواصل مع الدعم». ورقم تحمله منشأة أخرى على أيدي يُرفض أيضًا. |
|---|
| حفظ الهوية الضريبية | يحفظ ما تغيّر فقط في الهوية الضريبية: الاسمين النظاميين والرقم الضريبي ورقم السجل التجاري والعنوان الوطني، مع إصدار سجل المنشأة. يُتحقق من كل حقل قبل الإرسال، ويُحفظ العنوان الوطني كاملًا أو لا يُحفظ. تصل التغييرات إلى نقاط البيع مع مزامنة إعداداتها التالية. |
|---|
| إضافة فرع | يفتح نافذة «إضافة فرع». يظهر للمالك فقط لأن إنشاء الفرع يحتاج admin.*، ويحتسبه الخادم ضمن حد الفروع في خطتك. ويُعطَّل ما دام الحساب للقراءة فقط. |
|---|
| الفرع | قائمة الفروع التي يُحرَّر منها فرع واحد. اختيارها يملأ الاسم والعنوانين، ويحدد أيضًا الفرع الذي يعرض تبويب المستخدمين موظفيه والفرع الذي يُربط به رمز التفعيل. |
|---|
| اسم الفرع | اسم الفرع بلغة الواجهة الحالية. يظهر الاسم الجديد على كل شاشة تعرض هذا الفرع بعد الحفظ. |
|---|
| العنوان (عربي) | عنوان الفرع بالعربية. يُطبع على كل فاتورة مبسطة يصدرها هذا الفرع، ويرفض الخادم إصدار فاتورة بدونه. مسحه كليًا يحذف العنوان المحفوظ. |
|---|
| العنوان (إنجليزي) | عنوان الفرع بالإنجليزية، بالقواعد نفسها. |
|---|
| حفظ الفرع | يحفظ اسم الفرع وعنوانيه مع إصدار سجل الفرع. معطّل حتى يُختار فرع وأثناء الحفظ. |
|---|
نافذة إضافة فرع
| الحقل | المعنى |
|---|
| رمز الفرع | حروف وأرقام لاتينية حتى ٣٢ خانة، يُخزَّن بأحرف كبيرة ولا يمكن تغييره بعد الإنشاء. يرفض الخادم رمزًا يستخدمه فرع آخر. |
|---|
| الاسم (عربي) | ما يظهر في الواجهة العربية والتقارير. مطلوب، حتى ١٦٠ حرفًا. |
|---|
| الاسم (إنجليزي) | ما يظهر في الواجهة الإنجليزية. مطلوب أيضًا، حتى ١٦٠ حرفًا. |
|---|
| العنوان (عربي) والعنوان (إنجليزي) | اختياريان الآن ويمكن إضافتهما لاحقًا من محرّر الفرع. يبدأ الفرع الجديد بسياسة منع المخزون السالب وضريبة ١٥٪ ونقطة بيع تسمّي سطر الضريبة «مشمولة في الأسعار» وطرق دفع نقد ومدى وApple Pay، وكلها تُعدَّل بعد الإنشاء. أما الضريبة في كل بيع فتحددها قاعدة الضريبة لكل صنف. |
|---|
| مراجعة | ينتقل إلى خطوة التأكيد التي تعرض «ما سيُكتب» بالضبط، بما فيه الرمز بأحرف كبيرة كما سيُخزَّن. معطّل حتى تصح كل الحقول. |
|---|
| إنشاء الفرع | يكتب الفرع باسمك في سجل التدقيق ويربط حسابك به فورًا. عند بلوغ حد الخطة يرفض الخادم ويعرض «الفروع النشطة الآن» و«حد خطتك»؛ يظهر الفرع الجديد في دليل الفروع هنا فورًا وفي بقية الشاشات بعد تجديد الجلسة أو إعادة التحميل. |
|---|
المنشأة: إجراءات الأجهزة
| الحقل | المعنى |
|---|
| إجراءات الأجهزة غير متاحة | بطاقة تحل محل لوحتي التفعيل والإبطال لمن لا يملك صلاحية إعدادات نقطة البيع setting-pos. |
|---|
| نقطة البيع (اختيارية) | في «تفعيل جهاز جديد»: قائمة نقاط البيع النشطة في الفرع المختار أعلاه ليُربط الجهاز بإحداها عند التفعيل؛ «بلا نقطة بيع» يترك الربط لاحقًا من العمليات. النقاط التي تحمل جهازًا مُعلَّمة بـ«جهاز مربوط». التلميح تحت الحقل يقول إن كان الفرع غير مختار أو الدليل قيد التحميل أو تعذّر أو فارغًا. |
|---|
| إصدار رمز التفعيل | يُصدر رمزًا صالحًا مرة واحدة ولمدة ٢٤ ساعة يُربط الجهاز بالفرع عند إدخاله. يظهر الرمز في صندوق «أدخله في تطبيق نقطة البيع الآن» ولن يُعرض مرة أخرى. معطّل حتى يُختار فرع. |
|---|
| معرّف الجهاز | في «إبطال جهاز»: المعرّف الكامل للجهاز المراد إبطاله، بخط لاتيني. انسخه من صفحة الأجهزة والطباعة. |
|---|
| الإصدار الحالي | رقم إصدار سجل الجهاز الذي يُرسل مع الإبطال؛ رقم قديم يجعل الخادم يرفض الإبطال. |
|---|
| السبب | سبب الإبطال الذي يُكتب في سجل التدقيق، ثلاثة أحرف على الأقل. القيمة الابتدائية «Device replaced». |
|---|
| إبطال الجهاز | إجراء خطر: ينهي جلسة الجهاز فورًا ولا يمكنه البيع بعد الآن، ولا يمكن التراجع عنه. لتعطيل مؤقت قابل للتراجع استخدم مفتاح «الجهاز مفعّل» في الأجهزة والطباعة. |
|---|
| الملخص | شريط جانبي يعرض اسم المنشأة (شرطة لغير المالك)، وعدد الفروع، وعدد نقاط البيع في الفرع المختار، مع ملاحظة «النطاقات متتالية». |
|---|
المستخدمون والصلاحيات
| الحقل | المعنى |
|---|
| الفرع | قائمة الفرع الذي يُعرض موظفوه. تظهر داخل هذا التبويب لغير المالك فقط، من الفروع المسندة إليه؛ المالك يختار الفرع من تبويب المنشأة. |
|---|
| المستخدمون في هذا الفرع | قائمة السجلات: اسم الموظف، ثم أسماء أدواره، وشارة «نشط» أو «موقوف». «لا يوجد موظفون في هذا الفرع» عندما تعود القائمة فارغة. يُفتح المحرّر على أول موظف حتى تختار غيره. |
|---|
| الدور | أسماء أدوار الموظف المختار كما يعيدها الخادم، أو شرطة بلا دور. الدور يقرر ما يمكن لهذا الشخص فعله ويتحقق الخادم منه في كل طلب. |
|---|
| معرّف المستخدم | أول ثمانية أحرف من معرّف المستخدم، وهو ما يظهر في أعمدة «فتحها» و«المنفّذ» في صفحات أخرى. |
|---|
| عدد الصلاحيات | عدد مفاتيح الصلاحيات الفعلية للموظف المختار بعد حل أدواره. |
|---|
| على وردية | نعم عندما يكون للموظف وردية مفتوحة الآن على أي نقطة بيع، وإلا لا. |
|---|
| تعديل الموظف | يفتح نافذة التعديل بأسماء الموظف وجواله ودوره. لا يمكنك تغيير دورك أنت من هنا. |
|---|
| تعطيل الموظف / تفعيل الموظف | يفتح نافذة تأكيد. التعطيل ينهي جلسات الموظف ويمنع تسجيل دخوله، والتفعيل يعيده. الزر معطّل على حسابك أنت وأنت نشط. |
|---|
| مصفوفة الصلاحيات | جدول صفوفه الصلاحيات (اسمها ومفتاحها) وأعمدته الأدوار، وكل خلية «مسموح» أو «ممنوع» كما يعيدها الخادم؛ الدور الذي يحمل admin.* مسموح له بكل شيء. لا شيء فيها مكتوب في الشاشة، ولا تُحرَّر من هنا. |
|---|
| الملخص | شريط جانبي بعدد الموظفين في الفرع، وعدد الأدوار، وعدد الصلاحيات في اللقطة، مع ملاحظة «الخادم هو المرجع». |
|---|
نافذة إضافة مستخدم / تعديل الموظف
| الحقل | المعنى |
|---|
| الاسم الأول (إنجليزي) واسم العائلة (إنجليزي) | الاسم الإنجليزي مطلوب في الحالتين؛ زر الحفظ معطّل حتى يُكتب الاثنان. |
|---|
| الاسم الأول (عربي) واسم العائلة (عربي) | اختياريان. عند وجودهما يظهر الاسم العربي في الواجهة العربية بدل الإنجليزي. |
|---|
| الجوال | رقم جوال الموظف بخط لاتيني، اختياري. مطلوب فقط عندما يُرسل رمز الدخول برسالة نصية. |
|---|
| الدور | قائمة الأدوار كما يعيدها الخادم. مطلوب عند الإنشاء؛ وعند التعديل يمكن «الاحتفاظ بالأدوار الحالية». القائمة فارغة عند تعديل حسابك أنت. |
|---|
| الفروع | رقائق الفروع التي يُسند إليها المستخدم الجديد؛ عند ترك الكل يُسند إلى الفرع المختار في تبويب المنشأة. تظهر عند الإنشاء فقط، وللمالك فقط لأن قائمة الفروع تحتاج admin.*. |
|---|
| رمز الدخول | رمز الدخول الذي يسجّل به الموظف في نقطة البيع، أربع خانات على الأقل. عند الإنشاء فقط. |
|---|
| إرسال الرمز برسالة نصية | مفتاح يرسل رمز الدخول إلى الجوال المكتوب؛ بلا جوال يُنشأ الموظف وتسلّمه الرمز بنفسك. رسالة النجاح تقول أيهما حدث. |
|---|
| إنشاء الموظف / حفظ التغييرات | يكتب المستخدم على الخادم؛ التغييرات تُسجَّل في سجل التدقيق. إخفاء زر في الواجهة ليس تصريحًا: يعيد الخادم بناء الصلاحيات من قاعدة البيانات في كل طلب. |
|---|
حالات الوصول
| الحقل | المعنى |
|---|
| خارج صلاحيات دورك | تحل محل الصفحة كلها لمن لا يملك أيًا من admin.* أو setting-users أو setting-pos؛ يكفي امتلاك واحدة منها. داخل الصفحة تُعرض الأقسام التي تصلها صلاحيتك فقط. |
|---|
| الخطة | لا تحجب أي خطة هذه الصفحة؛ الإعدادات تشغيلية لا تجارية. |
|---|
| دليل الموظفين غير متاح | حالة خطأ داخل تبويب المستخدمين عندما يرفض الخادم قراءة موظفي هذا الفرع لهذا الحساب. |
|---|