نقاط البيع وأمين الصندوق

نقاط البيع تجربة أمين صندوق مستقلة للأجهزة اللوحية وأجهزة Windows في وضع الكiosk. يبيع أمناء الصندوق ويُرجعون ويُعلّقون السلات ويقسّمون المدفوعات ويطبعون الإيصالات ويغلقون تقارير Z دون المرور بواجهة ERP الكاملة.

العملاء

العميل	ملاحظات
Android / iOS	مسح باركود بالكاميرا + HID عبر USB/Bluetooth
سطح مكتب Windows	طابعات حرارية LAN وماسحات HID وواجهة أمين صندوق في شريط المهام

المسارات (الجوال): /business/:businessId/pos و/business/:businessId/pos/settings.

تدفق أمين الصندوق

1. اختر المنتجات من تبويبات الفئات أو البحث أو المسح أو إدخال HID.
2. عدّل الكميات وخصومات البند/الفاتورة في السلة.
3. اختر عميلاً عابراً أو عميلاً مسجّلاً.
4. قسّم المدفوعات عبر طرق الدفع.
5. ادفع واطبع يحفظ بيعاً دائماً في صندوق الصادر (client_sale_id)، يرحّله للواجهة البرمجية عند الاتصال، ثم يطبع ويفتح الدرج.
6. تعليق / استرجاع يُعلّق ويستعيد السلات؛ تقرير Z يجمع حسب الطريقة ويقارن النقد المتوقع بالمحسوب.

الأجهزة

اضبطها تحت إعدادات أجهزة نقاط البيع:

• طابعة الإيصال — يُفضّل LAN ESC/POS على host:9100؛ Windows يمكنه أيضاً استخدام طابعات RAW USB المثبتة.
• درج النقد — نبضة فتح عبر نقل الطابعة بعد ادفع واطبع.
• ماسح الباركود — HID لوحة مفاتيح (كل المنصات) أو الكاميرا (الجوال).
• الميزان / شاشة العميل / طرفية البطاقة — نقاط التكامل موجودة؛ الميزان والطرفية يدويان حالياً.

استخدم اختبار الطباعة قبل التشغيل على المحطة.

السلوك دون اتصال

مبيعات نقاط البيع وإغلاق تقارير Z تُدرج في sync_outbox في Drift. client_sale_id المشترك يبقي إعادة المحاولات غير متكررة. المبيعات المُرحَّلة تنعكس في الفواتير المحلية ليبقى مساحة الفواتير متسقة أثناء المزامنة.

على Windows، تصغير نافذة أمين الصندوق يبقي مؤقّت المزامنة في الخلفية؛ اترك عملية شريط المهام تعمل على المحطة.

ذات صلة

• المزامنة دون اتصال
• المبيعات
• شرح مفصّل في المستودع: docs/pos-mobile.md