دليل استعمال النقاط الفنية في نقاط البيع

Nama ERP is a web-based system, but its Nama POS module includes a dedicated desktop application for Points of Sale (POS), offering both online and offline capabilities:

POS operates offline using a local POS database.
It automatically syncs with the Nama ERP central database.
Integrates with payment terminals, including an embedded credit-card processor for mobile phones.
POS functionality is available on Android and iOS via the Captain Order mobile app.

Nama POS Pole Display Configuration Using Tempo

POS Pole Display Setup

To configure a pole display for Nama POS, follow these steps:

Go to the "Pos Pole Display Specs" screen.
Set:

Communication Type: e.g., Serial, USB.
Printer Name or Port Number: to define the connection interface.

Link the pole display configuration to a machine by setting the "Pos Pole Display Specs" field in the machine record.

Displaying Data on the Pole Display

Nama POS allows defining template-based messages for different events in the sales process. Templates are configured in the "Pos Pole Display Specs" screen.

Supported Functions

Clear Line:

@CLEARLINE@

Use it to clear one line on the pole display.

Example:

@CLEARLINE@@CLEARLINE@ Welcome

Clears two lines, then displays: Welcome.

Last Modified Line:

{lastModifiedLine}

Use this to get the most recently added invoice line.

Example:

{lastModifiedLine.qty.value}

Gets the quantity of the last added item.

Pole Display Templates

Idle Template

Displayed when the POS is idle, before any invoice is created.

@CLEARLINE@@CLEARLINE@**** Welcome to Register {name2}

Clears both lines and shows a welcome message with the register's name.

Line Adding Template

Displayed when a new item is added to the invoice.

@CLEARLINE@@CLEARLINE@
{padleft(20)}Item: {lastModifiedLine.item.name2}{endpad}
{padleft(20)}Qty: {lastModifiedLine.qty.uom.name2} - {round(lastModifiedLine.qty.value,0)}{endpad}

Shows item name and quantity info, padded for alignment.

Remaining Template

Displayed after the customer pays and change is calculated.

@CLEARLINE@@CLEARLINE@
{padleft(20)}Remaining: {round(change,2)}${endpad}

Displays the remaining change to be returned to the customer.

These templates provide a flexible way to control real-time messaging on POS displays using Tempo syntax.

فلترة البحث في شاشات نقاط البيع باستخدام محددات الماكينة

في نظام نما، يتم تطبيق الفلترة تلقائيًا على محددات الدخول (مثل الشركة، الفرع، القطاع...) في الشاشات العادية. ولكن في نظام نقاط البيع (POS)، لا يتم تطبيق هذه الفلاتر بشكل تلقائي، لأن النظام يعتمد على محددات الجهاز (الماكينة) بدلاً من المستخدم.

لذلك، لتفعيل الفلترة في شاشات البحث داخل نقاط البيع بناءً على محددات الماكينة، يتم استخدام شاشة إعدادات نقاط البيع، وتحديدًا من خلال جدول "فلترة المحددات".

مثال:

لنفترض أنك تريد فلترة المنطقة (المستخدمة في عنوان التوصيل) في فاتورة مبيعات نقاط البيع بحيث تظهر فقط المناطق المرتبطة بفرع الماكينة الحالية:

افتح شاشة إعدادات نقاط البيع.
في جدول "فلترة المحددات":
- أضف سطرًا جديدًا.
- اختر النوع "منطقة" في حقل النوع.
- في حقل "مفلتر في النوع"، اختر "فاتورة مبيعات نقاط البيع".
- فعّل خيار "فلترة بالفرع".
يمكنك أيضًا إنشاء قائمة أنواع تحتوي على "منطقة" وأنواع بيانات أخرى لتطبيق نفس الفلترة عليها.

الخيارات المتاحة للفلترة:

✅ فلترة بالشركة
✅ فلترة بالفرع
✅ فلترة بالقطاع
✅ فلترة بالإدارة
✅ فلترة بالمجموعة التحليلية

تسجيل الدخول باستخدام API Key في نقاط البيع

أضيفت آلية جديدة لتسجيل الدخول إلى نظام نقاط البيع باستخدام مفتاح API بدلاً من اسم المستخدم وكلمة المرور. الهدف من هذه الآلية هو تجنّب تخزين كلمة المرور (حتى وإن كانت مشفّرة) داخل ملفات نقاط البيع، مع ضمان استمرار عمل النقاط حتى بعد تغيير كلمة المرور.

