إعداد طابعة الإيصالات: دليل الاتصال وطباعة الطلبات

RestaurantManage Print Agent هو خدمة Windows خفيفة تستقبل أوامر الطباعة من السحابة وترسلها إلى طابعة الإيصالات الحرارية — مما يتيح الطباعة التلقائية للإيصالات عند دفع الطلبات أو عند الحاجة لطباعة تذاكر المطبخ. يدعم الوكيل طابعات الشبكة (منفذ TCP 9100) وطابعات USB واتصالات Windows Spooler. يغطي هذا الدليل التثبيت والتهيئة واتصال الطابعة واستكشاف الأخطاء وإصلاحها.

كيف تعمل طباعة الإيصالات؟

سير عمل الطباعة مؤتمت بالكامل. عندما يؤكد الكاشير الدفع أو تُشغَّل تذكرة مطبخ، يُنشئ الخادم الخلفي لـ RestaurantManage الإيصال الكامل كأوامر بايت ESC/POS — بما في ذلك اسم المطعم ورقم الطاولة والطلب المفصل والأسعار وتفاصيل الضريبة والإجمالي وطريقة الدفع. تُرسل هذه البايتات عبر اتصال WebSocket آمن (PrintHub) إلى Print Agent الذي يعمل على جهاز كمبيوتر يعمل بنظام Windows في مطعمك. يفك الوكيل تشفير البيانات ويرسلها مباشرة إلى الطابعة الحرارية المتصلة. تستغرق العملية بأكملها أقل من ثانيتين من تأكيد الدفع إلى الإيصال المطبوع.

كيف أثبّت Print Agent؟

1. حمّل: احصل على أحدث مثبّت Print Agent من لوحة الإدارة أو تواصل مع الدعم.
2. ثبّت: شغّل المثبّت على جهاز كمبيوتر يعمل بنظام Windows سيبقى مشغّلًا خلال ساعات الخدمة.
3. هيّئ: افتح config.json وأدخل عنوان URL الأساسي لـ API ومعرّف المطعم ومفتاح سر الوكيل (الذي يوفره مديرك).
4. اربط الطابعة: قم بتوصيل طابعتك الحرارية عبر USB أو اربطها بالشبكة نفسها للجهاز الكمبيوتر.
5. شغّل الخدمة: شغّل Print Agent — يتصل تلقائيًا بـ PrintHub ويعرض مؤشر حالة أخضر.
6. طباعة تجريبية: عالج دفعة تجريبية من لوحة الكاشير وتحقق من طباعة الإيصال بشكل صحيح.

ما أنواع اتصال الطابعة المدعومة؟

يدعم Print Agent ثلاث طرق اتصال مع التبديل التلقائي بينها. تتصل طابعات الشبكة عبر TCP على المنفذ 9100 — أدخل عنوان IP الطابعة في التهيئة. هذه هي الطريقة الموصى بها للمطاعم التي تمتلك طابعات متعددة. تتصل طابعات USB مباشرة بالكمبيوتر ويتم الوصول إليها عبر Windows Spooler أو عنونة منفذ USB المباشرة. يستخدم Windows Spooler برنامج تشغيل الطباعة القياسي لنظام Windows، والذي يعمل مع أي طابعة يتعرف عليها Windows. يجرب الوكيل Spooler أولًا، ثم يعود إلى USB المباشر، وأخيرًا يحاول مشاركات شبكة UNC.

كيف أهيئ Print Agent؟

يحتوي ملف config.json على ثلاثة إعدادات مطلوبة: ApiBaseUrl (عنوان URL لخادم RestaurantManage)، وRestaurantId (المعرف الفريد لمطعمك من لوحة الإدارة)، وAgentSecretKey (مفتاح سر يُنشأ في لوحة الإدارة يصادق وكيل الطباعة دون الحاجة لحساب مستخدم). يصادق الوكيل مع PrintHub باستخدام هذا المفتاح السري عبر WebSocket. لطابعات الشبكة، أضف IP الطابعة والمنفذ إلى التهيئة. يسجّل الوكيل جميع النشاطات في مجلد logs/ لاستكشاف الأخطاء.

كيف يعمل التحديث التلقائي؟

يتحقق Print Agent من التحديثات تقريبًا كل 2.5 ساعة عبر استدعاء نقطة نهاية التحديث على خادم RestaurantManage. إذا كان إصدار جديد متاحًا، يُنزّل حزمة التحديث كملف ZIP إلى مجلد التحديثات المعلقة، ويُشغّل نص التثبيت، ويُعيد تشغيل الخدمة تلقائيًا. هذا يعني أن مطعمك يعمل دائمًا بأحدث إصدار دون تدخل يدوي. تتضمن عمليات فحص التحديث تأخيرًا زمنيًا لكل مطعم لتجنب تحديث جميع الوكلاء في وقت واحد. يمكنك رؤية إصدار الوكيل الحالي في لوحة الإدارة.

استكشاف المشكلات الشائعة وإصلاحها

• الوكيل لا يتصل: تحقق من صحة ApiBaseUrl وAgentSecretKey في config.json. تحقق من الوصول للإنترنت على الكمبيوتر.
• الإيصال لا يُطبع: تأكد من تشغيل الطابعة وتوصيلها. تحقق من مجلد logs/ للحصول على تفاصيل الخطأ.
• نص مشوه على الإيصال: تأكد من أن طابعتك تدعم أوامر ESC/POS. معظم الطابعات الحرارية 80 ملم متوافقة.
• انقطاع الاتصال بشكل متكرر: يعيد الوكيل الاتصال تلقائيًا، لكن تحقق من استقرار شبكتك. اتصال Ethernet السلكي أكثر موثوقية من Wi-Fi.
• الوكيل لا يبدأ كخدمة: شغّل install-service.bat كمسؤول لتسجيل خدمة Windows بشكل صحيح.

أدلة ذات صلة

• لوحة الكاشير: كيفية معالجة المدفوعات التي تُشغّل طباعة الإيصالات
• شاشة المطبخ: كيف تتكامل طباعة تذاكر المطبخ مع تدفق الطلبات
• البدء السريع: دليل الإعداد الكامل من التسجيل إلى أول طلب