الإعدادات

الإعدادات، في مجموعة الإعداد، تغيّر ما تفعله نقاط البيع والإيصالات والمتجر الإلكتروني. لا يتغيّر شيء حتى تختار نشر التغييرات، فتُكتب نسخة على النطاق الذي اخترته، ثم تؤكد كل نقطة بيع ما طبّقته.

من يمكنه استخدام هذه الصفحة

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

قبل البدء

• اعرف الفرع الذي تعمل فيه؛ هذا الفرع يعني فرع هذا الجهاز.
• كن متصلًا؛ لا تُنشر الإعدادات دون اتصال.

ما الذي تضمّه مجموعة الإعداد

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

مجموعات الإعدادات

إحدى عشرة مجموعة، لكل منها سطر يقول ما الذي تغيّره:

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

اختيار النطاق

لكل مجموعة تنطبق على: المنشأة كاملة أو هذا الفرع أو جهاز واحد أو نقطة واحدة. النطاق الأضيق يغلب: الفرع يتجاوز المنشأة، والجهاز يتجاوز الفرع، ونقطة البيع تتجاوز الجهاز. وحين تختار نطاقًا تعرض الحقول قيم ذلك النطاق نفسه، فيبدأ ما تنشره مما يستخدمه ذلك النطاق فعلًا.

• بيانات المنشأة واللغة والوقت وساعات العمل والمدفوعات وقواعد البيع والخصائص ومتقدم لا توجد إلا للمنشأة كاملة وللفرع. وعلى جهاز واحد أو نقطة واحدة يقول الشريط «لا تُضبط هذه الإعدادات على هذا النطاق، فالنشر متوقف. اختر نطاقًا آخر.»
• ينتهي اليوم عند ومتى تصل التذاكر إلى المطبخ للفرع، والدفع باللمس للمنشأة أو الفرع. ونشرها على نطاق آخر يُرفض: «أحد هذه الإعدادات لا يُضبط على هذا النطاق، فلم يُنشر شيء. اختر نطاقًا آخر أو تجاهل التغيير.»
• صفحة البيع لا توجد إلا لكل نقطة بيع على حدة.
• يبدأ التطبيق يأخذ تاريخًا ووقتًا اختياريين للنسخة؛ وتركه فارغًا يعني فورًا.

النشر والتجاهل والتعارض

يعدّ الشريط في الأسفل تغييراتك («N تغييراً غير منشور»)، ويذكر أي مشكلة تمنع النشر، ويعرض expected_version الذي سيرسله. نشر التغييرات يكتب نسخة واحدة بالإعدادات المتغيّرة فقط ويجيب «نُشرت النسخة.»؛ ويمكنك النشر مرة أخرى فورًا. وتجاهل يعيد كل حقل إلى القيمة المنشورة: «عودة إلى الإعدادات المنشورة.»

إذا نشر شخص نسخة أحدث بينما كانت صفحتك مفتوحة — على جهاز آخر أو في لوحة معلومات التاجر — يُرفض النشر بـ«نُشرت نسخة أحدث بينما كانت هذه الصفحة مفتوحة. أعد التحميل قبل الكتابة مرة أخرى.» مع إجراء إعادة التحميل. لم يُنشر شيء مما غيّرته؛ أعد التحميل وطبّق تغييرك من جديد ثم انشر.

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

بيانات المنشأة: الشعار والهوية النظامية

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

التوفّر

تغيير الرقم الضريبي يعيد فحص الجاهزية الضريبية، ويُرفض ما دامت وحدة فوترة إلكترونية فعّالة أو في بيئة الإنتاج، لأن شهادة الوحدة تحمل الرقم. والعملة الريال السعودي، وهي العملة الوحيدة التي يسوّي بها أيدي اليوم.

شعار المنشأة

**بيانات المنشأة**: الملاحظة التي تقول إن هذه البيانات سجل منشأتك وتُعدَّل من لوحة معلومات التاجر، وقسم **شعار المنشأة** مع **اختر ملفاً**، ثم الأسماء التجارية والاسمان النظاميان في مربعات متقطعة الإطار عليها **للقراءة فقط**.

