Nama Docs

العربية

English

العربية

English

Appearance

English

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

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:

  1. Go to the "Pos Pole Display Specs" screen.
  2. Set:
  • Communication Type: e.g., Serial, USB.
  • Printer Name or Port Number: to define the connection interface.
  1. 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.

Total Template ​

Displayed when the Tender screen is opened (before payment).

@CLEARLINE@@CLEARLINE@
{padleft(20)}Total: {round(netPrice,2)}${endpad}

Displays the invoice total amount.

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)، لا يتم تطبيق هذه الفلاتر بشكل تلقائي، لأن النظام يعتمد على محددات الجهاز (الماكينة) بدلاً من المستخدم.

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

مثال: ​

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

  1. افتح شاشة إعدادات نقاط البيع.

  2. في جدول "فلترة المحددات":

    • أضف سطرًا جديدًا.
    • اختر النوع "منطقة" في حقل النوع.
    • في حقل "مفلتر في النوع"، اختر "فاتورة مبيعات نقاط البيع".
    • فعّل خيار "فلترة بالفرع".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • كيفية الاستخدام:

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

  • نشر التعديلات على أجهزة نقاط البيع:

    • الخيار الأول: لصق الملف يدوياً في كل جهاز.
    • الخيار الثاني: الدخول إلى إعدادات النظام ← خصائص أعمدة المبيعات ← لصق محتويات الملف ← اختيار "إرسال الخصائص إلى أجهزة نقاط البيع" ← حفظ.

  • مميزاتها:

    • مرنة وسريعة للتعديلات الأولية.
    • تسمح بضبط دقيق حسب احتياجات المستخدم.

  • عيوبها:

    • تتطلب تدخلاً يدوياً في حالة التحديث على عدة أجهزة.

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

  • كيفية الاستخدام:

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

  • متى تُستخدم؟

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

  • ماذا لو أردت السحب اليدوي مع تفعيل هذه الميزة؟

    • يتم ترك حقل "العرض" فارغاً، مما يسمح للمستخدم بتعديل الحجم يدوياً عند التشغيل.

  • مميزاتها:

    • لا تحتاج إلى تعديل يدوي لكل جهاز.
    • توفر خيارات محددة مسبقاً لتوحيد الشكل عبر الفروع.
    • توزع المساحة تلقائياً بين الحقول.

  • عيوبها:

    • أقل مرونة من الطريقة اليدوية في بعض الحالات الخاصة.

مركز الاتصال وإضافات الأصناف ​

انتقل هذان الموضوعان إلى الدليل التشغيلي:

إعادة تعيين عداد محاولات الإرسال للمستندات غير المرسلة ​

عندما تفشل مستندات نقاط البيع في الإرسال إلى الخادم، يقوم النظام بزيادة عداد المحاولات الفاشلة (writeFailures). بعد 25 محاولة فاشلة (القيمة الافتراضية)، يتوقف النظام عن محاولة إرسال المستند.

لإعادة تعيين العداد والسماح للنظام بمحاولة الإرسال مرة أخرى، قم بتنفيذ الاستعلام التالي على قاعدة بيانات نقاط البيع:

sql
UPDATE POSSalesInvoice SET writeFailures = 0 WHERE sent = 0;
UPDATE POSSalesReturn SET writeFailures = 0 WHERE sent = 0;
UPDATE POSSalesReplacement SET writeFailures = 0 WHERE sent = 0;
UPDATE POSPaymentToRegistery SET writeFailures = 0 WHERE sent = 0;
UPDATE POSReceiptFromRegistery SET writeFailures = 0 WHERE sent = 0;
UPDATE POSShiftOpen SET writeFailures = 0 WHERE sent = 0;
UPDATE POSShiftClose SET writeFailures = 0 WHERE sent = 0;
UPDATE POSCustomer SET writeFailures = 0 WHERE sent = 0;
UPDATE POSStockTransferReq SET writeFailures = 0 WHERE sent = 0;
UPDATE POSOrderReservation SET writeFailures = 0 WHERE sent = 0;
UPDATE POSCreditNote SET writeFailures = 0 WHERE sent = 0;
UPDATE POSDiscountCoupon SET writeFailures = 0 WHERE sent = 0;
UPDATE POSStockTakingDetailsDoc SET writeFailures = 0 WHERE sent = 0;
UPDATE POSStockReceipt SET writeFailures = 0 WHERE sent = 0;
UPDATE POSScrapDoc SET writeFailures = 0 WHERE sent = 0;
UPDATE POSShortfallsDoc SET writeFailures = 0 WHERE sent = 0;
UPDATE POSError SET writeFailures = 0 WHERE sent = 0;
UPDATE POSInternalMessage SET writeFailures = 0 WHERE sent = 0;
UPDATE POSInventory SET writeFailures = 0 WHERE sent = 0;

WARNING

تأكد من حل المشكلة الأساسية التي تسببت في فشل الإرسال (مثل مشاكل الشبكة أو إعدادات الخادم) قبل تنفيذ هذا الاستعلام.

تسجيل الدخول بالبصمة ​

يدعم نظام نقاط البيع تسجيل الدخول باستخدام بصمة الإصبع عبر جهاز Digital Persona URU4500، مما يتيح تبديل المستخدمين بسرعة وأمان دون الحاجة لكتابة بيانات الدخول في كل مرة.

للاطلاع على التفاصيل الكاملة: تسجيل الدخول بالبصمة في نقاط البيع