يمكن تفعيل هذه الآلية بطريقتين:

الطريقة الأولى: الإنشاء التلقائي عبر تسجيل الدخول التقليدي

قم بتشغيل نقطة البيع باستخدام اسم المستخدم وكلمة المرور كما هو معتاد.
يقوم النظام تلقائيًا بـ:
- إنشاء ملف APICredentials
  - الكود الخاص بالملف يتضمن معرف المستخدم الذي تم استخدامه.
- حفظ مفتاح API داخل ملف nama.properties.
- عند التشغيل، يبحث النظام أولًا عن ملف APICredentials بالكود المناسب، وإن وُجد يستخدمه بدلاً من إنشاء واحد جديد.

هذه الطريقة تتيح الانتقال السلس إلى تسجيل الدخول بمفتاح API دون الحاجة لأي تعديل يدوي.

الطريقة الثانية: الإنشاء اليدوي

أنشئ ملف APICredentials يدويًا وعيّن فيه المستخدم الذي سيتم تنفيذ العمليات باسمه داخل نقاط البيع (قراءة / كتابة السجلات).
انسخ المفتاح من الملف الناتج.
يمكنك استخدام المفتاح في أحد المواضع التالية:
- إدخاله في نافذة الإعدادات المبدئية بدلاً من اسم المستخدم وكلمة المرور.
- أو وضعه مباشرة في ملف nama.properties الخاص بنقطة البيع:
```
apiKey=dddsbddhbskbsdhdd
```

استخدام API Key يمنحك مرونة وأمانًا أكبر، خصوصًا عند الحاجة لتحديث كلمات المرور أو عند إدارة عدد كبير من نقاط البيع.

طرق متطورة لتغيير عرض أعمدة جدول المبيعات في نظام نقاط البيع

الطريقة اليدوية (السحب والتعديل المباشر)

كيفية الاستخدام:
- يتم سحب حدود الأعمدة يدوياً (مشابه لبرنامج Excel) لتغيير العرض.
- عند تعديل العرض لأول مرة، يحفظ النظام القيم الجديدة تلقائياً في ملف:
  screenProperties.properties
- يمكن نسخ هذا الملف بعد ضبط جميع الحقول كما هو مطلوب.
نشر التعديلات على أجهزة نقاط البيع:
- الخيار الأول: لصق الملف يدوياً في كل جهاز.
- الخيار الثاني: الدخول إلى إعدادات النظام → خصائص أعمدة المبيعات → لصق محتويات الملف → اختيار "إرسال الخصائص إلى أجهزة نقاط البيع" → حفظ.
مميزاتها:
- مرنة وسريعة للتعديلات الأولية.
- تسمح بضبط دقيق حسب احتياجات المستخدم.
عيوبها:
- تتطلب تدخلاً يدوياً في حالة التحديث على عدة أجهزة.

التحكم في العرض عبر إعدادات واجهة نقاط البيع

كيفية الاستخدام:
- في صفحة "إعدادات واجهة نقاط البيع"، تم إضافة عمود جديد باسم "العرض" لكل حقل في جدول المبيعات.
- يمكن تحديد حجم العمود من خلال خيارات محددة مسبقاً (مثل: صغير، صغير جداً، متوسط، كبير، ... إلخ).
- يتم توزيع المساحة تلقائياً بناءً على المقاس المحدد لكل حقل.
متى تُستخدم؟
- عند الرغبة في ضبط العرض بشكل منظم دون الحاجة للسحب اليدوي.
- في حالات التوزيع النسبي للحقول داخل الجدول.
ماذا لو أردت السحب اليدوي مع تفعيل هذه الميزة؟
- يتم ترك حقل "العرض" فارغاً، مما يسمح للمستخدم بتعديل الحجم يدوياً عند التشغيل.
مميزاتها:
- لا تحتاج إلى تعديل يدوي لكل جهاز.
- توفر خيارات محددة مسبقاً لتوحيد الشكل عبر الفروع.
- توزع المساحة تلقائياً بين الحقول.
عيوبها:
- أقل مرونة من الطريقة اليدوية في بعض الحالات الخاصة.