يظهر الشعار في رأس الإيصال على شاشة نقطة البيع، وفي الشريط العلوي للوحة معلومات التاجر، وفي متجرك الإلكتروني؛ ومن دونه يُستخدم اسم المنشأة.

1. تحت شعار المنشأة، أفلت ملف PNG أو JPEG أو WebP أصغر من ٢ ميغابايت (يُنصح بـ٥١٢ × ٥١٢ بكسل على الأقل)، أو اختر اختر ملفاً.
2. انتظر حتى يرفع التطبيق الملف ويفحصه أيدي ويجهّز مقاساته. ثم تقول الشاشة «حُفظ الشعار. تستخدمه الفواتير الجديدة ومتجرك الإلكتروني.»، أو تعرض رُفضت الصورة مع السبب.
3. لإزالته اختر إزالة وأكّد. وتعود الإيصالات إلى اسم المنشأة.

يُحفظ الشعار وحده؛ وليس جزءًا من شريط النشر. وتُرفض صور SVG والصور المتحركة، والملفات الأكبر من ٢ ميغابايت أو التي يزيد أحد ضلعيها على ٤٠٩٦ بكسل.

التوفّر

رفع الشعار يحتاج مخزن الوسائط في أيدي. والنشر الذي لا يملكه يقول «رفع الشعار متوقف في هذا النشر.»؛ وإعدادات الإنتاج تُبقي الرفع متوقفًا حتى يجهز المخزن وشبكة توصيل الصور وعامل الوسائط. ولا يُطبع الشعار على الإيصالات المطبوعة بعد.

اللغة والوقت: اليوم التجاري

• اللغة الافتراضية هي اللغة التي تبدأ بها نقطة البيع عند التشغيل حتى يبدّلها أحد؛ لا تتجاوز اختيار الشخص أبدًا، والنشر لا يبدّل لغة نقطة بيع تعمل. وتُطبع الإيصالات باللغتين.
• المنطقة الزمنية، مثل Asia/Riyadh، هي ما تتبعه التقارير والورديات، لا ساعة الجهاز. وهي مطلوبة: إذا تُركت فارغة يقول الشريط «المنطقة الزمنية مطلوبة.» ولا يُنشر شيء.
• ينتهي اليوم عند وقت نهاية اليوم بصيغة HH:MM: «وقت الفصل يحدد ليوم أي عملية متأخرة تُحسب. فعملية الساعة ١:٣٠ مع فصل ٤:٠٠ تُحسب على الأمس.» والوقت خارج 00:00–23:59 يقول «استخدم HH:MM بين ٠٠:٠٠ و٢٣:٥٩.»

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

ساعات العمل

**ساعات العمل** على **هذا الفرع**: الملاحظة التي تقول إن نقاط البيع تبقى قابلة للاستخدام خارج هذه الساعات، ووقت فتح ووقت إغلاق لكل يوم، والجمعة على **مغلق** وتقول **مغلق طوال اليوم**.

1. اختر ساعات العمل على هذا الفرع.
2. لكل يوم اكتب وقتي الفتح والإغلاق بصيغة HH:MM. ووقت الإغلاق الأبكر من وقت الفتح يمتد بعد منتصف الليل إلى اليوم التالي.
3. لليوم الذي لا يفتح فيه الفرع اختر مغلق: يقول الصف مغلق طوال اليوم. واختيار مغلق مرة أخرى يعيد فتح اليوم بأوقات فارغة لتملأها.
4. اختر نشر التغييرات.

النتيجة المتوقعة

«نُشرت النسخة.» وخارج الساعات تعرض شاشة الكاشير ونظرة عامة على المبيعات خارج ساعات العمل مع موعد الفتح التالي، وتواصل نقطة البيع البيع؛ أما المتجر الإلكتروني فيرفض إتمام الطلب ويخبر العميل متى يفتح. والوقت غير المكتوب بصيغة HH:MM يمنع النشر: «تُكتب ساعات العمل بصيغة HH:MM.»

