# الطباعة السحابية

تتيح الطباعة السحابية لـ WCPOS إرسال الإيصالات إلى طابعة غير متصلة مباشرةً بالجهاز الذي يشغّل نقطة البيع. اضبطها مرة واحدة في WP Admin، فتُطبع طلباتك على طابعة المطبخ، أو طابعة المكتب الخلفي، أو طابعة في غرفة أخرى — دون أن يحتاج كل جهاز إلى اكتشاف الجهاز والاقتران به بنفسه.

## ما هي الطباعة السحابية؟[​](#what-is-cloud-printing "رابط مباشر إلى ما هي الطباعة السحابية؟")

مع **الطباعة المحلية**، يتواصل الجهاز الذي يشغّل نقطة البيع مباشرةً مع الطابعة عبر USB أو Bluetooth أو الشبكة المحلية. هذا هو الخيار الصحيح عندما تكون الطابعة بجوار نقطة البيع — راجع [إعداد الطابعة](/ar/hardware/printers.md) لتوصيل طابعات USB وBluetooth وطابعات الشبكة على الجهاز نفسه.

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

* **طابعات الاستطلاع (Polling).** تتواصل الطابعة مع WCPOS عبر الإنترنت وفق جدول زمني، وتسأل "هل لديك شيء من أجلي؟"، ثم تسحب أي مهام منتظِرة. لا يتصل WCPOS بالطابعة أبدًا — الطابعة هي التي تبدأ المحادثة دائمًا. هكذا تعمل **Star CloudPRNT** و**Epson Server Direct Print**.
* **مزوّدو التتابع المستضاف (Hosted relay).** يرسل WCPOS مهمة الطباعة إلى خدمة مستضافة، وتقوم تلك الخدمة بتسليمها إلى الطابعة. هكذا تعمل **Star Online** و**PrintNode**. تسلّم Star Online إلى طابعات Star CloudPRNT المسجَّلة في حساب stario.online الخاص بك؛ وتسلّم PrintNode عبر تطبيق سطح المكتب الخاص بها إلى أي طابعة تقريبًا يستطيع ذلك الحاسوب الطباعة عليها بالفعل.

لماذا طابعة تستطلع؟

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

## اختيار مزوّد[​](#providers "رابط مباشر إلى اختيار مزوّد")

اختر المزوّد الذي يطابق أجهزتك.

#### Star CloudPRNT

لطابعات Star الحرارية التي تعمل ببرنامج **CloudPRNT** الثابت. تستطلع الطابعة WCPOS وتسحب المهام. تُحوَّل الإيصالات إلى أوامر الطابعة الأصلية. تتطلّب قالبًا حراريًا.

#### Star Online

لطابعات Star المسجَّلة في حساب **stario.online**. يرسل WCPOS ترميز Star Document Markup إلى خدمة Star المستضافة، وتجمعه الطابعة من Star Online. تتطلّب قالبًا حراريًا.

#### Epson Server Direct Print

لطابعات Epson ePOS التي تدعم **Server Direct Print**. تستطلع الطابعة WCPOS وتسحب المهام بصيغة ePOS-Print XML. تتطلّب قالبًا حراريًا.

#### PrintNode

تعمل مع أي طابعة تقريبًا يستطيع حاسوبك الطباعة عليها، على أي نظام تشغيل، عبر **تطبيق سطح المكتب PrintNode**. يرسل WCPOS ملف PDF، فيمكنك استخدام أي قالب — بما في ذلك فواتير HTML بصفحة كاملة.

| المزوّد                       | الأجهزة                                        | كيف تتدفق المهام                                      | القوالب    |
| ----------------------------- | ---------------------------------------------- | ----------------------------------------------------- | ---------- |
| **Star CloudPRNT**            | طابعة Star حرارية ببرنامج CloudPRNT الثابت     | تستطلع الطابعة WCPOS                                  | حرارية فقط |
| **Star Online**               | طابعة Star مسجَّلة في stario.online            | يرسل WCPOS ترميز Star Document Markup إلى Star Online | حرارية فقط |
| **Epson Server Direct Print** | طابعة Epson ePOS بميزة Server Direct Print     | تستطلع الطابعة WCPOS                                  | حرارية فقط |
| **PrintNode**                 | أي طابعة متصلة بنظام التشغيل + تطبيق PrintNode | يرسل WCPOS ملف PDF إلى PrintNode                      | أي قالب    |

## إعداد طابعة سحابية[​](#setup "رابط مباشر إلى إعداد طابعة سحابية")

تُهيّأ الطابعات السحابية مرة واحدة في WP Admin وتُشارَك عبر كل جهاز — على عكس الطابعات المحلية التي تُخزَّن لكل جهاز على حدة.