المدفوعات

تعرض الطرق التي تقبلها نقاط البيع ست طرق بأسمائها — cash وmada وapple_pay وvisa وmastercard وstc_pay — وعدد المفعّل منها. ويجب أن تبقى طريقة واحدة مفعّلة على الأقل. وإيقاف طريقة يوقف عرضها في كل نقاط بيع الفرع عند استعلامها التالي؛ ولا يستطيع جهاز أن يوسّع ذلك بنفسه أبدًا. وفي نقطة البيع، mada وvisa وmastercard وapple_pay مسار بطاقة واحد: تبقى بطاقة مدى ما دام أي منها مفعّلًا. ولا مسار لـstc_pay في نقطة البيع بعد. راجع الدفع والإيصال.

قواعد البيع

**قواعد البيع**: **الأسعار تشمل الضريبة** على **شاملة**، و**البيع دون إنترنت** على **مسموح**، ولكل منهما السطر الذي يقول ما الذي يغيّره.

• الأسعار تشمل الضريبة — شاملة أو تُضاف عند الدفع — يسمّي سطر الضريبة في شاشة الكاشير قبل إضافة أي صنف: ضريبة القيمة المضافة · ١٥٪ · مشمولة في الأسعار أو تُضاف إلى الأسعار. ولا يسعّر شيئًا: قاعدة الضريبة لكل صنف هي التي تحدد الضريبة، في نقطة البيع وعلى الخادم.
• البيع دون إنترنت — مسموح أو ممنوع. لا تبيع نقطة البيع دون اتصال إلا ما دام هذا المفتاح والخصائص، البيع دون اتصال يسمحان كلاهما. راجع المبيعات دون اتصال والمزامنة.

صور الأصناف في صفحة البيع

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

1. افتح صفحة البيع. يقول النطاق نقطة واحدة.
2. تحت نقطة البيع اختر نقطة البيع. والنقطة التي تعمل عليها مُعلَّمة بـ«نقطة البيع هذه».
3. فعّل عرض صور الأصناف في صفحة البيع أو أوقفه، ثم اختر نشر التغييرات.

**صفحة البيع** لنقطة البيع **Till 2**: مفتاح **عرض صور الأصناف في صفحة البيع** مفعّل، و**نشر التغييرات** في التذييل، وقائمة الأجهزة تبيّن أي نقاط البيع طبّقت الإعدادات. رسمتها واجهة نقطة البيع ببيانات تجريبية، بحجم `1366 × 768`.

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

التوفّر

إعدادات نقطة البيع الواحدة تحتاج مفتاحًا على الخادم تُبقيه إعدادات الإنتاج متوقفًا حاليًا. وحتى يُفعّل تقول صفحة البيع «لا يمكن تغيير إعدادات نقاط البيع على هذا الخادم حاليًا. تحتفظ نقطة البيع بقيمتها الحالية.»، وتبقى كل نقطة بيع على الافتراضي: صور الأصناف ظاهرة.

الخصائص

قائمة QR على الطاولة والبيع دون اتصال وإرسال السطور للمطبخ مفاتيح تحملها باقتك أصلًا؛ وإيقاف أحدها يخفيه في كل مكان، ومنه نقاط البيع المربوطة. ومتى تصل التذاكر إلى المطبخ، على هذا الفرع فقط، يختار حسب القطاع أو عند تسجيل الطلب أو عند دفع الطلب. راجع محطات المطبخ وشاشة المطبخ.

الأجهزة والطباعة والدفع باللمس

• في الأجهزة سبعة مفاتيح، كل منها متصل أو غير موصول: فعّل ما هو موصول فعلًا. ونقطة البيع التي ينقصها الجهاز تُبلغ عن ذلك بدل تطبيق الإعداد. ومع عرض أسماء الواجهة يظهر adapter_id وendpoint_id تحت كل مفتاح؛ والجهاز المفعّل يجب أن يذكر adapter_id، وإلا يُرفض النشر.
• تضبط الطباعة والإيصالات تُطبع إيصالات العملاء على وتُطبع تذاكر المطبخ على وتُطبع الملصقات على؛ والمستند المتروك فارغًا لا يُطبع. وفيها أيضًا الطباعة تلقائياً وطلب سبب لإعادة الطباعة.
• في الدفع باللمس قبول الدفع دون تلامس على الجهاز وأعلى مبلغ دون تلامس، بالريال وثلاث خانات عشرية مثل 300.000. ويحتاج شهادة على الجهاز قبل استخدامه.