انتقل إلى **WP Admin > POS > Settings > Cloud Print** وانقر **Add printer**. امنحها **اسمًا** (على سبيل المثال "المطبخ" أو "المكتب الخلفي"). يشتق WCPOS **معرّف طابعة** ثابتًا من الطابعة تلقائيًا — لا يتغيّر أبدًا، لذا من الآمن الإشارة إليه من تهيئة برنامج الطابعة الثابت.

بعد إنشاء الطابعة، هيّئ طرف المزوّد.

### Star أو Epson (طابعات الاستطلاع)[​](#setup-polling "رابط مباشر إلى Star أو Epson (طابعات الاستطلاع)")

1

#### أضف الطابعة في WCPOS

في **WP Admin > POS > Settings > Cloud Print**، أضف طابعة واختر **Star CloudPRNT** أو **Epson Server Direct Print** كمزوّد. يُنشئ WCPOS **عنوان استطلاع (poll URL)** و**رمزًا لمرة واحدة (token)** لتلك الطابعة.

2

#### انسخ عنوان الاستطلاع والرمز

انسخ عنوان الاستطلاع والرمز المُنشأين. يُعرض **الرمز مرة واحدة فقط** — إذا فقدته، أعد إنشاء رمز جديد من بطاقة الطابعة وحدّث الطابعة بالقيمة الجديدة.

3

#### أدخلهما في تهيئة الطابعة

افتح صفحة تهيئة الطابعة — إعدادات **CloudPRNT** لطابعة Star، أو إعدادات **Server Direct Print** لطابعة Epson — والصق عنوان الاستطلاع والرمز. اضبط فترة الاستطلاع إذا طلبت الطابعة ذلك (بضع ثوانٍ نموذجية). احفظ وأعد تشغيل الطابعة إذا لزم الأمر.

خلال دورة استطلاع واحدة، تسجّل الطابعة دخولها، وتتغيّر حالتها في WCPOS من **في الانتظار (Waiting)** إلى **متصلة (Connected)**.

### PrintNode[​](#setup-printnode "رابط مباشر إلى PrintNode")

1

#### ثبّت تطبيق سطح المكتب PrintNode

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

2

#### احصل على مفتاح API الخاص بـ PrintNode

في حساب PrintNode الخاص بك، أنشئ **مفتاح API**. هذا ما يسمح لـ WCPOS بإرسال المهام إلى حساب PrintNode الخاص بك.

3

#### أدخل مفتاح API في WCPOS

أضف طابعة في **WP Admin > POS > Settings > Cloud Print**، واختر **PrintNode** كمزوّد، والصق مفتاح API. يستخدمه WCPOS لجلب قائمة الطابعات المسجَّلة في حساب PrintNode الخاص بك.

4

#### حدّد الطابعة

اختر الطابعة المستهدفة من قائمة الطابعات التي يبلّغ عنها تطبيق PrintNode، ثم احفظ. سيرسل WCPOS مهام هذه الطابعة إلى PrintNode، ويطبعها التطبيق.

### Star Online[​](#setup-star-online "رابط مباشر إلى Star Online")

استخدم Star Online عندما تكون طابعة Star الخاصة بك مسجَّلة بالفعل في حساب **stario.online** وتريد أن تتولّى خدمة Star المستضافة عملية التسليم.

1

#### احصل على عنوان CloudPRNT URL

في stario.online، افتح **Device Groups** وانسخ **CloudPRNT URL** الخاص بالمجموعة. ينبغي أن يبدو مثل `https://device.stario.online/cloudprnt/...` أو `https://eu-device.stario.online/cloudprnt/...`.

2

#### أنشئ مفتاح API بالأذونات

في stario.online، أنشئ مفتاح API لـ WCPOS. يجب أن يمتلك المفتاح إذن سرد الأجهزة والطباعة عليها. كحد أدنى، فعّل:

* **EnumDevices** — مطلوب عندما يجلب WCPOS قائمة الأجهزة
* **ViewDevice** — يُستخدم للتحقق من حالة الجهاز
* **PrintToDevice** — مطلوب لإرسال مهام الطباعة
* **ViewDeviceGroups** — يُنصح به للبحث عن المجموعات والتشخيص

يمكن أن يوجد مفتاح API ويظل يفشل إذا لم تُفعَّل هذه الأذونات.

3

#### أدخل العنوان ومفتاح API في WCPOS

أضف طابعة في **WP Admin > POS > Settings > Cloud Print**، واختر **Star Online** كمزوّد، ثم الصق عنوان CloudPRNT URL ومفتاح API. انقر **Fetch my devices**.

4

#### حدّد جهاز Star