التوفّر

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

متقدم

ملف الضريبة وسياسة الإيصال للقراءة فقط وفارغان: «محجوزة: لا يوجد بعدُ ملف ضريبي أو سياسة إيصال تشير إليهما، فتبقيان فارغتين ويُرفض أي قيمة.»

إعداد الطباعة: البحث عن الطابعات وإضافتها وتوجيهها

1. افتح إعداد الطباعة واختر المسار: طابعة حرارية أو طابعة النظام.
2. تحت المستندات اختر إيصال العميل أو تذكرة المطبخ أو ملصق الرف.
3. اختر البحث عن طابعات. البحث الحراري يعرض طابعات USB وBluetooth والشبكة كلما أجابت؛ وبحث النظام يعرض الطابعات المعرّفة في نظام التشغيل.
4. إذا لم تظهر طابعة، استخدم إضافة طابعة بالعنوان: اسم الطابعة والعنوان — tcp://host:port للطابعة الحرارية الشبكية، أو system:// متبوعًا باسم الطابعة.
5. اختر حفظ للفرع لتبقى الطابعة بين طابعات هذا الفرع، ثم استخدمها لهذا المستند عليها. ويوقف مسح المسار طباعة المستند عليها.
6. اختر حفظ إعدادات الطباعة.

النتيجة المتوقعة

«نُشر التوجيه وخيارات الإيصال كنسخة إعدادات أجهزة.» وتطبّقها نقاط البيع بعد أن تؤكدها. وحفظ طباعة الشعار وحده لا يستبدل محوّل طابعة الإيصالات أبدًا.

التوفّر

يمكن اكتشاف طابعات USB وBluetooth الحرارية وحفظها وتوجيهها، لكن لا تطبع في هذا الإصدار عبر المسار المحلي إلا الطابعات الحرارية الشبكية (tcp://). وطباعة الشعار يُحفظ، لكن لا يطبع أي من المسارين صورة بعد. ولم تُجرَّب طابعة فعلية أثناء إعداد هذا الدليل.

الفروع ونقاط البيع والأجهزة تُنشأ في لوحة معلومات التاجر

لا ينشئ المكتب الخلفي فرعًا ولا نقطة بيع. يُضاف الفرع في لوحة معلومات التاجر من الإعدادات، الإدارة، المنشأة، إضافة فرع؛ ونقطة البيع من المخزون والمشتريات، أجهزة البيع، إضافة نقطة بيع؛ ومن هناك أيضًا يُربط الجهاز المقترن بنقطة بيع. ويُصدر المكتب الخلفي رموز التنشيط، ويعيد تسمية الأجهزة ويبطلها؛ راجع الأجهزة والنشر.

إذا لم تنجح الخطوات

• إذا بقي نشر التغييرات متوقفًا، فاقرأ المشكلة المذكورة في الشريط؛ وأكثرها شيوعًا نطاق لا تحمله المجموعة.
• إذا قال النشر إن شخصًا نشر نسخة أحدث، فاختر إعادة التحميل وطبّق تغييرك من جديد.
• إذا لم تطبّق نقطة بيع تغييرًا، فراجع ما طبّقته أجهزتك؛ والنقطة التي تنتظر الاستعلام تطبّقه خلال دقيقة تقريبًا.
• إذا قال قسم هذا القسم غير متاح، فتحقق من الاتصال واختر إعادة المحاولة؛ لم يتغيّر شيء.

صفحات مرتبطة

• الأجهزة والنشر
• الفوترة والهيئة
• الورديات واليوم التجاري وساعات العمل
• المبيعات دون اتصال والمزامنة