اختر الطابعة من قائمة الأجهزة واحفظ. يخزّن WCPOS مفتاح API على الخادم ويستخدم معرّف الوصول الخاص بالجهاز المحدّد عند إرسال المهام إلى Star Online.

## قواعد الطباعة التلقائية[​](#auto-print "رابط مباشر إلى قواعد الطباعة التلقائية")

تحدّد قواعد الطباعة التلقائية ما يُطبع وأين، تلقائيًا — مكتوبة كجمل بسيطة. القاعدة هي **النطاق × الطابعة × القالب**، على سبيل المثال:

> اطبع **كل طلب** على **المطبخ** باستخدام **تذكرة المطبخ**.

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

توافق القالب مهم

لا تستطيع طابعات Star وEpson استخدام سوى القوالب **الحرارية**، لأنه يجب تحويل المهمة إلى لغة أوامر الطابعة الأصلية (Star Document Markup أو ESC/POS لطابعة Star، وePOS-Print لطابعة Epson). تستطيع PrintNode استخدام **أي** قالب — حراري أو HTML بصفحة كاملة — لأن المهمة تُحوَّل إلى **PDF**. إذا لم يظهر قالب كخيار لطابعة، فذلك لأن الطابعة لا تستطيع تحويل تلك الصيغة. راجع [القوالب الحرارية](/ar/receipts/thermal-templates.md) لإنشاء تخطيطات حرارية.

## طابعات لكل متجر (Pro)[​](#per-store-printers "رابط مباشر إلى طابعات لكل متجر (Pro)")

ميزة Pro

يتطلّب توجيه الطباعة لكل متجر [WCPOS Pro](/ar/getting-started/pro-license.md) وإعداد [متعدد المتاجر](/ar/stores/.md).

افتراضيًا، تكون قواعد الطباعة التلقائية عامة — تتشاركها جميع المتاجر. مع Pro، يمكنك منح متجر فردي قواعد طباعة سحابية **خاصة** به حتى تُطبع طلباته على طابعاته الخاصة (لا ينبغي أن تُطبع تذكرة مطبخ خاصة بموقع واحد في موقع آخر).

عدّل متجرًا ضمن **POS → Stores**، وافتح قسم **Cloud Printing** الخاص به، و**Add rule**. كل قاعدة هي:

* **Printer ID** — المعرّف الثابت للطابعة السحابية المراد الإرسال إليها
* **Scope** — **POS orders only** (افتراضي)، أو **Online orders only**، أو **Every order**
* **Format** — **StarPRNT** (افتراضي)، أو **ESC/POS**، أو **Epson ePOS-Print**، أو **HTML**

عندما ينتمي طلب إلى متجر له قواعده الخاصة، يوجّهه WCPOS إلى طابعات ذلك المتجر. إذا لم يكن للمتجر **أي** قواعد خاصة به، فإنه **يعود إلى** قواعد الطباعة التلقائية **العامة** — فلا تحتاج سوى إلى تهيئة المتاجر المختلفة.

## الطباعة اليدوية[​](#manual "رابط مباشر إلى الطباعة اليدوية")

ليس عليك انتظار قاعدة طباعة تلقائية. من **شاشة الدفع / الإيصال**، يستطيع الكاشير إرسال إيصال إلى طابعة سحابية عند الطلب — مفيد لإعادة الطباعة أو لتوجيه تذكرة لمرة واحدة إلى طابعة محدّدة.

تعتمد كيفية إنتاج الإيصال على الطابعة:

* **Star CloudPRNT** — يُحوَّل الإيصال **على الجهاز** ويُسلَّم إلى الطابعة عبر CloudPRNT.
* **Star Online وEpson وPrintNode** — يُحوَّل الإيصال **على الخادم** من الطلب والقالب المحدّدين، ثم يُسلَّم إلى الطابعة أو التتابع المستضاف.

## اختبار الطباعة وحالة الاتصال[​](#status "رابط مباشر إلى اختبار الطباعة وحالة الاتصال")

تحتوي كل بطاقة طابعة على زر **Test print** يرسل اختبارًا تشخيصيًا قصيرًا حتى تتأكّد من إمكانية الوصول إلى الطابعة وصحة الصيغة قبل الاعتماد عليها في الطلبات الحقيقية.

تعرض البطاقة أيضًا حالة مباشرة:

| المزوّد                    | الحالة        | المعنى                                                     |
| -------------------------- | ------------- | ---------------------------------------------------------- |
| **Star CloudPRNT / Epson** | **Waiting**   | لم تسجّل الطابعة دخولها بعد — ينتظر WCPOS استطلاعها الأول. |
| **Star CloudPRNT / Epson** | **Connected** | استطلعت الطابعة WCPOS مؤخرًا وهي تجمع المهام.              |
| **Star Online**            | **Online**    | تبلّغ Star Online أن الجهاز المحدّد متاح.                  |
| **Star Online**            | **Offline**   | تبلّغ Star Online أن الجهاز المحدّد غير متاح.              |
| **Star Online**            | **Unknown**   | لم يتمكّن WCPOS من تأكيد حالة الجهاز من Star Online.       |
| **PrintNode**              | **Online**    | تبلّغ خدمة PrintNode أن التطبيق والطابعة متاحان.           |
| **PrintNode**              | **Offline**   | تبلّغ PrintNode أن التطبيق أو الطابعة غير متاح.            |

## استكشاف الأخطاء وإصلاحها[​](#troubleshooting "رابط مباشر إلى استكشاف الأخطاء وإصلاحها")

الطابعة عالقة على حالة الانتظار (Waiting)

الطابعة التي تستطلع ولا تغادر حالة **Waiting** أبدًا لم تصل إلى WCPOS بنجاح قط. تحقّق مما يلي:

* أن **عنوان الاستطلاع والرمز** في برنامج الطابعة الثابت يطابقان تمامًا ما أنشأه WCPOS. حرف واحد خاطئ يعني رفض كل استطلاع — أعد إنشاء الرمز في WCPOS وأعد إدخاله إذا لم تكن متأكدًا.
* أن الطابعة تستطيع فعلًا **الوصول إلى موقعك** عبر الإنترنت (DNS صحيح، ولا جدار حماية يحجب HTTPS الصادر، وشهادة SSL صالحة على متجرك).
* أن **الاستطلاع مُفعَّل** في تهيئة CloudPRNT / Server Direct Print للطابعة، بفترة معقولة. أعد تشغيل الطابعة بعد تغيير إعداداتها.

تقول Star Online إن مفتاح API غير مصرّح به أو ممنوع

تفصل Star Online بين **المصادقة** و**الأذونات**:

* **401 / فشل المصادقة** يعني أن مفتاح API نفسه لم يُقبل. تحقّق من نسخ المفتاح بشكل صحيح، وأنه لم يُلغَ، وأنه ينتمي إلى حساب/منطقة Star Online المتوقعة.
* **403 / ممنوع** يعني أن مفتاح API قُبل لكنه غير مصرّح له بالإجراء المطلوب. عدّل المفتاح في stario.online وفعّل الأذونات المطلوبة، خاصةً **EnumDevices** لـ **Fetch my devices** و**PrintToDevice** للطباعة.

إذا نجح **Fetch my devices** لكن لم تظهر أي طابعات، تحقّق من صفحة **Device Groups** في stario.online. يجب أن تحتوي المجموعة على جهاز متصل واحد على الأقل، ويجب أن يشير عنوان CloudPRNT URL في WCPOS إلى تلك المجموعة نفسها.

مهمة PrintNode لا تُطبع أبدًا

وصلت المهمة إلى PrintNode لكنها لم تخرج من الطابعة. تحقّق مما يلي:

* أن **تطبيق سطح المكتب PrintNode قيد التشغيل ومتصل** على الحاسوب المتصل بالطابعة. إذا كان الحاسوب نائمًا أو التطبيق مغلقًا، لن يُطبع شيء.
* أنك حدّدت **الطابعة الصحيحة** في WCPOS — يجب أن يطابق الاسم الطابعة التي يبلّغ عنها التطبيق.
* أن **مفتاح API صالح** ولم يُلغَ. أعد إدخاله إذا أظهرت PrintNode الطابعة على حالة Offline.

قالبي غير قابل للتحديد لطابعة Star أو Epson

تعمل القوالب **الحرارية** فقط على طابعات Star وEpson السحابية، لأنه يجب تحويل الإيصال إلى أوامر ESC/POS أو ePOS-Print. لا يمكن التعبير عن قوالب HTML والصفحات الكاملة بتلك الصيغ، لذا تُخفى لهذه الطابعات.

إمّا أن تختار [قالبًا حراريًا](/ar/receipts/thermal-templates.md)، أو تستخدم طابعة **PrintNode** — تحوّل PrintNode إلى PDF، فتستطيع طباعة أي قالب.

## وثائق ذات صلة[​](#related-documentation "رابط مباشر إلى وثائق ذات صلة")

[إعداد الطابعةتوصيل طابعة على الجهاز نفسه أو الشبكة نفسها](/ar/hardware/printers.md)

[القوالبنظام قوالب الإيصالات](/ar/receipts/.md)

[القوالب الحراريةبناء تخطيطات ESC/POS لطابعات Star وEpson](/ar/receipts/thermal-templates.md)