الدليل ديال HorecaPOS

هاد الدليل فيه تلاتة ديال الأجزاء: الأول ل الخدّامة (السيرفيس)، من بعد ل المدير والأخير ل المسؤول. كل جزء كيكمّل اللي قبلو: المدير يقدر يدير كلشي اللي كيديرو السيرفورات، والمسؤول يقدر يدير كلشي.

شنو يقدر يدير الدور ديالك بالضبط، كيحدّدو المسؤول ف الإعدادات ← الصلاحيات. إلا ما كتشوفش شي بوطون، يعني الدور ديالك ما عندوش الصلاحية ليه (باقي).

هاد الدليل كاين حتى ف الكاسة: كليكي على البوطون © لتحت على اليمين ف أي شاشة وختار الدليل، ولا حلّ http://<kassa-pc>:3000/handleiding. شوف حتى التقديم و الشرح ديال API.

الجزء 1 · الخدّامة

بدا الخدمة

الدخول. حلّ الكاسة ف الكاسة، الطابليط ولا التيليفون ودخّل الكود السري ديالك (من 4 حتى 8 ديال الأرقام). من بعد غادي تشوف البلان ديال الطابلات.

حلّ طابلة. كليكي على طابلة. الطابلة الخاوية كتاخد كوموند جديدة؛ ف الطابلة المعمّرة كتكمّل الكوموند اللي ديجا فيها. لفوق كتبدّل بين القاعات (مثلا الصالة والتيراس). للكونطوار استعمل البيع السريع، وللكوموندات اللي ياخدوها معاهم ياخدها معاه.

الكوموند. ختار صنف وكليكي على المنتوجات. كيبانو ف التيكي على اليسار. إلا بغيتي ختار قبل الطبسيل (1 = دغيا، 2 و 3 كيتسناو حتى تعيّط عليهم). كليكي على صيفط الكوموند: إيوا التيكيات كيمشيو للكوزينة وللبار. ما دام ما كليكيتيش على صيفط الكوموند، تقدر تحيّد السطورة عادي.

خلّص الحساب. كليكي على خلّص الحساب، ختار لكارط / Bancontact، كاش ولا بون كادو، إلا بغيتي البوربوار، وأكّد. بلكارط الخلاص كيبدا بوحدو ف التيرمينال. التيكي كيتطبع؛ وتقدر حتى تصيفطو ف الإيميل.

الخروج. خرج ملي تسالي، باش حتى واحد آخر ما يخدم بسميتك. من بعد 8 ديال الساعات كتخرج بوحدك.

ما كاينش الإنترنيت؟ الكاسة كتبقى خدامة عادي. إلا بان لفوق ما كاينش الإنترنيت · خلّص بلكارط باليد، دخّل المبلغ ف التيرمينال براسو وختار ف شاشة الخلاص ديجا تخلّص بلكارط ف التيرمينال.

بزاف ديال المجموعات فطابلة وحدة

ف طابلة وحدة يقدرو يگلسو بزاف ديال المجموعات، كل وحدة بالحساب ديالها والتيكي ديالها.

• كليكي على طابلة: خاوية = كوموند جديدة؛ مجموعة وحدة = كتدخل نيشان لديك المجموعة؛ بزاف ديال المجموعات = ختار الأول، ولا + مجموعة جديدة (السمية تقدر تبقى خاوية).
• ف شاشة الكوموند لفوق كاين الشريط ديال المجموعات: بدّل بين المجموعات، + مجموعة، سمية المجموعة (مثلا "العلوي") و قسم / نقل.
• قسم / نقل: ختار ف كل سطر شحال اللي غادي يمشي (مثلا 1 من 3× بيرة) ولأنهي مجموعة، ولا صاوب مجموعة جديدة. هكا كتنقل شي حاجة اللي راها ف الحساب الغالط، ولا كتقسم من بعد باش "كل واحد يخلّص ديالو". إلا خوات شي مجموعة، كتمشي.
• بزاف ديال الأجزاء مرة وحدة: ب+ جزء آخر كتوجد جزء وكتختار اللي من بعدو (بحال الحوت وDry Martini للطابلة 2، والباقي للطابلة 35). الجزء يقدر يمشي حتى ل+ طابلة أخرى (تما كمجموعة جديدة). بنقل كلشي كيتنقل مرة وحدة. ½ كيقسم السطر على جوج، حتى نص قرعة (0,667 كتولي 2 × 0,3335).
• جمع: كلشي من طابلة ولا كثر (ولا مجموعات خرين فهاد الطابلة) كيجي لهاد الحساب، مرة وحدة.
• بلجيكا: القسمة ولا الجمع مرة وحدة كيتحسب فالصندوق الكحل تبديل طابلة واحد، بحال ما بغات FOD (UC242، UC251، UC252، UC4119bis). إلا تمسحات شي حاجة من بعد الطلب ولا تزاد تخفيض على سطر مطلوب من قبل، كيمشي مع الميساج الجاي ديال ديك الطابلة (طلب، حساب مؤقت، تبديل طابلة)، وإلا فالبيعة: السطر القديم بالناقص والجديد بالزايد (UC226، UC4102، UC4104، UC4107، UC4110).
• ف شاشة الطابلات كاينة نقطة ليمونية كتبيّن شحال من مجموعة كاينة؛ المبلغ هو المجموع ديال جميع المجموعات.
• التيكي ديال الكاسة والتيكي ديال الكوزينة كيبيّنو "الطابلة 5 - المجموعة 2" ولا "الطابلة 5 - العلوي".

قسم الحساب ملي كتخلّص

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

• قسم بالتساوي: ختار ب − و + على شحال من واحد (عادةً عدد الضياف، ولا 2 إلا الكاسة ما كاتسجلش عدد الناس). الشاشة كاتبين شحال على كل واحد؛ كل واحد كيخلص الجزء ديالو بالكارط، كاش ولا بكارط كادو (مع البوربوار إلا بغيتي). من بعد كل جزء كيحسب للور ("باقي 3 ديال الناس")؛ اللخر كيخلص الباقي بالضبط.
• مبلغ خاص: واحد كيخلّص مبلغ ثابت (مثلاً € 20)؛ الباقي كيبقى محلول.
• على حساب المنتوج…: كيحلّ قسم / نقل باش تحط المنتوجات فحساب بوحدو وتخلّصو بوحدو (بحال اللي فوق).

الخلاص بالجزء كيسجّل غير الخلاص؛ الحساب كيبقى محلول وفشاشة الكوموند كيبان "مخلّص من قبل … · باقي محلول …". التيكي (فيه جميع الخلّاصات) كيخرج مع آخر خلاص، بحال فالخلاص العادي. الخلاص بلكارط عن طريق الربط كيكون على الجزء بالضبط. إلا تخلّص شي جزء من قبل، ماتقدرش تنقل السطور لگروب آخر ولا تزيد تخفيضات؛ والحيدان مايمكنش غير إلا كان باقي محلول بزاف. كل خلاص بالجزء كيتسجّل فالسجل.

بيع سريع وماكلة تّاخد معاك (بلا طابلة)

فوق على اليمين فشاشة الطوابل كاينين بيع سريع وياخدها معاه. بجوج كيحلّو ديريكت كوموند بلا طابلة. البيع السريع هو البيع فالكونطوار (TVA ديال فالمحل)؛ ياخدها معاه كيخدم بالتعريفة ديال TVA ديال à emporter ديال كل منتوج. بـ "سمية الكليان" كتزيد سمية؛ كتبان فالتيكي ("ياخدها معاه – العلوي") وفوق فالتيكي ديال الكوزينة. الكوموندات المحلولة بلا طابلة كيبانو تحت البوطونات ديال البلايص ("بلا طابلة: ياخدها معاه #12 – العلوي")، باش تلقاهم. إلا رجعتي بلا ما تبيع والو، الكوموند الخاوية كتمشي بوحدها.

بجوج البوطونات تقدر تشعّلهم ولا تطفيهم لكل محل فـ الإعدادات → المحل، ديريكت تحت الثيم الفاتح/الغامق (عادةً شاعل). مطفي = البوطون مخبّي؛ الكوموندات بلا طابلة اللي ديجا محلولة كيبقاو باينين.

التوصيل والكرينوات

الكوموندات اللي كتاخدها نتا براسك ف الكاسة، مثلا فالتيليفون ولا ف الكونطوار، بنفس القواعد ديال المتجر ديال الأنترنيت: مناطق التوصيل وماكسيموم ديال الكوموندات فكل كرينو. كتشعلها ف الإعدادات → المحل → التوصيل والكرينوات، نيشان تحت البوطونات بيع زربة وياخدها معاه (عادةً مطفي).

• البوطون التوصيل ف شاشة الطابلات (حدا ياخدها معاه): عمّر السمية، التيليفون والعنوان (إلا كان دخّل العنوان بالزربة شاعل: كتقلّب بالكود البريدي ونمرة الدار). الكاسة كتقلّب على منطقة التوصيل وكتبيّن مصاريف التوصيل، الحد الأدنى و"فابور من". إلا كان العنوان برّا المناطق، ما يمكنش.
• مناطق التوصيل: ب الكود البريدي (سلاسل وأكواد بوحدهم، مثلا 5000-5049, 5051, 5052 AB)، داخل شعاع بالكيلومتر من المحل (خط مستقيم) ولا منطقة على الخريطة كترسمها بيدك. الشعاع والمنطقة خدامين غير مع العناوين ديال هولندا (البلاصة عبر PDOK). لكل منطقة: مصاريف التوصيل، الحد الأدنى، فابور من والدقايق الزايدين؛ أول منطقة من الفوق اللي كتناسب هي اللي كتحسب، داكشي علاش تقدر تخلط الأنواع (مثلا اللول شي أكواد بريدية، من بعد منطقة، من بعد شعاع للباقي). ما كاين حتى منطقة = التوصيل فكل بلاصة، بلا مصاريف ولا حد أدنى. المناطق ديال المتجر ديال الأنترنيت كتضبطها بوحدها (الإدارة ديال المتجر ديال الأنترنيت).
• منطقة على الخريطة: ختار ف منطقة التوصيل النوع منطقة على الخريطة ومن بعد رسم على الخريطة. كليكي على الخريطة باش تحط النقط (على الأقل 3)؛ جرّ نقطة باش تبدّل بلاصتها، كليكي على نقطة باش تحيدها، وجرّ الكورة الصغيرة اللي ف نص الحاشية باش تزيد نقطة بيناتهم. الخريطة كتبيّن حتى مناطق الشعاع والمحل. التصاور ديال الخريطة جايين من OpenStreetMap، داكشي علاش الخريطة خاصها الأنترنيت؛ التوصيل براسو لا (من غير البحث على العنوان). إلا ما قدرناش نلقاو العنوان، الكاسة كتقول هادشي بلاصة "برّا مناطق التوصيل".
• مصاريف التوصيل كيبانو كسطر "مصاريف التوصيل" ف الكوموند وكيتعاودو يتحسبو من بعد كل تبديل (فابور من، بلا منتوجات = بلا مصاريف)، مادام حتى حاجة ما تخلّصات. تحت الحد الأدنى ما يمكنش تخلّص الحساب؛ شاشة الكوموند كتبيّن شحال باقي خاص، مع البوطون ياخدها معاه وصافي (مصاريف التوصيل والحد الأدنى كيتحيدو).
• الوقت: فأسرع وقت (دابا + وقت التوصيل، زايد الدقايق الزايدين ديال المنطقة) ولا كرينو ديال اليوم. إلا كانو أوقات الحلّان ف Thuisbezorgd، حتى هنا كيتحسبو.
• الماكسيموم فكل كرينو (0 = بلا ماكسيموم؛ الكرينو من 5 حتى ل 60 دقيقة): ل ياخدها معاه والتوصيل بجوج؛ حتى الكوموندات ديال المتجر ديال الأنترنيت اللي ف الكاسة كتتحسب. إلا كان شي ماكسيموم، حتى ياخدها معاه كيطلب الوقت والكرينوات العامرين ما يمكنش تختارهم. جوج كاسات ف نفس الوقت على آخر بلاصة: غير وحدة اللي كتاخدها.
• ف تيكي الكوزينة كيبانو العنوان، السمية، التيليفون والوقت؛ ف "بلا طابلة" وفوق تيكي الكوزينة مثلا "التوصيل – 18:30 Jansen".

زيادات (كلهم عادةً مطفيين؛ بلا هاد الإعدادات كلشي خدام بالضبط بحال الفوق):

• أوقات خدمة خاصة ب ياخدها معاه والتوصيل (على حساب نهار السيمانة، مثلا 16:00-21:00 ولا 11:30-14:00, 17:00-22:00؛ من بعد نص الليل مسموح: 17:00-01:00؛ خاوي = هاداك النهار مسدود). مطفي = بحال قبل (الأوقات ديال Thuisbezorgd إلا كانو، ولا النهار كامل).
• النهارات المسدودة (مثلا 25-12-2026, 26-12-2026): ف هاد النهارات لا ياخدها معاه لا توصيل.
• الكوموند من قبل: من 0 (غير اليوم، بحال قبل) حتى ل 14 يوم. ف الفنيترة ديال التوصيل/ياخدها معاه كتختار الأول النهار؛ النهار اللي من بعد كيطلع ف تيكي الكوزينة قبل الوقت.
• الزحام: هاد الدقايق زايدين ف "ف أسرع وقت" (ف الكاسة وف المتجر ديال الأنترنيت بجوج). تقدر تبدلو بالزربة حتى بالبوطون المتجر ديال الأنترنيت ف البارة اللي الفوق.
• العناوين ديال بلجيكا (كود بريدي ديال 4 أرقام): ف الشعاع ولا المنطقة على الخريطة، الكاسة كتقلّب على البلاصة عبر OpenStreetMap ‏(Nominatim؛ خاص الزنقة والمدينة).
• المتجر ديال الأنترنيت كيتبع الكاسة: الكاسة هي اللي كتحكم. المتجر كيخدم بمناطق التوصيل، وقت التوصيل ووقت ياخدها معاه، الكرينو، الماكسيموم ف كل كرينو، أوقات الخدمة (إلا تحطّو هنا)، النهارات المسدودة والنهارات من قبل ديال الكاسة، وكيحسب حتى الكوموندات اللي تاخدو ف الكاسة ف الكرينو. مطفي = المتجر عندو الإعدادات ديالو (الإدارة ديال المتجر)، بحال قبل. تشعال ولا تطفاء ياخدها معاه/التوصيل كيبقى ف يد المتجر ديال الأنترنيت.

الكود: lib/bezorgen.ts، routes/bezorgen.ts، BezorgDialoog.tsx، BezorgInstellingen.tsx، BezorgKaart.tsx وlib/kaart.ts (الخريطة، بلا باكيج زايد؛ نفس الكود كاين ك public/kaart.js ف المتجر ديال الأنترنيت).

التيليفون: عرف الكليان ف كوموند بالتيليفون

الإعدادات → التيليفون (عادةً مطفي؛ ملي كتطفيه كلشي كيبقى محفوظ). جوج بوطونات بوحدهم:

• قلّب على الكليان بنمرة التيليفون ف التوصيل وياخدها معاه: كتب النمرة ف الشاشة ديال التوصيل، والكاسة كتورّي الكليان مع العنوان والكوموندات اللي قبل؛ خود المعلومات كيعمّر السمية، الإيميل والعنوان. خدّام حتى بلا سونطرال.
• معرفة النمرة: ملي كيعيّط كليان، السونطرال (ولا التيليفون، FRITZ!Box، المودم ولا تيليفون Android) كيصيفط النمرة. ف الشاشات كتبان نوتيفيكاسيون بشكون اللي كيعيّط: السمية، العنوان، آخر الكوموندات (بالماكلة والمبلغ، حتى من المتجر ديال الأنترنيت، Thuisbezorgd والپلاتفورمات ديال التوصيل)، المجموع وريزيرفاسيون. ب خود كوموند ديال التوصيل ولا خود كوموند ياخدها معاه كتتحلّ الشاشة ديال التوصيل بكلشي معمّر (إلا كان التوصيل والأوقات شاعلين)؛ الكوموند كتتربط مع المكالمة والنوتيفيكاسيون كتغبر من گاع الشاشات. البوطونة 📞 ف البار لفوقاني: المكالمات ديال آخر 24 ساعة. يمكن تطفا لكل شاشة (ورّي النوتيفيكاسيونات ف هاد الشاشة).

التقليب كيتدار ف كارط الفيدليتي، الكوموندات ديال التوصيل وياخدها معاه ف الكاسة، المتجر ديال الأنترنيت، Thuisbezorgd، الپلاتفورمات ديال التوصيل والريزيرفاسيونات. النمر كيوليو بحال بحال (+31 6 1234 5678، 0031612345678 و06-12345678 هوما نفس الحاجة؛ حتى النمر البلجيكية).

كيفاش كتدخل النمرة (يمكن بزاف ف نفس الوقت؛ نفس المكالمة كتتحسب مرة وحدة):

الجواب فيه اللي كيعيّط، حتى بحال contact (firstname، lastname، phone، email، address) لتامپلات CRM ديال 3CX. المكالمات الخارجة والداخلية ما كيبانوش؛ غير هاد الخطوط كيحصر ف شي خطوط ولا تيليفونات. المكالمات كيتمسحو من بعد مدة الحفظ (ف الأول 30 يوم، GDPR). مكالمة تجريبية كدير بحال إلا شي نمرة كتعيّط.

الكود: apps/pos-server/src/lib/telefonie.ts، routes/telefonie.ts، packages/shared/src/telefonie.ts؛ الشاشات Telefonie.tsx، BezorgDialoog.tsx؛ Android android-app/native/java/Beller*.java. السجل: التيليفون.

الليفرور ديالك: الطورنيات، تسليم الفلوس و Track & trace

للمحلات اللي عندهم الليفرورات ديالهم. شعلها فـ الإعدادات → المحل → التوصيل → الليفرور ديالك (طافية بشكل افتراضي). ما خاصش تطبيق للليفرور: الليفرور كيستعمل صفحة فالمتصفح ديال التيليفون ديالو (اللي بغا، يستعمل التطبيق Optimum Bezorger: شوف التطبيق ديال الليفرورات لتحت).

صاوب طورني. فالكاسة كاينة البوطونة الطورنيات (مع عدد التوصيلات اللي باقي خاصها تخرج زايد الطورنيات اللي فالطريق).

1. علّم ف واجد للتوصيل على الكوموندات اللي غادي يمشيو. هادو هما الكوموندات ديال التوصيل من الكاسة، المتجر ديال الأنترنيت و Thuisbezorgd (غير التوصيل بوحدك؛ ماشي اللي كيوصلهم ليفرور ديال Thuisbezorgd).
2. ختار الليفرور (خدّام) والصرف اللي غادي معاه (بشكل عادي المبلغ اللي فالإعدادات)، وكليكي صاوب طورني.
3. كيبان QR. الليفرور كيسكانيه بالتيليفون ديالو وكيشوف لكل عنوان السمية، العنوان مع بوطونة الطريق (GPS)، عيّط، الملاحظة، الوقت المطلوب وشحال خاصو يجمع. كاينة حاسبة الصرف (الكليان عطى € 50 ← رجّع € 31,50). ما محتاجش يدخل بالحساب. شارك اللينك غير مع الليفرور: اللي عندو كيشوف العناوين ديال هاد الطورني. ب QR ديال الليفرور كتصاوب لينك جديد؛ القديم ما بقاش غادي يخدم.
4. كليكي خرج ملي الليفرور يمشي. الصرف كيخرج من الكاشير (خروج الفلوس، مع السبب). الكليان كيوصلو ميساج بلي الكوموند فالطريق:
   • لكوموند من الكاسة ب SMS و/ولا إيميل، إلا كانت الميساجات للكليان شاعلة (شوف التوصيل والكرينوات)؛
   • للمتجر ديال الأنترنيت كيفما مريگل فالمتجر (إيميل، SMS ولا نوتيفيكاسيون)؛
   • ل Thuisbezorgd عن طريق Thuisbezorgd.

إلا الطورني باقي ما خرجاتش، تقدر تلغيها.

1. فالطريق الليفرور كيكليكي لكل عنوان توصلات، كاش، توصلات، لكارط (ماكينة ديال لكارط ديالو) ولا توصلات (ديجا مخلّص). الكاسة كتشوف داكشي ديريكت. إلا الليفرور ما قدرش يعلن، تقدر تديرها حتى فالكاسة. ملي يرجع للمحل الليفرور كيكليكي رجعت للمحل.

تسليم الفلوس. من بعد الطورني كتكليكي خلّص الحساب (الصلاحية سيّر الكاشي ديال الفلوس):

• لكل كوموند كتختار كاش، لكارط عند الباب، ديجا مخلّص ولا ما توصلش (رجع). اللي علن الليفرور كيكون ديجا معمّر.
• الكاسة كتخلّص كل كوموند فيها مبلغ باقي، بلا تيكي جديد (الكليان عندو التيكي ديجا؛ تقدر تعاود الطباعة من التيكيات). الكوموند اللي ما توصلاتش كتخرج من الطورني وكتبقى محلولة، باش تقدر تمشي فطورني جاية.
• كتشوف شنو متوقع: الصرف زايد اللي تقبض كاش. دخّل اللي سلّم الليفرور، ولا حسبو بالورقة والبياسة (حسب بالورقة والبياسة). الكاسة كتوريك واش مزيان، ولا شحال زايد ولا ناقص.
• الصرف كيرجع للكاشير (دخول الفلوس). الفرق كيتسجّل فالطورني وفالسجل، وكيبان حتى كفرق فالكاسة فالرابور Z.

Track & trace (كيتشعل بوحدو فالإعدادات). الكليان كيوصلو ف فالطريق لينك ل صفحة التتبع فالبوابة. هاد اللينك كاين فالـ SMS ولا الإيميل، وفالمتجر ديال الأنترنيت فصفحة الحالة (تبّع الليفرور ديالك). فصفحة التتبع كاين:

• واش الكوموند كتوجد، فالطريق ولا توصلات؛
• الوقت المتوقع: من البلاصة ديال الليفرور مرورا بالعناوين اللي قبل، وإلا الوقت المطلوب؛
• شحال من عنوان باقي قبل (بلا ما يبانو العناوين الأخرين)؛
• مع الليفرور مباشرة فالخريطة كيبان حتى الليفرور، المحل والعنوان ديال الكليان فخريطة (OpenStreetMap). الليفرور هو اللي كيشعل مشاركة البلاصة فالتيليفون (شارك البلاصة ديالي). البلاصة كتمشي غير ملي الصفحة محلولة؛ الصفحة كتخلي الشاشة شاعلة.

الصفحات كيبانو بلغة التيليفون (كاع اللغات ديال البوابة). فالكاسة كتشوف عند الطورني إمتى آخر مرة تصيفطات البلاصة (مع لينك للخريطة).

الخصوصية. البوابة كتحفظ المعلومات ديال الطورني (السميات، العناوين، أرقام التيليفون، البلاصة) غير ملي الطورني خدامة. ملي كتخلّص كلشي كيتمسح، وإلا من بعد 24 ساعة. الكليان كيشوف غير الكوموند ديالو. البلاصة ديال الليفرور كتبان غير فوقت الطورني، وما بقاتش كتبان ملي يرجع.

تنظيم الطورنيات (اختياري)

شعلو ف الإعدادات → المحل → التوصيل → تنظيم الطورنيات (عادةً طافي؛ كيخدم مع الليفرورات ديال المحل). من بعد ف الفنيطرة الطورنيات كاينة البوطونة قترح طورنيات. الكاسة كتجمع الكوموندات اللي باقي خاصها تخرج ف طورنيات:

• الكوموندات اللي قراب لبعضياتهم واللي الأوقات المطلوبة ديالهم داخلين ف فنيطرة الوقت (عادةً 30 دقيقة) كيتجمعو؛
• حتى للماكسيموم ديال العناوين ف كل طورني (عادةً 4)، مادام الطورني (المشية، كاع العناوين والرجعة للمحل) ما كتفوتش الماكسيموم (عادةً 45 دقيقة)؛
• ف كل طورني أحسن ترتيب، المسافة (كم)، وقت الطريق مشية ورجعة، وف كل عنوان الوصول المتوقع إلا خرج دابا. إلا كان من بعد الوقت المطلوب، كيبان حداه من بعد الوقت المطلوب.

ب خدم بهاد الطورني كتعلّم على هاد الكوموندات، بهاد الترتيب؛ ختار الليفرور وضغط صاوب طورني. ف طورني اللي باقي ما خرجاتش، أحسن ترتيب كيحط العناوين ف الترتيب الأسرع (حتى ف التيليفون ديال الليفرور). عند كل طورني كتبان المسافة ووقت الطريق.

الإعدادات: العناوين ف كل طورني، شحال تقدر تاخد الطورني، فنيطرة الوقت، السرعة ديال الليفرور (بشكليط ~15، موطور ~25، طوموبيل ~35 كم/س ف المدينة) والدقايق ف كل عنوان (الپاركينغ، ضريب الجرس، الخلاص؛ عادةً 2). هاد الأرقام يقدر حتى المدير يضبطهم: ف النافذة الطورنيات بالبوطونة ضبط تنظيم الطورنيات (الحق ضبط تنظيم الطورنيات، مشعول عادة للمدير؛ يتبدل ف الإعدادات → الحقوق). تشعيل ولا تطفية تنظيم الطورنيات وخدمة الطرق (العنوان، مفتاح API) كيبقاو عند المسؤول.

المسافة ووقت الطريق، كيختارهم المسؤول:

• تقدير (عادةً): خط مستقيم ضرب 1,35 (معامل الدورة) مع السرعة ديال الليفرور. كيخدم بلا أنترنيت وبلا كونط.
• OSRM: الطريق ف الزنقة عبر سيرفور OSRM. عمّر العنوان (https://، ولا http:// ف الريزو ديالك). السيرفور ديال الديمو العمومي (https://router.project-osrm.org) غير للمرة والمرة؛ للخدمة ديال كل نهار حط سيرفور OSRM ديالك ولا خود شي فورنيسور.
• OpenRouteService: الطريق ف الزنقة ب مفتاح API ديالك (كتصاوبو بلاش ف openrouteservice.org، مع ماكسيموم ف النهار). العنوان عادةً هو https://api.openrouteservice.org وتقدر تبدلو لسيرفور ديالك. المفتاح كيبقى ف الكاسة؛ الشاشات كيبينو غير بلي تعمّر.

ب جرّب كتجرب الخدمة. إلا ما خدماتش الخدمة، البرمجة كترجع للتقدير وكتقول هادشي. عنوان اللي البلاصة ديالو ما معروفاش (ما كاينش كود بريدي ونمرة الدار صحاح) كيبان ف الاقتراح تحت بلا بلاصة معروفة وما كيتبرمجش. الإكسپور ديال الكونفيغيراسيون كياخد الإعدادات، ولكن ماشي المفتاح.

الكود: lib/ritplanning.ts.

التطبيق ديال الليفرورات (اختياري)

شعلها فـ الإعدادات → المحل → التوصيل → التطبيق ديال الليفرورات (طافية بشكل افتراضي؛ كتخدم مع الليفرورات ديالك والبورطاي ديال الإدارة). كل ليفرور كيربط التيليفون ديالو مرة وحدة، بلاصة ما يسكاني كود QR فكل طورني:

1. ختار فـ التيليفونات المربوطين الليفرور (خدّام)، وإلا بغيتي السمية ديال التيليفون، وكليكي على ربط تيليفون.
2. كيبان كود QR. الليفرور كيسكانيه فالتطبيق Optimum Bezorger (البوطونة ربط)، ولا بالكاميرا ديال التيليفون: الصفحة كتتحل فالمتصفح. خدامة حتى بلا تطبيق وتقدر تحطها فالشاشة الرئيسية.
3. الربط كيبقى صالح حتى تلغيه؛ التيليفون ما كيبقى يشوف والو دغيا. ربط جديد لنفس الخدّام كيعوّض القديم (بحال إلا كان تيليفون جديد).

فالتطبيق ولا فالصفحة كيبانو الطورنيات ديالو كاملين (كل طورني الكاسة كتصاوبو لهاد الليفرور)، بنفس البوطونات ديال الطورني: الطريق، عيّط، المبلغ اللي خاصو يتخلص مع الحاسبة ديال الصرف، توصلات ورجعت للمحل. تقدر تشعل بوحدهم:

• ياخد الكوموندات براسو: الليفرور كيشوف التوصيلات اللي مازال خاصهم يدخلو فطورني، كيعلّم على اللي غادي ياخد وكيكليكي دّي. الكاسة كتصاوب الطورني (ولا كتزيدهم إلا كان عند هاد الليفرور طورني مازال ما خرجش)؛ الصرف العادي كيمشي معاه. اللي خداه شي واحد آخر ما بقاش يتّاخد.
• يخرج براسو: خرج فالتطبيق كيدير نفس الحاجة اللي فالكاسة (الصرف من الكيشي، والكليان كيوصلهم ميساج).
• الخريطة المباشرة: فـ الطورنيات كاينة البوطونة الخريطة فيها المحل، الليفرورات كاملين اللي خدامين والعناوين اللي مازال خاصهم يتوصلو. الليفرور هو اللي كيشعل ويطفي خدام. التطبيق كيصيفط البلاصة حتى والشاشة طافية (Android: نوتيفيكاسيون فالبارة ملي التشارك شاعل)؛ الصفحة ديال الويب غير ملي تكون محلولة. بلا هاد الإعداد البلاصة كتتشارك غير فطورني فيه track & trace.

التطبيق ديال Android كاين فـ Google Play وفصفحة التحميل ديال البورطاي (/download/). نسخة iPhone واجدة، ولكن غادي تخرج غير ملي يكون عندنا كونط ديال المطوّر عند Apple؛ حتى لداك الوقت الـ iPhone كيستعملو الصفحة ديال الويب. فالطورني اللي خداه الليفرور براسو كيبان خداها براسو فالتطبيق.

الكود: lib/bezorgersapp.ts، فالبورطاي src/volgen.mjs والتطبيق فالريپو horecapos-bezorger.

فالسجل مكتوب شكون صاوب الطورني، خرّجها، علن بلي توصلات وخلّص، مع المبالغ. الطفي: ما كايناش البوطونة ديال الطورنيات؛ الطورنيات والإعدادات كيبقاو محفوظين.

فالبوابة: /bezorger/<sleutel> و /volg/<code>. الكود: lib/bezorgers.ts، routes/bezorgers.ts، Bezorgers.tsx وفالبوابة src/volgen.mjs.

تنبيه ملّي الكوموند كتطوّل بزاف

كوموند ياخدها معاه ولا ديال التوصيل وجدات من بعد الوقت اللي توعدنا بيه: الكاسة كتشوفها وكتنبّه، وتقدر تصيفط للكليان اعتذار ديريكت، وإلا بغيتي مع بون ديال الرصيد. شعلها ف الإعدادات → المحل → التوصيل → تنبيه ملّي الكوموند كتطوّل بزاف (عادةً طافية).

• أشمن كوموندات: ياخدها معاه والتوصيل اللي عندهم وقت موعود، من الكاسة (التوصيل والأوقات)، المتجر ديال الأنترنيت وThuisbezorgd.nl / Takeaway.com.
• معطّل: من بعد هاد الدقايق (عادةً 10) من الوقت الموعود ومازال ما وجداتش ولا ما خرجاتش فالطريق. وجدات ولا فالطريق يعني: كلشي واجد فالشاشة ديال الكوزينة، الحالة واجدة ولا فالطريق فالمتجر ديال الأنترنيت ولا عند Thuisbezorgd، الميساج ✉ واجد / ✉ فالطريق تصيفط للكليان، ولا تخلّصات. الكاسة كتشوف كل دقيقة.
• التنبيه: البوطونة معطّل فالبار اللي الفوق مع العدد (مع الصوت ملّي يجي واحد جديد)، ولكل كوموند الوقت الموعود وشحال من دقيقة معطّلة. الكوموند كتمشي بوحدها ملّي توجد ولا تخرج فالطريق، ولا ب تقاد؛ تحتها كاينين ديال آخر 24 ساعة، مع فوقاش وجدو. كلشي مكتوب فالسجل.
• المتجر ديال الأنترنيت: الصفحة ديال الحالة عند الزبون كتبيّن بلّي كتطوّل، مع الوقت الجديد اللي متوقع.
• مع Thuisbezorgd ما يمكنش (الكليان تابع ل Thuisbezorgd): تما غير التنبيه. تقدر تدير نص ديالك؛ {naam}، {zaak}، {code}، {korting} و{geldig} كيتعمّرو بوحدهم.
• بون ديال الرصيد (غير ملّي أكواد التخفيض شاعلين): مع الاعتذار كود تخفيض شخصي للكوموند الجاية (بحال SORRY-7K4Q2M)، مبلغ ولا بالمية، كيتستعمل مرة وحدة، صالح شي أيام، فالكاسة وفالمتجر ديال الأنترنيت. هاد الأكواد ما كيبانوش فاللائحة ديال أكواد التخفيض. إلا ما تصيفطش، الكود كيتلغى. بالبوطونة فالكاسة غير مع الحق عطي تخفيض.
• طافي: التنبيهات والأكواد اللي تعطاو كيبقاو محفوظين (حتى فالباكاب)؛ والإعداد كيدخل فالتصدير ديال الكونفيڭوراسيون.

الكود: lib/telaat.ts، routes/telaat.ts، TeLaat.tsx وpackages/shared/src/telaat.ts.

البوطونة صيفط الكوموند: شنو كدير ومتى كتحتاجها

تكليكي على شي منتوج وتكليكي على صيفط الكوموند راهم جوج خطوات مختالفين:

• التكليك كيزيد المنتوج ديريكت فالحساب (على اليسار فالليستة)، بحال جديد. غير نتا اللي كتشوفو: الكوزينة والبار باقي ما عارفين والو. السطر الجديد بحال مسودة: تقدر تحيدو، ولا تبدّل العدد ولا الخيارات عادي، بلا ستورنو.
• صيفط الكوموند كيصيفط كاع السطور الجداد مرة وحدة: البونات كيمشيو لطابعات الكوزينة والبار (ولشاشة الكوزينة)، ومن بعد السطور كيوليو مكومونديين. من تما، ما تقدرش تحيدهم غير بـستورنو (الحق ديال ستورنو). على البوطونة مكتوب شحال من سطر جديد واجد، مثلاً صيفط الكوموند (3)؛ إلا ما كاين حتى سطر جديد، البوطونة كتكون رمادية.

علاش هاد جوج خطوات؟ فالطبلة كتاخد الكوموند كاملة (المشروبات، المقبلات، الطبق الرئيسي)، كتبدّل شي حاجة إلا الكليان بدّل رأيو، ومن بعد كتصيفطها كاملة مرة وحدة للكوزينة، ببون واحد لكل ستاسيون عوض بون لكل منتوج. هكا الكوزينة تقدر تبدا بكري، قبل الخلاص بمدة طويلة.

شنو كيوقع حتى هو ملي كتكليكي على صيفط الكوموند:

• الأطباق بالترتيب: الطبق 1 كيمشي ديريكت للكوزينة؛ الأطباق 2 و3 و4 كيمشيو معاه بحال تسنّى والكوزينة ما كتبداش حتى تعيّط على داك الطبق (شوف الأطباق بالترتيب).
• الطورنات: كل مرة كتصيفط الكوموند هي طورنة وحدة؛ وعلى هادشي كتخدم ↻ طورنة أخرى.
• السطوك كينقص والروبيني المعيّر كيتحل.
• All-you-can-eat: إلا كان بزاف، بكري بزاف ولا معطّل بزاف على الفورمولا، الكاسة كتسوّل اللول واش مسموح بيه واخا هكاك.
• بلجيكا (GKS 2.0): السطور كيمشيو اللول بحال پرو فورما للصندوق الكحل؛ إلا ما نجحش هادشي، ما كيمشي والو للكوزينة وكيبقاو جداد.
• ما كايناش الكونيكسيون: الكوموند كتتسجل وكتمشي للكوزينة غير ترجع الكونيكسيون. الطابعة طافية: الكوموند كتدوز واخا هكاك، والبون كيدخل لصف الطباعة (شوف طابعة الكوزينة طافية ولا ما كايناش شاشة الكوزينة).

تقدر تخلّص ديريكت حتى هي. إلا كليكيتي على خلّص الحساب وباقي كاينين سطور جداد فالحساب، الكاسة كتكوموندي هوما اللول أوتوماتيكيا، باش الكوزينة والبار ديما ياخدو البون ديالهم. يعني فالبار ولا فالتيك أواي ما محتاجش تكليكي اللول على صيفط الكوموند: كليكي على المنتوج وديريكت خلّص الحساب. إلا ما نجحش هاد الكوموند الأوتوماتيكي (ما كايناش الكونيكسيون، قاعدة all-you-can-eat، الصندوق الكحل)، شاشة الخلاص كتبقى مسدودة وكتشوف علاش.

ما بغيتيش تيكي للبار ملي كتخلّص ديريكت؟ فـالإعدادات → المحل → الطلب والخلاص شعل الخانة الخلاص ديريكت بلا تيكي ديال الخدمة. هكا غير داكشي اللي كتصيفطو بـصيفط الكوموند اللي كيمشي للكوزينة والبار؛ داكشي اللي كتخلّصو ديريكت ما كياخدش تيكي ديال الخدمة.

بوطون خلّص الحساب كبير ولا صغير

إلا علّمتي على بوطون كبير "خلّص الحساب"، فشاشة الكوموند كاين بوطون كبير خلّص الحساب نيشان تحت المنتوجات اللي تكوموندات: عريض، طويل وفيه المبلغ، باش تبرك عليه بالزربة. إلا تخلّص شي جوج من الحساب، البوطون كيبيّن شحال مازال. البوطون الصغير لتحت حدا صيفط الكوموند كيتحيّد.

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

فالتثبيت الجديد العلامة طافية: يعني البوطون الصغير لتحت حدا صيفط الكوموند وشاشة الخلاص ببوطونات عاديين. بغيتي كبير؟ علّم ف الإعدادات → المحل، نيشان تحت الثيم الفاتح/الغامق، على بوطون كبير "خلّص الحساب". الكاسة اللي كانت خدامة من قبل كتبقى بحال ما كانت. الاختيار كيصلاح لكاع الكاسات والتابليتات ديال المحل.

رد المنتوج "سالا" (تباع كامل)

أي واحد يقدر فشاشة الكوموند يضغط مزيان على منتوج (ولا يكليكي عليه بالكليك اليمين) ويختار سالا (مابقاش). المنتوج كيولّي رمادي وماكيبقاش يتكوماندا فجميع الكاسات. بنفس الطريقة كترجعو بـ متوفر من جديد. كل تبديل كيتسجّل فالسجل. المسؤول باقي يقدر يديرها حتى من الإعدادات → المنتوجات. حتى السيرفور ديال الكاسة كيرفض منتوج اللي داير "سالا" ("Cola" سالات)، إذن حتى من تابليت اللي مازال ماوصلاتوش التبديل ولا اللي حافظة كوموندات أوفلاين؛ داك التابليت كيبيّن "ماقدرناش نصيفطو".

شاشة الكوزينة (KDS)

زايد على (ماشي فبلاصة) الطابعات ديال تيكي الكوزينة، الكوزينة ولا البار يقدرو يخدمو بشاشة. حلّ فتابليت/پيسي فالكوزينة http://<kassaserver>:3000/keuken، دخل بالكود PIN وختار الستاسيون: هوما نفس السميات ديال الطابعات (الكوزينة، البار، ...)، إذن فالشاشة كيبان بالضبط داكشي اللي غادي يخرج فداك التيكي. "كلشي" كيبيّن جميع الستاسيونات.

• لكل كوموند تيكي، الأقدم هو اللول، فيه الطابلة/ياخدها معاه، النمرة وشحال هادي وهو كيتسنا (ليموني من بعد 10، حمر من بعد 20 دقيقة).
• الأطباق كيبانو بوحدهم؛ الطبق اللي مازال ماتعيّطش عليه كيبان رمادي بـ "كيتسنا التعياط". الستورنوات كيبانو مشطبين.
• ضغط على سطر باش تحطّو واجد، ولا على واجد للتيكي كامل. السيرفيس كيشوف فالبارة اللي فوق "الكوزينة: الطابلة 5 واجدة". بـ الإعدادات → المحل → شاشة الكوزينة → صوت للسيرفيس (عادةً مطفي) الكاسة كتعطي حتى بيپ ("دينگ-دونگ"، بلا فيشي ديال الصوت). البراوزر ماكيخلّيش الصوت غير من بعد أول ضغطة على الشاشة؛ علّي الصوت ديال التابليت.
• رجّع كيبيّن داكشي اللي تعلن واجد فآخر ساعة، داكشي اللي تحيّد بالغلط يقدر يرجع هكا.

الشاشة كتحدّث راسها ديريكت. تيكيات الكوزينة كيبقاو يتطبعو عادي؛ اللي ماكيخدمش بالشاشة ماغاديش يحس بشي حاجة.

الشاشة ديال الكوزينة: التدويز، الترتيب والطبق

الإعدادات → الطابعات → الشاشة ديال الكوزينة. كل جزء كيتشعل بوحدو، مطفي من الأول؛ إلا طفيتيه كيبقى كلشي محفوظ.

• التدويز بين الستاسيونات، مثلا بارد → سخون → التسليم. لكل ستاسيون كتحط ستاسيون ثابت من بعدو؛ فالتيكي كتبان بوطونة → سخون (وديما دوّز ل… باش تختار ستاسيون آخر). غير السطورا المحلولين ديال داك الستاسيون اللي كيمشيو. الستاسيون ما محتاجش طابعة: كتب ستاسيونات بحال التسليم ف ستاسيونات بلا طابعة. واجد (والتنبيه للسيرفيس) كيجي غير فالستاسيون الأخير. ف "كلشي" كيبان عند السطر المدوّز فين هو دابا. كل خطوة كتبان عند السطر وفالسجل.
• تبديل الترتيب: جرّ التيكيات (بالفأرة) ولا حرّكهم ب ◀ ▶ (التاتش). الترتيب كيصلاح لكل ستاسيون ولكاع الشاشات ديال داك الستاسيون؛ التيكيات الجداد كيجيو فالتالي.
• الطبق اللي من بعد من الشاشة ديال الكوزينة: عند تيكي فيه طبق كيتسنى كتبان طلب الطبق 2. السيرفيس كيوصلو "الكوزينة كتطلب الطبق 2 للطابلة 5" (مع الصوت) وكيعيّط بحال ديما؛ فالشاشة ديال الكوزينة كيبان "الطبق 2 تطلب · n د" حتى يتعيّط على الطبق. ولا ختار عيّط: الشاشة ديال الكوزينة كتعيّط على الطبق بوحدها، مع بون الخدمة "عياط الطبق 2"، بحال البوطونة فالكاسة.

طابعة الكوزينة مطفية ولا بلا شاشة الكوزينة

الكاسة ديما كتبقى خدامة، حتى إلا كانت الطابعة ديال الكوزينة ولا البار مطفية (ولا سالا الورق، ولا الكابل محلول) وحتى بلا شاشة الكوزينة:

• الكوموند ديما كتدوز. السطور كيتحطو ديريكت متكوماندين، الحساب صحيح والخلاص كيمشي عادي. الطابعات كيتعيّط عليهم فنفس الوقت وكل طابعة عندها تقريباً 4 ثانية ماشي كثر: الطابعة المطفية ماكتخلّيش الأخرين (ولا السيرفيس) يتسناو بزاف.
• لائحة الانتظار ديال الطبع. تيكي الكوزينة اللي ماقدرش يتطبع كيدخل للائحة الانتظار ديال الطبع. السيرفور ديال الكاسة كيعاود يجرّب كل 30 ثانية، لمدة ربع ساعة؛ غير ترجع الطابعة تخدم كيخرج، وفوق مكتوب LATER GEPRINT. إلا التيكي اللي من بعدو تطبع مزيان فداك الطابعة، التيكيات اللي كيتسناو كيخرجو ديريكت موراه.
• من بعد ربع ساعة كيحبس التجريب بوحدو؛ عاود طبع دابا باقي ممكن.
• شاشة الكوزينة. إلا كانت الكوموند فشاشة الكوزينة، الكوزينة كتشوفها تما حتى إلا كانت الطابعة مطفية. اللي ماكيخدمش بشاشة الكوزينة ماكيضيّع والو: الكاسة عمرها ماكتسنا "واجد" من الكوزينة.
• لائحة الانتظار كاينة غير فالميموار ديال السيرفور ديال الكاسة (من بعد ريديماراج كتولّي خاوية).
• حتى تيكي الكاسة: إلا ماتطبعش، الحساب راه تخلّص (الكاسة كتقول "الطبع ماخدمش") وتقدر من بعد تطبع نسخة فـ التيكيات.

الأطباق (المقبلات، الطبق الرئيسي ...)

البوطونات ديال الأطباق كيبانو غير إلا كان خاصهم: ملي كيكون شي مينو (منتوج مركب) فالكوموند، ولا إلا كانت شي حاجة ديجا فالطبق 2 حتى 4. مع المنتوجات العاديين، بحال كوكا، ما كتشوفهمش وكلشي كيمشي ديريكت للكوزينة. ما كاين والو باش تريگلي.

تحت لائحة الكوموند كاين الطبق 1 2 3 4. عادةً الطبق 1 شاعل وكلشي خدام بحال ديما: "كوماندي" كيصيفط كلشي ديريكت للكوزينة، بلا عناوين ديال الأطباق فتيكي الكوزينة. إلا ختاريتي الطبق 2 (ولا كثر) قبل ما تضغط على المنتوجات:

• كيمشيو مع "كوماندي" للكوزينة، تحت "-- الطبق 2 · كيتسنا التعياط --"، باش الكوزينة تقدر توجّد؛
• فلائحة الكوموند كيبان "الطبق 2 · كيتسنا" مع بوطون عيّط؛
• الكوزينة كتاخد مع التعياط تيكي " تعياط الطبق 2 " فيه داكشي اللي خاصو يتصاوب دابا.

الطبق 1 ديما كيمشي ديريكت. إلا كان الطبق 2 ديجا تعيّط عليه، الماكلة اللي تزادت من بعد ف الطبق 2 حتى هي كتمشي ديريكت.

الحساسيات لكل منتوج

عادةً مطفي: يعني المواد المسببة للحساسية مكيبانو فتا بلاصة. شعّلها من الإعدادات → المحل → عمّر وبيّن المواد المسببة للحساسية لكل منتوج.

• الإعدادات → المنتوجات: فكل منتوج علّم على الـ 14 مواد المسببة للحساسية ديال الاتحاد الأوروبي (الگلوتين، القشريات، البيض، الحوت، الكاوكاو، الصوجا، الحليب، الفواكه الجافة، الكرافس، الموتارد، الجنجلان، السولفيت، الترمس، الرخويات). فلائحة المنتوجات كيبانو الاختصارات من مور السمية.
• شاشة الكوموند: فكل بوطون ديال منتوج كتبان الاختصارات صغار (مثلاً Gl Me)، والبوطون ⚠ المواد المسببة للحساسية فبارة الگروبات كيبيّن لكل منتوج من الگروب المختار المواد المسببة للحساسية كاملين، مع الشرح ديال الاختصارات.
• التبديلات ديال المواد المسببة للحساسية كتسجّل فالسجل (القديم → الجديد). إلا كان الإعداد مطفي، المواد اللي تعمّرو من قبل كيبقاو محفوظين.

All-you-can-eat

عادةً مطفي. شعّلها من الإعدادات → المحل → All-you-can-eat (غير المسيّر). كتصاوب وحدة ولا كثر من العروض، مثلاً حوت، لحم وسوشي، كل واحد فيه:

• سمية (كتبان فالتيكي: "حوت كبير"، "حوت صغير")؛
• ثمن للكبير وللصغير (بالـ TVA) والتعريفة ديال TVA (عادةً NL LAAG، BE B)؛
• الأطباق اللي داخلة فيه (€ 0): گروبات ديال المنتوجات كاملين و/ولا منتوجات بوحدهم (حتى من گروبات أخرين، مثلاً فريت فالحوت واللحم بجوج)؛
• حد ديال الوقت بالدقايق (0 = بلا)؛
• الدورات: ماشي كثر من هاد العدد ديال الأطباق لكل شخص فكل دورة (0 = بلا حد) وعلى الأقل هاد العدد ديال الدقايق بين جوج دورات (0 = بلا)؛
• زيادة على التبذير لكل حبة (0 = بلا).

بـ ↑ ↓ كتحط الترتيب. كيتحسب إلا كان شي طبق داخل فكثر من عرض: كيمشي للعرض اللي لفوق اللي ختارو الگروب. مسح كيحيّد العرض للطوابل الجداد؛ الطوابل اللي خدامين كيبقاو عندهم السطور ديال الثمن (تقدر تنقص الناس تما، ولكن ماتزيدش).

فالطابلة:

• ف شاشة الطلب فوق التيكي كاين + All-you-can-eat. ختار لكل فورمول عدد الكبار والصغار؛ تقدر تخلط (مثلاً 2× حوت و2× لحم). الثمن كيجي سطورا ف الحساب؛ هادو ما كيمشيوش للكوزينة. عدد الناس ديال المجموعة كيولي هو المجموع ديال اللي مشاركين (إلا الكاسة كاتسجل عدد الناس).
• البارة كتبيّن لكل عرض: الناس، الوقت اللي باقي (حمر إلا سالا الوقت)، شمن دورة هادي مع الماكسيموم، وشحال باقي للدورة الجاية. الأطباق اللي داخلة فيه كيبانو فالبوطونات بـ AYCE وفالتيكي بالليبيل AYCE بـ € 0. كلشي اللي ماداخلش فحتى عرض مختار (المشروبات، الديسيرات ...) كيبقى بالخلاص عادي.
• كوماندي: كل مرة "كوماندي" فيها أطباق فابور كتحسب دورة، لكل عرض (غير العروض اللي فيها أطباق من داكشي). اللي تضغط عليه أوفلاين وتصيفط من بعد ماكيتحبسش.
• بدّل: بدّل الأعداد لكل عرض. نقصان الناس كيتحسب ستورنو (الحق "ستورنو"). تحط عرض على 0 (ولا حبس لكلشي) ممكن غير إلا مازال ماكاين حتى طبق من داك العرض فالحساب.
• الزيادة (غير إلا كان شي عرض مختار فيه زيادة على التبذير): ختار العدد (والعرض، إلا كانو كثر من واحد)؛ "زيادة على التبذير × العدد" كتدخل فالحساب.
• خلاص الحساب، القسمة، التخفيضات والتيكي خدامين بحال ديما: أثمنة العروض، الزيادة والمشروبات هوما سطور عاديين بالـ TVA ديالهم.
• إلا طفى المسؤول all-you-can-eat وكاينين گروبات باقي كياكلو، الأطباق الجداد اللي تضغط عليهم كيرجعو بالثمن العادي؛ داكشي اللي ديجا فالحساب كيبقى.
• ف المتجر ديال الأنترنيت (اختياري، عادةً مطفي): مع حتى ملي كيكوماندي على الطابلة بالـ QR-code (المتجر ديال الأنترنيت) الكليان اللي كيكوماندي من طابلة فيها عرض كيشوف الأطباق ديال داك العرض بحال داخلين ب € 0، ولفوق كيبان الحال (الناس، الدورة، الوقت). كل كوموند هي دورة، بنفس القواعد ديال كوماندي؛ إلا كان بزاف، بكري بزاف ولا معطّل بزاف، المتجر ديال الأنترنيت كيرفضها ديريكت. الشراب والأطباق الخرين كيخلّصهم الكليان عادي؛ كلشي كيمشي للحساب ديال الطابلة. مطفي = المتجر ديال الأنترنيت كيحسب الأثمنة العادية، بحال قبل.

بونات كادو

جوج ديال الأزرار فـ الإعدادات → المحل → بونات كادو:

• بون كادو كطريقة ديال الخلاص ملي تخلّص الحساب: عادةً شاعل، بحال ديما. مطفي = البوطون بون كادو ماكيبانش فالخلاص (وماكيبانش فـ رجّع الفلوس عن طريق فالرجوع)، والسيرفور ديال الكاسة كيرفض الخلاص ببون كادو.
• بيع بونات كادو بالرصيد: عادةً مطفي. شاعل:
  • فشاشة الكوموند كاين البوطون بون كادو: ختار المبلغ (€ 10، 25، 50، 100 ولا مبلغ آخر) وخلّي الكاسة تصاوب كود، ولا سكاني الكود ديال كارطة مطبوعة من قبل. البون كيدخل كسطر فالحساب (كود TVA BON: ماشي رقم معاملات، بلا TVA، ماكيمشيش للكوزينة). تما تقدر حتى تشوف الرصيد لشي كليان.
  • من بعد الخلاص البون كيولّي خدام والطابعة ديال التيكيات كتطبع بون كادو فيه المبلغ، الكود وكود QR.
  • الاستعمال: ملي تخلّص الحساب ختار بون كادو وسكاني ولا كتب الكود (البوطون الرصيد كيبيّن الرصيد). المبلغ كيتنقص من الرصيد. إلا كان الرصيد قل من الحساب، الرصيد كامل كيتنقص كخلاص بالجزء والباقي كتخلّصو بلكارط ولا كاش. الرصيد يقدر يتصرف على مراحل.
  • خلي الكود خاوي = بون كادو بلا كود، بحال قبل (مثلاً بون قديم ديال الورق).
  • الرابور → بونات كادو (الحق تسيير بونات كادو، عادةً المانيجر والمسؤول): قلّب بالكود، الرصيد اللي باقي، التاريخ ديال كل بون، بلوكي (ضاع/تسرق) وصحّح الرصيد مع سبب. هادشي كيتسجّل فالسجل.
  • الرابورات: بونات كادو المبيوعة ماكتحسبش رقم معاملات وكيبانو بوحدهم (بونات كادو مبيوعة)؛ الفلوس اللي توصلتي بيها كتبان فطرق الخلاص. داكشي اللي كيتخلّص ببون كادو هو رقم معاملات عادي (بالـ TVA) فطريقة الخلاص بون كادو.
  • المحاسبة: البونات المبيوعة كيمشيو credit والبونات المستعملة debet فالحساب بونات كادو (رصيد الكليان).
  • بون كادو مبيوع يقدر يرجع من التيكيات → رجوع، مادام مازال ماتستعملش (الرصيد = القيمة). من بعد الرجوع البون كيتلغى (الرصيد 0، مبلوكي؛ كيبان فالتاريخ ديال البون). إلا كان ديجا تستعمل (شي جزء)، كتحط الرصيد على 0 فـ الرابور → بونات كادو وكترجّع الباقي بوحدو. التخفيض على بون كادو مايمكنش.

رصيد كيتشارجا (اختياري)

للكلوبات، الكانتينات ديال الرياضة، دور الشباب والإيفينمات: بون كادو بالصولد كيولّي كارطة كتشارجا. كتشعلها ف الإعدادات ← المحل ← رصيد كيتشارجا، تحت بونات كادو (عادةً مطفي؛ كيخدم غير إيلا كان بيع بونات كادو بالصولد شاعل).

• كارطة ولا براسلي: بيع بون كادو مع كارطة مطبوعة من قبل وسكاني الكارطة (لكتور NFC/RFID اللي كيخدم بحال الكلافيي، ولا كود بار). النمرة ديال الكارطة كتولّي هي الكود؛ وبيها كيخلّص الضيف بحال بون كادو.
• الشارج: شاشة الكوموند ← بون كادو ← شارجي الرصيد: سكاني البون ولا الكارطة ودخّل المبلغ. كيدخل كسطر فالحساب (كود TVA BON: ماشي رقم معاملات، بلا TVA، بحال بون كادو اللي تباع) ومن بعد ما تخلّص كيولّي فالصولد. فالتاريخ ديال البون كيبان تشارجا.
• أكبر صولد لكل بون ولا كارطة (عادةً € 500، تقدر تريڭلو حتى € 5.000).
• رجّع الباقي (كوشة، عادةً مطفية؛ الصلاحية تسيير الكاشير ديال الفلوس): من بعد شوف الصولد كيبان رجّع الباقي. الصولد كيولّي € 0 والمبلغ كيبان ك خرّج فلوس من التيروار فالرابور X وZ (Tegoed terugbetaald …).
• الشارج يقدر يترجع عن طريق التيكيات ← الرجوع ما دام الصولد باقي فيه على الأقل داك المبلغ؛ البون ولا الكارطة كيبقاو صالحين.
• الشارج فالكيوسك (اختياري): شوف كيوسك الخدمة الذاتية.

بونات الماكلة

غير للمحلات اللي فبلجيكا، عادةً مطفي: الإعدادات → المحل → خلّص الحساب → بونات الماكلة. بونات الماكلة هوما امتياز فالخلصة: المشغّل كيحطهم فكارط ديال الخدّام (Edenred، Monizze ولا Pluxee). الضيف كيخلّص بيها فالتيرمينال ديال الخلاص العادي؛ ما خاص حتى ربط مع الشركات المُصدِرة.

• مشعول: فاش تخلّص الحساب كاين البوطون بون الماكلة. ختار الشركة المُصدِرة (غير الشركات اللي كيقبلها المحل) وخلّي الضيف يقرّب الكارط من التيرمينال ديال الخلاص، بحال الخلاص بلكارط. بلا ربط مع التيرمينال: الضيف كيخلّص فالتيرمينال ديال الخلاص براسو ونتا كتبرك على خلّص الحساب.
• بلا بوربوار وبلا صرف مع بونات الماكلة. إلا كان الصولد ناقص، الضيف كيخلّص الباقي بطريقة أخرى (الحساب كيبقى محلول حتى يتخلّص كلشي).
• غير لشي مجموعات ديال المنتوجات (اختياري، مثلا الماكلة ولكن ماشي الكحول): فهاد الحالة ببونات الماكلة ما يمكنش يتخلّص كتر من المبلغ ديال هاد المنتوجات فالحساب. شاشة الخلاص كتقول شحال؛ الباقي كيخلّصو الضيف بطريقة أخرى.
• فالتيكي ديال الكاسة: بون الماكلة Pluxee (مع الشركة المُصدِرة من موراه).
• الرابور Z والرابور X: سطر بوحدو لكل شركة مُصدِرة (بون الماكلة Edenred، … Monizze، … Pluxee).
• المحاسبة: حساب بوحدو فالدفتر الكبير لكل شركة مُصدِرة (بونات الماكلة Pluxee (للتوصّل) وهكذا، عادةً 416100، 416200 و416300)، حيت الفلوس كتجي من الشركة المُصدِرة ماشي من البنكة ديال التيرمينال ديال الخلاص.
• خاصك: عقد مع كل شركة مُصدِرة اللي كتقبل البونات ديالها، وتيرمينال ديال الخلاص اللي كيقبل هاد الكارطات (سوّل على هادشي اللي كيبيع ليك التيرمينال ديال الخلاص).

العملة الأجنبية

الخلاص كاش بعملة أخرى، بحال للسياح البريطانيين ولا الأمريكيين، ولا فالمناطق الحدودية بالفرنك السويسري. عادةً مطفي: الإعدادات → المحل → خلّص الحساب → العملة الأجنبية. زيد العملات (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) ولكل عملة سعر الصرف: شحال من أورو كتحسب على 1 وحدة (مثلا 1 GBP = € 1,15).

• مدخّل باليد: سعر ثابت؛ بدّلو بيدك إلا تبدّل.
• مباشر (ECB): سعر الصرف ديال النهار من البنك المركزي الأوروبي (أسعار مرجعية، كل نهار خدمة تقريبا مع 16:00؛ فابور، ما خاصك حتى حساب). مع هامش بالمية (0-20) كينقص السعر بداك القدر، باش المحل ما يخلّصش الصرف من جيبو. الكاسة كتجيب الأسعار بوحدها إلا كانو قدم من 6 سوايع؛ حدّث دابا كيجيبهم دغيا. بلا أنترنيت كيبقى آخر سعر.
• شاعل: ملّي تخلّص الحساب كاينة البوطونة العملة الأجنبية. ختار العملة؛ الكاسة كتورّي شحال كيجي بهاد العملة. دخّل شحال عطا الضيف: الكاسة كتحسب وكترجّع الصرف بالأورو. إلا الضيف ما بغا والو يرجع، شعّل الصرف بوربوار: الصرف كيدخل كبوربوار فالتيكي، وفبلجيكا بداك العملة (GKS 2.0، UC296).
• إيلا عطا الضيف قل من المبلغ كامل، راه جزء؛ الباقي كيخلّصو بطريقة أخرى.
• فالتيكي: العملة، المبلغ وسعر الصرف، والصرف بالأورو.
• الرابور X وZ: سطر بوحدو لكل عملة (العملة الأجنبية GBP، بالأورو)، وعند الكاشير ديال الفلوس شنو كاين فالكاشير بهاد العملة. الصرف بالأورو كينقص من الفلوس اللي خاصها تكون فالكاشير؛ العملات براسهم كتحسبهم بوحدك.
• المحاسبة: كيتحسب كاش (الكاسة)، بالأورو.

بوطونات زايدين فالطلب والخلاص

بوطونات لحوايج ماشي كل محل محتاجهم. كلشي مطفي من الأول؛ كتشعّل كل بوطونة ف الإعدادات → المحل → الطلب والخلاص (الحق ضبط المحل، الخلاص والطابعات). مطفي = البوطونة ما كايناش فحتى بلاصة فالكاسة والسيرفور ديال الكاسة كيرفض العملية. فهولندا كلشي خدام بلا الصندوق الكحل؛ فبلجيكا البوطونة ما كتخدمش حتى تكون داك الخاصية تجرّبات مع الصندوق الكحل (كيبان حدا البوطونة إلا مازال).

ملي كاتحل طبلة:

• تسجيل عدد الناس: السؤال "شحال من واحد؟" ف طبلة خاوية، عدد الناس ف البلان وف شاشة الطلب، والضياف ف الرابورات. شوف عدد الناس.

فالطلب (شاشة الطلب، للّي كتكليكي عليه من بعد):

• جمع نفس المنتوجات (بلا بوطونة، افتراضياً مشعولة): إلا ضغطتي على نفس المنتوج مرة أخرى (نفس الخيارات، مازال ما تطلبش)، العدد كيطلع عوض سطر جديد: 4 Cola فسطر واحد بالثمن ضرب 4. ب− كينقص واحد عاوتاني، حتى إلا كان تطلب من قبل (ستورنو ديال واحد). مع ملاحظة، كرسي ولا للدّي كيبقى سطر بوحدو؛ داكشي اللي تطلب من قبل كيبقى سطر بوحدو (دورة جديدة).
• − و + (قبل الثمن ف كل سطر): − كينقص واحد، + كيزيد واحد (نفس المنتوج، الخيارات والملاحظة؛ إلا كان جمع نفس المنتوجات طافي، سطر جديد). إلا مازال ما تطلبش ووصل ل 0: السطر كيتحيّد. إلا تطلب من قبل: نقص واحد هو ستورنو، والسطر كيبقى مشطّب (للكوزينة وللرابورات)؛ زيد واحد كيولّي سطر جديد خاصو يتطلب. الضغط على الثمن براسو ما بقاش كيحيّد والو. فالمنيو غير −.
• ناخدها معايا (غير فالمحل): الضيف كياخد هاد المنتوج معاه، مثلا قرعة ديال الما ولا ديسير. داك السطر كياخد TVA ديال الطلبيات اللي كتّاخد (فبلجيكا label C)، والباقي ديال الحساب TVA ديال فالمحل. فالتيكي كيبان معاه حدا السطر.
• الكرسي (فطابلة): كليكي باش تدوز للكرسي 1، 2، 3 ...؛ السطورة كياخدو النمرة ديال داك الكرسي (حتى فبون الخدمة). فبلجيكا كل سطر كيمشي مع مركز التكلفة ديال الكرسي (CHAIR، UC4123) للصندوق الكحل. مرة أخرى من بعد الكرسي 12 = بلا كرسي من جديد.
• استرجاع: المنتوج الجاي كيتزاد ب -1، مثلا قرعة ولا كاس خاوي (الكونسينيا). هادشي ممكن غير للمنتوجات اللي فيهم يقدر يرجع (الكونسينيا) (الإعدادات → المنتوجات). إلا كان الحساب كامل ناقص (غير الكونسينيا راجعة، بلا بيعة)، خلّص الحساب كيولّي ترجيع الفلوس: كاش ولا بلكارط (كيترجعو فالطرمينال براسو). فبلجيكا كترجيع (REFUND، UC4108 و UC4114).
• بدّل SPV: الضيف كيخلّص منتوج ولا مونيو ب single purpose voucher (بون ديال داك المنتوج بالضبط، مثلا "1 menu all-in"). كليكي على بدّل SPV ومن بعد على المنتوج فالتيكي: كيتزاد ب -1 (نفس الثمن و TVA، ومع المكوّنات فالمونيو)، و SPV حداه. ما كيمشيش للكوزينة؛ وتقدر تحيّدو عادي. منتوج البون كتبيعو قبل بحال منتوج عادي؛ زيد ليه ف الإعدادات → المنتوجات SPV (بون). فبلجيكا السطر كيمشي فالبيعة ك VOUCHER للصندوق الكحل (UC271).
• حساب التسبيق: شوف لتحت.
• ثمن مفتوح (ماشي بوطونة، لكل منتوج): لمنتوج فيه ثمن مفتوح الكاسة كتسوّل على الثمن، مثلا طبق النهار ولا تسبيق.

فالخلاص:

• الخلاص ديريكت بلا تيكي ديال الخدمة (ماشي بوطونة): عادةً خلّص الحساب كيصيفط الأول داكشي اللي مازال ما تصيفطش، باش الكوزينة والبار ديما ياخدو التيكي ديالهم (شوف البوطونة صيفط الكوموند). مشعول: داكشي اللي كتخلّصو ديريكت بلا ما تضغط الأول على صيفط الكوموند ما كياخدش تيكي ديال الخدمة، مثلاً فالبار فين كتجيبو بيدك. داكشي اللي تصيفط من قبل ما كيتبدلش.
• خلّص بوحدو (فطابلة، ف قسم الحساب): ختار شنو كيخلّص ضيف واحد دابا، حتى جزء من سطر (½ لنص قرعة). هادشي كيولّي جزء بوحدو كتخلّصو دغيا؛ الباقي كيبقى على الحساب، بلا ما تقسم الحساب قبل ولا تنقلو لمجموعة أخرى. التخفيض بالبورسونطاج على التيكي كامل كيمشي معاه بالنسبة. رجع بلا خلاص = كلشي كيرجع للحساب. فبلجيكا البيعة كتبقى فبلاصة الطابلة، بلا تبديل الطابلة (UC4103bis، UC4104).
• الضيف مشا بلا ما يخلّص (الحق سدّ بلا خلاص، من الأول غير المدير والمسؤول): الحساب كيتسدّ كبيعة بلا خلاص، مع السبب فالسجل. فالرابور X و Z وفالكشف ديال النهار كيبان ك ما تخلّصش (الضيف مشا)؛ فالجورنال ل ما يمكنش يتجمع (من الأول 4985 / 643000). فبلجيكا بيعة بلا خلاص (UC4109).

من بعد (التيكيات):

• صحّح الثمن (الحق صحّح الثمن ديال تيكي، من الأول غير المدير والمسؤول): الثمن ديال تيكي متخلّص ما كانش صحيح، مثلا 50% تخفيض فبلاصة 5%. الكاسة كتصاوب تيكي جديد بلا طابلة فيه السطورة ديال التيكي القديم راجعين (بالناقص، بالثمن اللي تخلّص ديك الساعة) ونفس المنتوجات من جديد بالثمن العادي. عطي تما التخفيض الصحيح وخلّص الفرق (ولا رجّع الفلوس إلا كان الثمن الجديد قل). التيكي القديم كيبقى كيف كان؛ مرة وحدة لكل تيكي، وماشي إلا شي حاجة رجعات منو. فبلجيكا السطورة القدام كيمشيو ك CORRECTION (UC4116).

الكود: apps/pos-server/src/lib/kassaopties.ts، routes/kassaopties.ts؛ الشاشة KassaOpties.tsx. السجل: الإعداد تبدّل، SPV تبدّل، صحّح التيكي، ما تخلّصش.

حساب التسبيق

التسبيق (العربون، مثلا لحفلة ولا ريزيرفاسيون) كتبيعو بحال منتوج عادي مع التسبيق شاعل (الإعدادات → المنتوجات؛ ديما عندو ثمن مفتوح). دير واحد لكل نسبة ديال TVA إلا التسبيق خاصو يكون على حساب النسبة (مثلا تسبيق الماكلة و تسبيق المشروبات)، ولا منتوج واحد إلا كان جزء من الدوفي. الضيف كيخلّص التسبيق قبل وكياخد تيكي.

التشعيل: الإعدادات → المحل → الطلب والخلاص → حساب التسبيق (من الأول مطفي). فالخلاص الأخير كتكليكي فشاشة الطلب على حساب التسبيق وكتدخّل النمرة ديال التيكي ديال التسبيق. الكاسة كتحط السطورة ديال التسبيق من داك التيكي بعدد ناقص على الحساب (نفس المنتوج، الثمن و TVA). اللي تحسب ما يمكنش يتحسب مرة أخرى. إلا كان التسبيق كثر من الحساب، الضيف كياخد الفرق (ترجيع الفلوس). فبلجيكا السطورة المحسوبة كيمشيو كترجيع (REFUND) للصندوق الكحل (UC4110، UC4111، UC4113). السجل: التسبيق تحسب.

التيكي فالإيميل

عادةً مطفي. شعّلو من الإعدادات → المحل → التيكي حتى بالإيميل.

SMTP_HOST=smtp.voorbeeld.nl
SMTP_PORT=587
SMTP_GEBRUIKER=kassa@voorbeeld.nl
SMTP_WACHTWOORD=...
SMTP_AFZENDER=bon@voorbeeld.nl

عاود شعّل الكاسة من بعد ما تعمّر. من بعد فـ خلّص الحساب كيبان الخانة صيفط التيكي حتى بالإيميل (اختياري): خليها خاوية = غير الطبع بحال ديما؛ عمّر إيميل = نفس التيكي (مع التفصيل ديال TVA والسطور الجبائية) كيمشي حتى بالإيميل للكليان، والسمية ديال المحل هي المرسل.

• الإيميل ماكيتحفظش؛ فالسجل كيبان غير "التيكي N تصيفط لـ a***@domein.nl" وواش نجح.
• إلا ماخدمش الإيميل (مثلاً معلومات الدخول غالطين)، الحساب راه تخلّص والتيكي تطبع عادي؛ الميساج كيقول شنو اللي ماخدمش.
• ماشي فالخلاص بالجزء (قسمة الحساب): التيكي كيخرج مع آخر خلاص، إذن تما كتعمّر الإيميل.
• الإرسال من بعد: فـ التيكيات كاين حدا كل تيكي البوطون صيفط بالإيميل (الحق طبع نسخة من التيكي). كيصيفط التيكي مكتوب فيه KOPIE، بحال نسخة مطبوعة (فبلجيكا كيتسجّل كنسخة).
• ماخاصك حتى باكيج زايد: الكاسة كتهضر بوحدها مع السيرفور ديال الإيميل (STARTTLS على 587، TLS على 465).

الريزيرفاسيون

شعّلها من الإعدادات → المحل → الريزيرفاسيونات (عادةً مطفي). تما كتحدد حتى من شحال ديال الدقايق قبل كتبان الطابلة المحجوزة فالپلان (عادةً 60) والمدة العادية ديال الريزيرفاسيون (عادةً 120 دقيقة).

• البوطون الريزيرفاسيونات فالبارة اللي فوق: نظرة على كل نهار (◀ ▶)، فيها العدد ديال الريزيرفاسيونات، الناس والـ no-shows. + ريزيرفاسيون جديدة: السمية، التيليفون، الإيميل، الناس، التاريخ، الساعة، المدة، الطابلة (من بعد ممكن) وملاحظة. الريزيرفاسيون كيديرها الخدّامة؛ الحجز أونلاين مازال ماكاينش.
• إلا كانت شي ريزيرفاسيون ديجا على نفس الطابلة فداك الوقت، الكاسة كتقولها ليك؛ "سجّل وخلاص" ممكن.
• التأكيد بالإيميل (علامة، ولا من بعد "صيفط بالإيميل") إلا كان كاين إيميل وسيرفور ديال الإيميل (SMTP_HOST، شوف التيكي بالإيميل).
• فالپلان الطابلة الخاوية المحجوزة كتبان موف مع "R 19:30 العلوي (4)". إلا ضغطتي عليها: "العلوي وصل" كيحلّ الطابلة بـ 4 ديال الناس و"العلوي" كسمية الگروب؛ "كليان أخرين" كيحلّها عادي.
• فالنظرة العامة: وصل (كيحلّ الطابلة؛ إلا ماكانتش طابلة كتختار وحدة هي اللولة)، بدّل، No-show، لغي ورجّع. كلشي كيتسجّل فالسجل.
• الحجوزات ديال المنصات أونلاين: شوف منصات الحجز لتحت.

ربط TheFork مع الكاسة: الطابلة كتحل ملي يوصل الضيف، والحساب كيرجع

بـ POS-API ديال TheFork الكاسة كتخدم مع TheFork Manager (عادةً مطفي)، زيادة على جلب الريزيرفاسيونات اللي فوق. كيتشعل ف الإعدادات → منصات الحجز → ربط TheFork مع الكاسة؛ كيدوز عبر بوابة الإدارة.

• إلا درتي ضيف ف TheFork Manager على وصل ولا على الطابلة، كتحل ف الكاسة الطابلة اللي عندها نفس السمية، مع عدد الضياف وملاحظة: السمية، الحساسية والريجيم، العربون، العرض/الريميز ونقط الوفاء (Yums). إلا كانت ديجا كوموند محلولة على هاد الطابلة، كتتربط بيها. ما كايناش طابلة بهاد السمية: كيبان ميساج، وف المنصات كتختار الطابلة.
• من بعد الخلاص الحساب كيمشي لـ TheFork (المجموع والسطورة مع السمية، مجموعة المنتوج، الكمية والمبلغ)؛ ومن بعد TheFork كيدير الريزيرفاسيون على مشى. ف الخلاص المقسوم حساب واحد بالمجموع. إلا ما نجحش، الكاسة كتعاود كل ربع ساعة (جوج أيام)، ولا بـ عاود صيفط ف المنصات.
• الربط: الكاسة كتبيّن كود الربط؛ دخلو ف TheFork Manager (التكاملات → الكاسة). الـ id ديال الريسطو ف TheFork (Customer-id) كيدخلو المسؤول، ولا كيجي بوحدو مع أول كوموند.
• الخيارات: حل الطابلة بوحدها، السمية، الحساسية والعربون كملاحظة، الحساب لـ TheFork.
• الشرط: Pin Voordeel عندها مفتاح API ديال TheFork (غير للشركاء) وسجلات الكاسة تما بحال POS (بوطونة ف بوابة الإدارة)؛ TheFork كيشعل الربط من بعد جلسة تيست.

الوثائق ديال TheFork: https://docs.thefork.io/POS-API/introduction

لائحة الانتظار ل walk-ins

للكليان اللي بلا ريزيرفاسيون وكيتسناو طابلة. شعّلها من الإعدادات → المحل → لائحة الانتظار (walk-ins) (عادةً مطفي). كتبان غير إلا كان الـ SMS عن طريق CM.com مضبوط؛ وإلا لائحة الانتظار ماكتبان فتا بلاصة فالكاسة (حتى فالإعدادات). كتخدم بوحدها بلا الريزيرفاسيونات: حتى إلا كانو مطفيين. تما كاين حتى النص ديال الـ SMS (خاوي = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"؛ {naam}، {zaak} و{personen} كيتعمّرو بوحدهم).

• البوطون لائحة الانتظار فالبارة اللي فوق، مع العدد ديال اللي كيتسناو (ليموني إلا كان شي واحد كيتسنا). + زيد للائحة الانتظار: السمية، التيليفون (للـ SMS)، الناس، وقت الانتظار اللي تقال وطلب خاص (التيراس، كرسي ديال الدراري).
• اللائحة مرتبة على حساب التسجيل، مع شحال هادي وكل واحد كيتسنا (حمر إلا طوّل كثر من اللي تقال) وفوق العدد ديال اللي كيتسناو، الناس والمعدل ديال وقت الانتظار ديال اليوم.
• إلا ماتصيفطش الـ SMS، السبب كيبان حداه. عاود صيفط الـ SMS ممكن.
• جلّس: ختار الطبلة؛ الكاسة كاتحلها بعدد الناس (إلا الكاسة كاتسجل عدد الناس) وبالسمية كسمية ديال المجموعة (بحال شي ريزيرفاسيون اللي وصلات).
• مشا (خرج ولا لغى) ورجّع. تحت اللائحة كيبان شكون تجلّس ولا مشا اليوم، مع شحال تسناو.
• الخصوصية: نمر التيليفون كيتمسحو من بعد نهار؛ اللي باقي فاللائحة من بعد 12 ساعة كيخرج منها بوحدو. التسجيل، التعياط (غير بآخر 3 أرقام ديال النمرة) والتجليس كيتسجّلو فالسجل.
• علاش ماشي مع الريزيرفاسيونات؟ الريزيرفاسيون هي لمن بعد (التاريخ، الساعة، الطابلة من قبل)؛ لائحة الانتظار هي لدابا (الترتيب، وقت الانتظار، SMS ملي تخوا الطابلة). داكشي علاش عندها الزر والبوطون ديالها، مع نفس "حلّ الطابلة" بحال فالريزيرفاسيون.
• لائحة الانتظار أونلاين (اختياري، عادةً مطفي؛ غير مع المتجر ديال الأنترنيت): مع الكليان يقدرو يتسجلو براسهم حتى عبر المتجر ديال الأنترنيت كتبان ف المتجر ديال الأنترنيت لائحة الانتظار (وكاين ليها QR-code عند الباب، ف الإدارة ديال المتجر ديال الأنترنيت عند الطوابل و QR). الكليان كيعمّر السمية، التيليفون، الناس وطلب خاص، وكيشوف البلاصة ديالو مباشرة. ف الكاسة كيبان ف اللائحة مع أونلاين؛ العيطة، التقعاد والخروج بحال ديما، والكليان كيشوف حتى هو هادشي ف التيليفون ديالو (ويقدر يلغي التسجيل من تمّا).

كارطة الكليان / نقط الفيدليتي

شعّلها من الإعدادات → المحل → كارطة الكليان / نقط التوفير (عادةً مطفي، وعاد ما كيبان منو والو فتا بلاصة). تما كتحدد حتى: النقط لكل أورو (0 = غير كارطات الطوابع)، من بعد شحال ديال النقط كاين كادو وشحال ديال الأورو تخفيض فيه داك الكادو.

• فالكاسة، الفوق ديال التيكي كاينة "+ كارط الوفاء": قلّب على الكليان بالسمية ولا رقم التيليفون، ولا زيد كليان جديد (السمية، والتيليفون والإيميل اختياري). من بعد كتبان السمية مع رصيد النقط فالتيكي.
• الصرف: إلا كانو النقط كافيين "صرف 100 نقطة: € 5 تخفيض"؛ إلا كانت كارط الطوابع عامرة "قهوة فابور" (خاص القهوة تكون فالتيكي). هادشي كيولّي سطر ديال التخفيض؛ أي واحد يقدر يحيدو عاوتاني.
• النقط والطوابع كيتزادو ولا كيتنقصو غير ملي كتخلّص الحساب: النقط على المبلغ من بعد التخفيض (بلا البونات كادو اللي تباعو)، والطوابع على كل حبة من منتوج عندو كارط الطوابع (المنتوج اللي فابور ما كيتحسبش).
• فالتيكي ديال الكاسة: اللي تجمع، اللي تصرف، الرصيد وفين وصلات كارطات الطوابع.
• الرابور → الكليان (الصلاحية تسيير كارط الوفاء): قلّب على الكليان، بدّل المعلومات، صحّح النقط (مع السبب)، التاريخ، و مسح (AVG/RGPD: السمية، التيليفون والإيميل كيتمسحو؛ التاريخ كيبقى بلا سمية). لتحت كاينين كارطات الطوابع لكل منتوج (مثلا 10 قهوة = 1 فابور).
• الريتور ما كيرجّعش النقط اللي تجمعو أوتوماتيكيا؛ صحّحهم إلا كان خاص فـ الرابور → الكليان.
• كارط الفيدليتي بنمرة (اختياري): دخّل نمرة الكارطة فالرابور ← الكليان ← (الكليان) (ولا سكاني الكارطة فداك الخانة). مع سكانير الباركود، السكان ديال داك الكارطة كيربط الكليان بالتيكي، فالكاسة وفالكيوسك. التقليب بنمرة الكارطة ممكن حتى ف+ كارطة الكليان.

بروفايل الضيف: VIP، الماكلة اللي بغا والتفضيلات (اختياري)

كيتشعل فالإعدادات → المحل → بروفايل الضيف، تحت كارط الفيدليتي (بشكل افتراضي مطفي؛ خدّام غير إلا كانت كارط الفيدليتي شاعلة). من بعد:

• فشاشة الكوموند كتبان تحت الكليان المربوط "+ بروفايل الضيف": علّم على VIP، ختار الماكلة اللي بغا (نباتي، نباتي كامل، نباتي كياكل الحوت، حلال، كوشير) والحساسيات (ال 14 ديال المواد اللي كتسبّب الحساسية)، وكتب التفضيلات (مثلاً "طابلة ثابتة حدا الشرجم"، ماشي كتر من 300 حرف). من بعد كيبانو عند الكليان فشاشة الكوموند، والحساسيات بالحمر. تقدر تبدّلهم حتى فالرابور → الكليان → (الكليان) → بروفايل الضيف.
• إلا ضغطتي على منتوج فيه مادة اللي كتسبّب الحساسية للضيف (شوف الحساسيات لكل منتوج)، الكاسة كتسوّلك هي الأولى واش تزيدو واخا هكا. غير على حساب داكشي اللي معمّر فالمنتوج؛ إلا شكّيتي ديما سوّل الكوزينة.
• VIP كياخد ★ فبلان الصالة: عند حساب محلول وعند الريزيرفاسيون ديال داك الكليان اللي باينة. ملي كيدخلو الضياف ديال شي ريزيرفاسيون، الكاسة كتربط الكليان ديال الريزيرفاسيون مع الحساب.
• الماكلة اللي بغا والحساسيات (وVIP) كيبانو فتيكي الكوزينة للكوزينة والبار: GAST: VIP · Vegetarisch · allergie: Noten.
• الماكلة اللي بغا والحساسيات معلومات ديال الصحة: عمّرهم غير بموافقة الضيف. فالسجل كيتكتب غير بلي البروفايل تبدّل، ماشي الطلبات براسهم. ملي كتمسح الكليان كيتمسح حتى بروفايل الضيف.

المفضّلين / البوطونات السريعة

من الأول مطفي. الإعدادات → المحل → المفضّلين / البوطونات السريعة:

• اللي تباع كتر: فالأول ديال البار ديال المجموعات كاينة البوطونة ★ المفضّلين فيها الـ 12 منتوجات اللي تباعو كتر فالـ 14 أيام اللي فاتو (كتتحدّث بوحدها). شاشة الكوموند كتحلّ على المفضّلين.
• ختار براسك: فشاشة الكوموند ورك مدة على منتوج (ولا كليك يمين) وختار ★ مفضّل (بوطونة سريعة)؛ عاوتاني = تحيدو. الصلاحية تسيير المنتوجات. جميع الكاسات كيشوفوه دغيا.
• التكليك، الاختيارات، المنيوات، happy hour و "سالا" كيخدمو فالمفضّلين بحال فالمجموعات العادية بالضبط.

دورة أخرى

فشاشة الكوموند كاينة البوطونة ↻ دورة أخرى (غير تكون شي حاجة فالحساب، حتى إلا مازال ما تكوموندات). تكليكة وحدة كتزيد الدورة اللخرة (كلشي اللي مشا فمرة وحدة بـ "كوموندي"، ولا داكشي اللي كليكيتي عليه دابا) عاوتاني سطور جداد؛ من بعد غير كوموندي عادي. الأثمنة هوما ديال دابا (حتى happy hour).

• ضغط طويل (ولا كليك على اليمين): ختار براسك. بـ ◀ ▶ كتدوز للدورات اللي قبل، كل منتوج شعلو ولا طفيه (مثلا حيد العلامة على الماكلة) وبدّل العدد بـ − / +. الاختيارات والملاحظات كيمشيو معاه.
• المنتوجات اللي سالاو والمنيوات ما كيمشيوش (المنيوات كتكليكي عليهم بوحدهم). كيخدم حتى بلا كونيكسيون.
• السطورا كيتزادو بحال كيف كاينين فالحساب: ملي جمع نفس المنتوجات مشعولة، سطر واحد لكل منتوج (2 Cola)؛ ملي طافية، كل سطر بوحدو (2 مرات 1 Cola).

وقت الطابلة فالتصميم

على كل طابلة عامرة كاين ⏱ 45m · 12m: شحال هادي والطابلة عامرة وشحال هادي تكليكا آخر حاجة (ورك وخلّي صبعك على الطابلة، ولا دوز عليها بالفأرة، باش تشوف الأوقات بالضبط). إلا دازت مدة وما تكوموندا والو، الطابلة كتاخد حاشية ليمونية: دوز شوف. شحال من دقيقة كتحددها فـ الإعدادات → المحل → وقت الطابلة (من الأول 20، 0 = بلا حاشية ليمونية). إلا مازال ما تكليكا والو، الوقت كيتحسب من ملي تحلّات الطابلة.

إلا كانو بزاف ديال المجموعات (كل وحدة بحسابها) فطابلة وحدة، كاين سطر لكل مجموعة، مثلا G1 ⏱ 50m · 12m و Jansen ⏱ 10m (سمية المجموعة، ولا النمرة ديالها). المجموعة اللي بقات مدة طويلة بلا حركة كتاخد ليبيل ليموني والطابلة حاشية ليمونية.

نقل الطابلة كاملة

فشاشة الطلب كاين نقل الطابلة. ختار البلاصة (بحال التيراس) وطابلة: كاع المجموعات ديال الطابلة كيمشيو معاها، كل وحدة بالحساب ديالها. إلا ختاريتي طابلة عامرة، الطابلات كيتجمعو (المجموعات كيتزادو). إلا بغيتي تنقل غير جزء، خدم بحال قبل بقسم / نقل. إلا خاص كلشي يكون فحساب واحد، خدم بجمع.

الخدمة أوفلاين (تابليط بلا Wi-Fi)

إلا تقطعات الكونيكسيون بين تابليت وسيرفور الكاسة (Wi-Fi فالتيراس، السيرفور طافي شوية)، كتبان بار صفرا والتابليت كتبقى خدامة بآخر الطابلات، المنتوجات والكوموندات المحلولة اللي تسجّلو:

• حلان الطابلات، التكليك على المنتوجات و كوموندي كيتسجّلو فالتابليت (حتى إلا عاودات تشعل) وكيبانو فلائحة الكوموندات بحاشية منقّطة ("مازال ما تصيفطش")؛
• غير ترجع الكونيكسيون، كلشي كيمشي للسيرفور بالترتيب وعاد من بعد تيكي الكوزينة كيمشي للكوزينة. كل باكيه عندو ساروت، إذن حتى حاجة ما كتوصل جوج مرات. إلا شي واحد آخر حلّ الطابلة فهاد الوقت، المنتوجات كيتزادو لديك الكوموند؛
• خلاص الحساب، التخفيض، التفريق وهادشي ما كيمشيوش غير بالكونيكسيون؛ "خلّص الحساب" كيتسنّى حتى يتصيفط كلشي ديال ديك الطابلة.

عدد الناس

اختياري ومطفي عادةً: الإعدادات → المحل → الطلب والخلاص → تسجيل عدد الناس. مطفي = أقل ما يمكن ديال الكليكات: الطبلة الخاوية كاتحل بكليكة وحدة، ما كاين عدد الناس حتى فبلاصة، والرابور والداشبورد والملخص ديال النهار ما كيبينوش الضياف ولا شحال صرف كل ضيف.

شاعل: ملي كاتكليكي على طبلة خاوية، الكاسة كاتسول شحال من واحد (بوطونات كبار 1-8، ولا كتب الرقم؛ "فوت" = 1). ف البلان، الطبلة المعمرة كيبان فيها "3/4 ناس" (الناس/البلايص، صفرا إلا كانو الناس كثر من البلايص). ف شاشة الطلب كاتبدلو بالبوطونة "3 ناس" ف الشريط ديال المجموعات؛ إلا كانو بزاف ديال المجموعات، الطبلة كاتجمع كاع المجموعات.

بلا عدد الناس كلشي كيخدم: قسم بالتساوي ف الخلاص كيبدا من 2، all-you-can-eat كيسول بوحدو على عدد الكبار والصغار، والريزيرفاسيونات ولائحة الانتظار كيحتافظو بعدد الناس ديالهم (الطبلة كاتحل ساعتها بلا عدد الناس).

تسجيل HACCP

كل مطعم ولا قهوة خاصو يراقب السلامة ديال الماكلة ويسجلها: ف هولندا على حساب Hygiënecode voor de Horeca (المراقبة ديال NVWA)، ف بلجيكا على حساب المراقبة الذاتية ديال FAVV (الدليل G-023). شعل تسجيل HACCP ف الإعدادات ← القوانين والقواعد (مطفي من الأول).

• نقط القياس (المسؤول): مثلا فريگو كبير، كونجلاتور، الحفاظ سخون، الحرارة الداخلية من بعد الطياب، التبريد من جديد واستلام السلعة، مع الأقل و/ولا الأكثر ب °C وشحال من مرة (كل نهار، جوج مرات ف النهار، كل سيمانة ولا ملي كيتستعمل). زيد اللائحة العادية كيعطيك بداية (التبريد حتى 7 °C، ف بلجيكا حتى 4 °C؛ الكونجلاتور حتى -18 °C؛ الحفاظ سخون من 60 °C؛ الطياب من 75 °C).
• التنقية والمراقبة: مهام كل نهار، كل سيمانة (إلا بغيتي ف نهار ثابت) ولا كل شهر، مع البلاصة والتعليمات، مثلا تعقيم الطبالي ديال التقطاع، فيلترات الدهنة، مراقبة الحشرات، تشييك الترمومتر.
• التسجيل (كل واحد داخل): البوطونة HACCP ف الشريط لفوق، مع شحال باقي اليوم. دخّل الحرارة، ولا علّم على المهمة (تدار ولا ما تداراش). إلا كانت الحرارة برا الحد، خاص إجراء تصحيحي (مثلا "سدّيت الباب، لوحت المنتوج"). التسجيلات ما كيتبدلوش؛ الغلط كيتصلح بتسجيل جديد.
• الملخص (الحق المداخيل حسب المدة): لكل مدة كاع التسجيلات، عدد الفروقات والتسجيلات اللي فاتو كل نهار؛ بحال CSV (Excel) ولا باش تطبعو / تحفظو PDF للمراقبة.

سيستيم الروبينيات وعدّادات الصبيب

كل صبّة كيعلم بيها الأورديناتور ديال الروبينيات ولا عدّاد الصبيب كتمشي للتيكي، باش حتى حاجة ما "تهرب". شعلو من الإعدادات ← سيستيم الروبينيات (طافي بشكل افتراضي).

• المصادر (المسؤول): الكومبيوتر ديال الروبينيات ولا السيستيم ديال العدادات. ختار الماركة؛ الكاسة كتعمّر إعداد جاهز. من هولندا وبلجيكا: Van Duijnen Horeca (أوطوماتيزاسيون ديال الصبّ، Dashbar)، Beconet (Multi-Tap)، TapSystems، Horecatechniek Nederland، Heineken SmartDispense، WeissBeerger / AB InBev و BarTrack؛ وزيد Gruber، Addimat، WMF / Hogatron (E-Protokoll)، Drinkotec (ex-Hartec)، ، Berg، Easybar، Azbar، Scanabar، PourMyBeer، iPourIt، BeerBoard، US BeerSAVER، Bevchek، Capton/BarVision، Kegtron، Kegbot Kegboard، "روبيني ذكي" ولا سيستيم ديالك. كاينين خمسة ديال الطرق باش تربط (Kegboard: شوف الصبّ بالمقدار و Kegboard لتحت):
  • الحقول: kraan (ولا tap، plu)، ml (ولا cl، liter، volume مع eenheid) ولا porties، id (نفس الصبّة جوج مرات = كتتسجل مرة وحدة)، tijdstip، tafel، bediening؛ صبّة وحدة، ليستة ولا { "taps": [...] }.
  • الريزو (TCP): الكاسة كتتصل بالأورديناتور ديال الروبينيات (العنوان والبور) ولا كتسمع بوحدها على بور.
  • البور السيري: بور COM ولا USB سيري، 1200–115200 baud، 8N1، 7E1 ولا 7O1.
  • فالريزو والسيري كتختار شكل الميساج (ميساج واحد فكل سطر، ولا STX … ETX مع تحقق XOR إلا بغيتي و ACK/NAK كيرجع) والباترون ديال الميساج، بالأجزاء kraan ولا plu وإلا بغيتي ml، cl، liter، porties، tafel، bediening وid (مثلا kraan;ml ولا غير PLU لكل كاس). المورّدين كيعطيو الشكل الدقيق ديالهم غير للتقنيين اللي كيركّبو؛ سوّل المورّد ديال أورديناتور الروبينيات. صبّة تجريبية كتصيفط صبّة بحال إلا صيفطها الأورديناتور ديال الروبينيات.
• الروبينيات (المسؤول): لكل روبيني ولا PLU المنتوج وكيفاش كيطلع فالتيكي: بالكاس (الكاس بـ ml؛ صبّة ديال 520 ml مع كيسان ديال 250 ml = 2 كيسان؛ من 50% كيتحسب كاس) ولا باللتر (الثمن ديال المنتوج هو ثمن اللتر؛ فالتيكي مثلا "بيرة 0,33 l" بالمبلغ الصحيح).
• على التيكي: إلا الأورديناتور ديال الروبينيات عطى طابلة، الصبّة كتمشي نيشان للكوموند المحلولة ديال داك الطابلة. وإلا كتبان فـتصبّ: فشاشة الكوموند كيبان الشريط "… مرة تصبّ بلا تيكي"؛ ختار الصبّات وكليكي على على هاد التيكي. السطورا كيوليو نيشان مطلوبين (ما بقاش كيمشي بون للبار) والسطوك كينقص. البوطونة تصبّ اللي فالشريط الفوقاني كتبيّن كلشي اللي باقي ما عندو تيكي.
• التشطيب (الحق ديال ستورنو): تغسال، تهراس، تذواق، الخدامة، فابور ولا آخرين (مع توضيح)؛ هادشي كيتسجل فالسجل. اللي قل من كاس (مثلا تغسال) خاصو يتشطّب.
• النظرة العامة (الحق ديال المداخيل حسب المدة): لكل روبيني اللي تصبّ، اللي على التيكي، اللي تشطّب (حسب السبب)، اللي تلغى واللي باقي محلول، باللترات، مع النسبة اللي تباعت، وحتى بـCSV.
• الصبّات المسجلة ما يمكنش تبدّلها (غير تعالجها).

الصبّ بالمقدار و Kegboard

بالصبّ بالمقدار، الروبيني ما كيتحلّ حتى كيتسجّل الكاس فالكاسة، وغير لهاد الكمية. هكا ما كيتصبّ والو ما مكتوبش فالتيكي. كيخدم غير إلا كان سيستيم الروبينيات شاعل، وكتشعّلو لكل روبيني بوحدو (طافي بشكل افتراضي).

• لكل روبيني (المسؤول، الإعدادات ← سيستيم الروبينيات ← الروبينيات): علّم على الصبّ بالمقدار وختار شحال يبقى الروبيني محلول من بعد التسجيل (10–600 ثانية، افتراضياً 120). ف Kegboard كتعمّر حتى الـ relais (الصوباپ المغناطيسي). الصبّ بالمقدار كيمشي غير بالكاس.
• التسجيل: ملّي تضغط صيفط الكوموند (ولا ملّي خلّص الحساب نيشان) الكاسة كدير لكل سطر فالتيكي فيه هاد المنتوج سماح (عدد الكيسان × الكاس ب ml) وكتصيفطو للكومبيوتر ديال الروبينيات. الصبّة اللي كتجي من بعد كتبع لهاد السطر. يعني ما كتزادش عاوتاني فالتيكي وما كتمشيش ل تصبّ. الصبّة بلا سماح كتمشي عادي ل تصبّ.
• ستورنو ديال السطر قبل ما يتصبّ: الروبيني كيتسدّ عاوتاني. السماح اللي ما تصبّش فالوقت كيسالي؛ الروبيني عمرو ما كيتحلّ من بعد.
• السماحات فشاشة الكوموند (بارة فوق التيكي): تشوف شنو خدام، وقّف، و عطي السماح عاوتاني. تعطي السماح عاوتاني غير إلا ما تصبّ والو باقي، يعني عمرو ما كيتعطى شي حاجة زايدة. سماح تيست (المسؤول) كيعطي السماح لكاس واحد بلا تيكي؛ هادشي كيتكتب فالسجل.
• كيفاش السماح كيوصل للكومبيوتر ديال الروبينيات:
  • Kegboard (Kegbot، open source، ESP32 مع عدادات الصبّ والصوباپات المغناطيسية؛ بروتوكول عمومي كامل): الكاسة كتعطي grant للروبينيات اللي فيهم هاد المنتوج، الـ relais والكمية. البورد كيسدّ الروبيني بوحدو ملّي توصل الكمية ولا يسالي الوقت.
  • الريزو/سيري: أمر ديال السماح اللي تقدر تبدّلو ب {kraan}، {ml}، {porties}، {sec} و {id} (مثلاً V{kraan};{ml})، كيتصيفط فالشكل ديال الميساجات ديال المصدر (سطر ولا STX … ETX مع XOR). اختيارياً كاين أمر ديال التوقيف. الأمر بالضبط كيعطيه المورّد.
• ربط Kegboard: ف + مصدر ختار الماركة Kegbot Kegboard. البطاقة كتبان عند المصدر؛ كليكي على سمح (ولا رفض). البطاقة كتاخد مرة وحدة ساروت ديالها، والكاسة كتحفظو غير ك hash. جهاز آخر ولا ساروت غالط ما كيبدل والو فبطاقة مربوطة؛ إلا البطاقة ضيعات الساروت ديالها، استعمل الأول قطع الربط. المصدر كيبيّن الفيرموير والعدادات والريليات ديال البطاقة. الروبينيات هوما أرقام العدادات (0، 1 …). الكارطة عند البطاقة كترفض: الخلاص كيكون فالكاسة. إلا كان نظام الروبيني طافي، البطاقة كتحفظ الرسائل ديالها وكتصيفطهم من بعد.
• فالمصدر كتحدد من بعد شحال من ثانية بلا تدفق كيتسد الروبيني (5–300، الافتراضي 30). لكل روبيني كتعمّر رقم العداد والريلي (صمام مغناطيسي) وشحال يقدر يبقى الروبيني محلول من بعد التسجيل.

التحكم فالموسيقى من الكاسة

الخدّامة كيتحكمو فالموسيقى من التاتش سكرين ديال الكاسة، يعني ما خاصكش شاشة بوحدها فالبار. شعّلها فـ الإعدادات → المحل → الشاشات والخدمة بالكيسة → التحكم فالموسيقى من الكاسة (عادةً مطفية). من بعد كتبان بوطونة الموسيقى فالبار الفوقاني: لكل مصدر (بحال البار والتيراس) شغّل، وقّف شوية، اللي من بعد، اللي قبل، علّي الصوت، نقّص الصوت وسلايدر ديال الصوت، مع أشنو كيدور دابا. رجع للكاسة كيسدّ البانو. إلا طفيتيها: المصادر كيبقاو محفوظين.

• البلاي ليست (Sonos، Bluesound وVLC): الطابور مع اللي كيدوز دابا. ضغط على أغنية باش تشغلها؛ ب بدّل كتحيد الأغاني (✕)، كتطلعهم ولا كتهبطهم (↑ ↓؛ Sonos وBluesound) ولا كتخوي البلاي ليست. ب ختار موسيقى أخرى كتشغل مفضلة ديال Sonos (بحال راديو ولا قناة Tunify) ولا ليستة ديال التشغيل، ولا إعداد مسبق ديال BluOS.
• على شاشة بوحدها: نفس التحكم والبلاي ليست كبيرة على http://<kassaserver>:3000/muziek، بحال على شاشة تانية حدا الكاسة ولا طابليط فالبار (إلا كنتي داخل فنفس الجهاز، ولا بالكود PIN).
• على طابليط ولا تيليفون: كود QR فيه العنوان ديال هاد الشاشة فالشبكة ديال المحل. الخدام كيسكانيه بالطابليط ولا التيليفون ديالو (على wifi ديال المحل) وكيدخل بالكود PIN ديالو؛ وبخرج كيتسد. شوف شاشة تانية على طابليط ولا تيليفون.

المسؤول كيزيد المصادر بـ + مصدر ديال الموسيقى، كيختار كيفاش مربوط وكيجرّبو بـ جرّب:

• Soundtrack (soundtrack.io): عبر الـ API العمومية، بـ API-token (كيطلبو من Soundtrack) وزون ديال الصوت (جيب الزونات). شغّل، وقّف شوية، اللي من بعد، الصوت وأشنو كيدور.
• Sonos: عنوان IP ديال البافل (فالڭروب: البافل اللي كيقود الڭروب). خدام مع كلشي اللي كيدور على Sonos، بحال Tunify، Spotify ولا الراديو.
• Bluesound (BluOS): عنوان IP ديال البلاير؛ حتى هو خدام مع كلشي اللي كيدور عليه، بحال Tunify.
• VLC فالبيسي ديال الموسيقى: شعّل واجهة الويب (Outils → Préférences → Tout afficher → Interface → Interfaces principales: Web، مع كلمة السر عند Lua)؛ عنوان IP (إلا بغيتي مع :poort، عادةً 8080) وكلمة السر.
• بيسي ديال الموسيقى ديالك (عناوين ويب): لبيسي ولا بوكس ديال الموسيقى اللي عندو عنوان ويب لكل بوطونة؛ GET ولا POST، و{volume} (0-100) فالعنوان ديال الصوت. بلا عنوان ديال علّي/نقّص الصوت، الكاسة كتبدّل الصوت خطوة بخطوة.
• الويب بلاير ديال برنامج الموسيقى: عنوان الويب ديال الويب بلاير ولا صفحة التحكم (بحال الويب بلاير ديال Tunify ولا Media Tools) كيتحل فالكاسة ببوطونة الموسيقى؛ إلا الخدمة ما كتخليش تتحل فشاشة أخرى، استعمل حلّ فنافذة بوحدها.

الكاسة كتهضر مع البلايرات من السيرفور، يعني خاصهم يكونو فنفس الريزو ديال الكاسة (Soundtrack عبر الأنترنيت). التحكم مسموح لأي واحد داخل؛ الضبط خاصو الحق ضبط المحل، الخلاص والطابعات. التوكن وكلمة السر عمرهم ما كيبانو عاوتاني فالشاشة ولا فالسجل؛ فالسجل كيتسجّل غير الضبط (شاعل/مطفي، المصادر)، ماشي كل بوطونة. الإكسبور ديال الإعدادات كياخد غير شاعل/مطفي (المصادر ديال محل واحد).

شاشة تانية على طابليط ولا تيليفون

الموسيقى والكاميرات يقدرو حتى يبانو فالطابليط ولا التيليفون ديال الخدام، بحال شاشة تانية حدا الكاسة. فالنافذة ديال الموسيقى ولا الكاميرات كاين الزر على طابليط ولا تيليفون: كيبيّن كود QR فيه العنوان، بحال http://192.168.1.20:3000/muziek ولا .../camera.

1. ربط الطابليط ولا التيليفون مع wifi ديال المحل.
2. سكاني كود QR بالكاميرا (ولا كتب العنوان فالبراوزر).
3. دخل بالكود PIN ديالك. غادي تشوف غير داكشي اللي مسموح ليك: الموسيقى للكل، والكاميرات غير بالحق شوف تصاور الكاميرات.
4. ساليتي: خرج لفوق فالقنت. إلا سالات الدخلة (مثلا الطابليط بقات ليلة كاملة بلا خدمة)، الشاشة كتطلب عاود الكود PIN.

نصيحة: زيد الصفحة للشاشة الرئيسية ديال الطابليط (فالبراوزر: زيد للشاشة الرئيسية)، وغادي تتحل بحال شي تطبيق.

على هادشي الكاسة كتسوّل على عنوان IP ديال البيسي ديال الكاسة فالشبكة (إلا كان عند البيسي كتر من واحد، بحال wifi وكابل، كتختار الشبكة). فبوابة الإدارة (الكاسة من بعيد) العنوان هو العنوان ديال البوابة. الكاسة كتصاوب كود QR براسها، بلا أنترنيت.

ربط الطابليطات: ببوطونة وحدة للطابليط (اختياري)

ساهل كتر: ربط طابليط مرة وحدة، ومن بعد الكاسة كتصيفط الموسيقى ولا الكاميرات لداك الطابليط ببوطونة وحدة. شعلها ف الإعدادات → المحل → الشاشات والخدمة بالكيسة → الطابليطات كشاشة تانية (عادةً مطفية).

1. فالطابليط: حل http://<kassaserver>:3000/tablet (حدا الإعداد كاين على طابليط ولا تيليفون مع كود QR)، دخل بالكود السري وعطي للطابليط سمية، بحال طابليط البار. ربط.
2. فالكاسة: فالنافذة ديال الموسيقى ولا الكاميرات كتبان دابا البوطونة لـ طابليط البار (مع نقطة خضرا إلا كان الطابليط شاعل). ضغط عليها: الطابليط كيحل داك الشاشة بوحدو. فالموسيقى المصدر اللي ختاريتي كيمشي معاه (بحال التيراس).
3. فالطابليط: سدّ كيرجع للتسناية؛ فكّ الربط ديال هاد الطابليط كيحيّد الربط.

خلّي الصفحة محلولة فالطابليط؛ إلا كان الطابليط مطفي ولا ناعس، غادي يحل الشاشة غير يتشعل عاوتاني. الطابليط كيبقى داخل بسمية الخدام اللي دخل فيه: تصيفط الكاميرات وتشوفهم غير بالحق شوف تصاور الكاميرات. المسؤول كيشوف حدا الإعداد شمن طابليطات مربوطين واش شاعلين، ويقدر يبدل ليهم السمية ولا يحيّدهم. الطابليط كيحتافظ بساروت ديالو؛ والكاسة كتحتافظ غير بـ hash ديالو. إلا طفيتيها: الطابليطات المربوطين كيبقاو محفوظين. فالسجل كيبان شكون ربط طابليط، بدل ليه السمية ولا حيّدو.

شاشة النداء للي ياخدو معاهم

شاشة للكليان فيها على اليسر كيتوجد وعلى اليمن واجد، بنمرات كبار، بحال فشي سناك ولا فاست فود. شعلها فـ الإعدادات → المحل → الشاشات والخدمة بالكيسة → شاشة النداء للي ياخدو معاهم (عادةً طافية).

ما خاصكش تربط: حلّ العنوان ديال الكاسة مع /oproep على تلفزة فيها براوزر (smart TV، stick ولا mini-pc)، طابليط ولا شاشة تانية، مثلا http://192.168.1.20:3000/oproep. فالإعداد وفالنافذة ديال عيّط كاينين البوطونات على شاشة بوحدها وعلى طابليط ولا تيليفون (QR code فيه العنوان). ما خاصكش تكونيكطا: الشاشة كتبيّن غير النمرات. ضغط مرة وحدة على الشاشة، وديك الساعة البراوزر يقدر يخرج الصوت.

شنو كيبان عليها:

• الكوموندات ديال ياخدها معاه من الكاسة، المتجر ديال الأنترنيت وThuisbezorgd (وإلا بغيتي حتى الكوموندات فـ الكونتوار بلا طابلة، فالبيع زربة)، ديال آخر 12 ساعة؛
• غير كيتصيفط شي حاجة للكوزينة ولا البار (ولا الكوموند ديال المتجر ديال الأنترنيت تكون على كيتوجد): النمرة كتبان تحت كيتوجد؛
• واجد كتولّي بوحدها ملي الشاشة ديال الكوزينة تقول الكوموند كاملة واجدة ولا الكوموند ديال المتجر ديال الأنترنيت تكون على واجد. النمرة كتشعّل وتطفى شوية والشاشة كدير دينغ-دونغ؛
• النمرة الواجدة كتبقى شحال ما ضبطتي ديال الدقايق (عادةً 10)، ولا حتى تّاخدات;
• الطلبيات ديال الكيوسك (شوف كيوسك الخدمة الذاتية) ديما كيبانو غير يتخلّصو ولا غادي يتخلّصو فالكاسة، حتى مع "غادي ناكل هنا"، بالنمرة ديال الاستلام اللي فالبون ديالهم؛
• إلا بغيتي، حتى الطلبات ديال الليفرورات ديال Thuisbezorgd وUber Eats وDeliveroo وHubRise (الخانة حتى الطلبات ديال الليفرورات …): بنمرة الطلب ديال البلاتفورم وسمية البلاتفورم تحتها، باش الليفرور يشوف إمتى الطلب ديالو واجد. تاخدات كتقول حتى للبلاتفورم بلي الليفرور داها (بحال فالفنيترة ديال البلاتفورم).

النمرة: فالبوتيك أونلاين وThuisbezorgd والبلاتفورمات ديال التوصيل هي نمرة الطلب اللي عند الكليان ولا الليفرور من قبل؛ ولا نمرة الاستلام (من 1 حتى 999). كتطبع كبيرة فالبون، مع الشرح بلي النمرة غادي تبان فالشاشة ملي يوجد الطلب (بلغة البون).

اختياري (طافي افتراضيا، فالإعداد):

• علن على النمرة بالصوت: ملي كتكون نمرة جديدة واجدة، الشاشة كتقول مثلا "Nummer 42…" باللغة اللي ختاريتي (الهولندية، الإنجليزية، الألمانية، الفرنسية، الإسبانية، الإيطالية، البرتغالية، البولونية، التركية ولا العربية). الصوت كيجي من البراوزر ديال الشاشة وكيختالف من جهاز لجهاز؛ ملي تحلّها ضرب على الشاشة مرة وحدة. من بعد الجرس، إلا كان الصوت حتى هو خدام.
• حالة الطلبية فالتيليفون: كيبان كود QR تحت نمرة الاستلام فالبون. الكليان كيسكانيه، كيشوف النمرة ديالو والحالة (تطلبات، كتوجد، واجدة، تخدات) وكيجيه إشعار ملي تكون الطلبية واجدة. هادشي كيخدم عبر بوابة الإدارة، خاص الكاسة تكون مربوطة بيها. ماشي للمتجر الإلكتروني وThuisbezorgd (عندهم الحالة ديالهم) وماشي للكيوسك (عندو الإعداد ديالو).

فالكاسة كاينة البوطونة عيّط (مع شحال باقي كيتوجد):

1. واجد كدير النمرة على واجد بيدك (بلا شاشة الكوزينة، ولا إلا كان أسرع). فالكوموند ديال المتجر ديال الأنترنيت ولا Thuisbezorgd الحالة كتتبدل معاها، يعني الكليان حتى هو كيوصلو الخبر.
2. رجع كيرجّعها لـ كيتوجد.
3. تّاخدات كتحيّدها من الشاشة (مع رجّع اللي درتي).

فالإعداد كتختار حتى واش السمية الأولى تبان حدا النمرة (عادةً لا، على قبل الخصوصية) وواش الشاشة تخرج الصوت. ملي تطفيها: ما كايناش البوطونة عيّط وما كايناش نمرة الاستلام فالتيكي؛ الإعدادات كتبقى محفوظة. فالسجل كيبان شكون دار شي نمرة بيدو على واجد، رجّعها ولا دارها تّاخدات.

البوانتاج ديال الدخول والخروج

من الأول البوانتاج مطفي: إذن ما كيبان حتى فبلاصة فالكاسة (ما كايناش بوطونة فالبار اللي الفوق، ما كاينش فشاشة الدخول، ما كاينش الأونڭليه أوقات الخدمة). شعلو من الإعدادات → المحل، تحت البوانتاج ديال الدخول والخروج ديال الخدّامة:

• مطفي: ما تستعملوش. إلا طفيتي الپوانطاج من بعد، ما غاديش يبان فحتى بلاصة، ولكن السوايع اللي تسجلو ديجا كيبقاو محفوظين (ما كيتمسح والو)؛ وإلا شعلتيه عاوتاني، كيرجعو يبانو.
• مشعول: الخدّامة يقدرو يدخّلو ويخرّجو البوانتاج. من بعد الدخول الكاسة كتسولك واش بغيتي تدخّل البوانتاج (ماشي دابا مسموح). فالبار اللي الفوق كتبان دخّل البوانتاج ولا داخل من 17:02؛ كليكي عليها باش تخرّج البوانتاج.
• ضروري: من بعد الدخول خاصك تدخّل البوانتاج الأول، ولا ما تقدرش تستعمل الكاسة. ملي كتخرّج البوانتاج كتخرج من الحساب دغيا.

اللي ما كيستعملش الكاسة (مثلا الكوزينة) كيدير البوانتاج فشاشة الدخول: كليكي على دخّل / خرّج البوانتاج ودخّل الكود السري ديالك. هادشي كيبدّل بين الدخول والخروج، بلا ما تدخل للكاسة.

إلا كان البوانتاج مشعول، المسؤول كيشوف فـ الإعدادات → أوقات الخدمة:

• شكون داخل دابا (ويقدر يخرّج البوانتاج لشي واحد اللي نسا)؛
• الساعات اللي تخدمو لكل خدّام فكل مدة، مع جميع الخدمات (الشيفتات)، وتحميل CSV (الساعات حتى بالرقم العشري للأجور)؛
• بدّل ولا زيد الشيفتات (كليكي على شيفت، ولا + زيد شيفت). كل تبديل كيتسجّل فاللوڭ بالأوقات القدام والجداد.

فبلجيكا كل دخول وخروج ديال البوانتاج كيتصيفط حتى للصندوق الأسود. إلا ما كانش متاح، البوانتاج ما كيدوزش (بحال خلاص الحساب). واش هادشي كيوافق بالضبط التسجيل ديال الخدّامة فبلجيكا، مازال خاصو يتأكّد.

الوزن والإتيكيتات (الميزان)

إلا كان الميزان مشعول (الإعدادات → الميزان)، المنتوجات يقدرو يكون عندهم ثمن للكيلو. جميع المنتوجات الأخرى كيبقاو بالحبة عادي.

• الوزن: كليكي على منتوج عندو ثمن للكيلو (البوطونة كتبيّن مثلا 12,95/kg). الفنيطرة الوزن كتبيّن الوزن ديال الميزان (مثلا Aclas OS6X، ولا الميزان اللي الكاسة خدامة عليه) لايف؛ خضر = ثابت. حط المنتوج فالميزان وكليكي على زيد غير يثبت الوزن. الثمن هو الثمن للكيلو × الوزن (مقرّب للسنتيم)؛ الباركة (tare) ديال المنتوج كتنقص بوحدها. إلا كان عند المنتوج اختيارات، كيجيو من بعد.
• بزاف ديال الميزانات: إلا كانو بزاف ديال الميزانات، كتختار الفوق فالفنيطرة على أشمن واحد غادي توزن. كل كاسة/تابليت كتعقل على الاختيار ديالها.
• باليد: ما كاينش ميزان (ولا مسموح باليد)، كتب الوزن: 0,512 ولا 1,2 هو كيلو، 512 ولا 512 g هو غرام.
• الإتيكيت ديال TS6X: سكاني الكود-بار ديال الإتيكيت بالسكانير فشاشة الكوموند (غير سكاني، ما خاص حتى حاجة تكون محلولة)، ولا كليكي على الإتيكيت وسكاني ولا كتب الـ 13 أرقام. المنتوج (PLU) والوزن كيجيو من الإتيكيت. إلا كان الثمن مكتوب فالإتيكيت، الكاسة كتحسب ديك الثمن بالضبط.
• فالشاشة، التيكي ديال الكاسة وشاشة الكليان كيبان الوزن، مثلا كفتة 6,63 وتحتها 0,512 kg x € 12,95/kg؛ فتيكي الكوزينة 0,512 kg كفتة. التفريق، النقل والريتور كيكونو بالكيلو.
• المنتوج اللي كيتوزن ما يمكنش غير إلا كان الاتصال مع السيرفور ديال الكاسة (الوزن كيجي عبر السيرفور ديال الكاسة).

Uber Eats وDeliveroo وHubRise

زيادة على Thuisbezorgd.nl / Takeaway.com كيدخلو للكاسة حتى الكوموندات ديال Uber Eats (هولندا وبلجيكا)، Deliveroo (غير بلجيكا؛ Deliveroo خرجات من هولندا ف آخر 2022) وكلشي اللي كاين على HubRise (بحال Uber Eats وDeliveroo وJust Eat/Takeaway.com وتطبيقات الطلب الصغار). كل منصة كتشعل بوحدها ف الإعدادات → منصات التوصيل (عادةً مطفي، ملي كتطفيه كلشي كيبقى محفوظ). الأونگلي كيبيّن لكل منصة ف أشمن بلدان خدامة وكينبّه إلا ما خدامةش ف البلاد ديال المحل.

• شعلو، ومن بعد دخل لـ Uber Eats وربط المحل (المحل كيدخل بالحساب ديالو ف Uber Eats). إلا كان الحساب عندو بزاف ديال المحلات، دخّل الـ id ديال المحل (store id) وعاود دخل. Uber Eats خاصها الأول توافق على Pin Voordeel بحال شريك.
• Deliveroo: مباشرة، عبر البوابة. دخّل الـ id ديال الموقع (location id) والـ id ديال الماركة (brand id). بلا طابليط (عادة): الكاسة كتقبل ولا كترفض؛ مع طابليط: المحل كيقبل ف الطابليط والبوابة كتقول غير واش الكوموند كاينة ف الكاسة.
• HubRise: الكاسة كتجيب الكوموندات بوحدها (كل 20 ثانية، ما محتاجاش البوابة).
• لكل منصة: القبول الأوتوماتيكي، تيكي ديال الكوزينة ديريكت للكوزينة/البار و(Uber Eats، Deliveroo) صيفط المنيو بوحدو من بعد كل تبديل وصيفط المنيو دابا. ف المنيو كاينين المنتوجات اللي معلّمين تحت المنتوجات ف المنيو ديال Uber Eats وDeliveroo، مع الاختيارات؛ وحتى «سالا» كيمشي معاه.

الكوموندات. الكوموند كتولّي كوموند عادية (bezorgen ولا afhalen، سمية المجموعة <platform> <nummer>) بالأثمنة ديال المنصة: المنتوجات كتتعرف بالـ id (من المنيو)، الكود ولا رقم PLU، ما معروفش = سطر بوحدو بثمن المنصة (مع ميساج)؛ مصاريف التوصيل، الزيادات والريميز كسطورة بوحدهم؛ وإلا المجموع باقي ما مضبوطش، سطر "الفرق". تيكي ديال الكوزينة كيمشي ديريكت للكوزينة/البار. البوطونة المنصات ف البار الفوقاني (مع عدد الكوموندات الجارية؛ ليموني إلا كاين شي حاجة خاصها تتقبل): قبل ولا رفض (مع السبب)، كتوجد، واجدة، ف الطريق، توصلات ولا تّاخدات، لغي، وكمّل (تخلّص أونلاين). اللي كتعرفو المنصة كيرجع ليها (Uber Eats: قبول، رفض، إلغاء؛ Deliveroo: قبول، رفض، كتوجد، واجدة، تّاخدات؛ HubRise: جميع الحالات). إلا المحل كيوصّل بوحدو (توصيل بوحدك)، الكوموند كتبان حتى ف الطورنيات، والخروج والتوصيل كيمشيو بوحدهم للمنصة. إلغاء من المنصة كيخلي الكوموند تسالا. إلا الكاسة بقات أكثر من 2 دقايق ما متصلاش بالبوابة، البوابة كترفض أي كوموند جديدة من Uber Eats وكتقول لـ Deliveroo (مع طابليط) بلي ما نجحاتش، باش المحل يشوفها ف الطابليط.

الكود: apps/pos-server/src/lib/bezorgplatforms.ts، routes/bezorgplatforms.ts؛ الشاشات Bezorgplatforms.tsx. جهة البوابة: horecapos-portaal/src/platforms.mjs. السجل: منصات التوصيل (تشعيل/تطفية، الإعدادات، الكوموندات). كلشي كيدخل ف النسخ الاحتياطية (back-ups) ديال الكاسة.

المنصات الصغار ف هولندا وبلجيكا (Homie وHebtrek وsneleten.nl وBistroo ...) ما عندهمش ربط عمومي مع الكاسة؛ إلا كانو على HubRise، كيخدمو عبر HubRise. والباقي: شوف الـ backlog.

ماكينة الفلوس (سيستيم ديال الفلوس مسدود)

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

• الماكينات اللي الكاسة كتهضر معاهم مباشرة:
  • CashDro (3، 4+، 5، 7، S Compact؛ NuKassa، KluisKassa): عبر الريزو (web service). على CashDro شعل Web Integration وصاوب مستخدم خاص بالكاسة.
  • Cashmatic (SelfPay 460/860/1060؛ فبلجيكا Xpos): عبر الريزو (البور 50301) بمستخدم على Cashmatic.
  • Azkoyen Cashlogy (POS1000، POS1500): عبر CashlogyConnector على PC ديال Windows حدا الماكينة (البور 8092).
  • CashKeeper: عبر CKMonitor على PC ديال Windows (البور 16501).
  • Glory CASHINFINITY (CI-5، CI-10، CI-10X؛ حتى عبر Cikam): عبر التحكم (FCC) ديال الماكينة. باقي بيتا: خلّي Glory ولا الديلر ديالك يراجعو الربط الأول.
  • خارجي: برنامج آخر كيتحكم فالماكينة وكيهضر مع الكاسة (بحال Cikam، ImaCash لـ 25 ماركة، البرنامج ديال CashGuard/StrongPoint (Merlin)، PayComplete (SUZOHAPP)، Gunnebo SafePay ولا ماركات فرنسية بحال CashMag).
  • ماكينة ديال التجربة: بلا هاردوير، باش تتمرّن ولا توري. بـ جرّب الاتصال كتشوف العنوان والدخول. حط الماكينة فالريزو ديالك (عمرك ما تحلّها على الأنترنيت) واستعمل مستخدم خاص بالكاسة، ماشي أدمين.
• خلّص الحساب بـ كاش: خلّص فماكينة الفلوس كيبدا الخلاص ديال المبلغ (مدوّر للكاش إيلا كان شاعل، زايد البوربوار؛ ملي كتقسم الحساب الجزء ديالو). الشاشة كتوري شنو تدخّل وشنو كيرجع؛ الكاسة ما كتخلّصش الحساب حتى كتقول الماكينة سالات. لغي = الماكينة كترجّع الفلوس. إيلا الماكينة ما قدراتش تعطي الصرف كامل (ما كافياش الصرف ديال البياس)، كيتكتب حداه شحال خاص يخرج من الكاشير ديال الفلوس. الخلاص اللي نجح وباقي ما تحسبش (بحال إيلا طفات التابليت) كيتلقى من جديد عند ديك الطلبية.
• الكاش غير عبر الماكينة (بشكل عادي شاعل): السيرفور ديال الكاسة ما كيقبلش الكاش غير مع خلاص ناجح فالماكينة لديك الطلبية بالضبط وداك المبلغ بالضبط. مطفي = حتى الكاش العادي فالكاشير.
• الكاشير ديال الفلوس (الرابور → الكاسة، الصلاحية تسيير الكاشير ديال الفلوس): شوف شحال فيها (لكل بياس وبييي، فـ Cashmatic، Cashlogy، Glory وماكينة التجربة)، خرّج الفلوس مع السبب (بحال الصرف ديال الكاشير)، التعمار ونقّص الزايد (الصرف كيبقى؛ فـ Cashmatic). اللي خاص يكون فلاكاس ديال الكاسة ما كيحسبش الفلوس اللي فالماكينة (كتبان بوحدها لتحت: فماكينة الفلوس)، ولكن كيحسب الصرف اللي كان خاصو يخرج من الكاشير.

البوطون ©

لتحت على اليمين فكل شاشة (الكود PIN، البلان ديال الطابلات، الكوموند والكوزينة) كاين واحد البوطونة صغيرة ©. كتحل المعلومات ديال OptimumPOS: اللوغو، العنوان، التيليفون، الإيميل والسيت. الأيقونة كاينة لوكال فالتطبيق، يعني كتخدم حتى بلا أنترنيت. نفس الأيقونة هي الأيقونة ديال التطبيق (الأونغلي والشاشة الرئيسية).

الجزء 2 · المدير

بدا الخدمة

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

• الحالة دابا (X): الشيفر ديال المبيعات حتى لدابا، بلا ما تسدّ النهار.
• التيروار ديال الكاسة: الفلوس ديال البداية، دخول/خروج الفلوس وحلّان التيروار.
• سدّ النهار (Z): فآخر النهار؛ من بعد كيبدا نهار جديد.
• رابورات Z القدام، المبيعات حسب المدة والداشبورد.
• السجل، بونات كادو والكليان.

السطوك

بشكل افتراضي طافي. شعّلو من الإعدادات → المحل → تتبّع السطوك. طافي = ما كيبان حتى فبلاصة فالكاسة.

• لكل منتوج كتختار ف الإعدادات → المنتوجات → (المنتوج) → السطوك:
  • لا: بحال ديما؛
  • حسب المنتوج: كل بيعة كتنقص 1 (بحال القراعي، الكانيطات)، مع مستوى التنبيه ل"قريب يسالي"؛
  • عبر المكونات: وصفة، مثلا الهامبورغر = 1 خبزة + 150 g ديال اللحم + 1 طرف ديال الفرماج. كل بيعة كتنقص المكونات.
• الإعدادات → السطوك (الحق تسيير السطوك، بشكل افتراضي المانجير والمسؤول):
  • المنتوجات والمكونات: الحالة ديال السطوك، مع سالي / قريب يسالي؛ فيلتر "غير اللي سالي (ولا قريب)" والتصدير ل CSV.
  • لكل منتوج ولا مكون كتسجّل استلام (+) (الليفريزون)، الحساب (=) (العدد اللي حسبتي كيولي هو الحالة الجديدة) ولا نقص (−) (تهرّس، فاتو التاريخ؛ السبب ضروري).
  • صاوب المكونات مع الوحدة (st، g، kg، ml، cl، l، بورسيون، قرعة، برميل) ومستوى التنبيه.
  • التاريخ: كاع التغييرات (البيع، الستورنو، الاستلام، الحساب، النقص) مع شكون وفوقاش. العمليات ديال التسيير كيتسجلو حتى فالسجل.
• النقصان كيوقع ملي كتدير الكوموند (ولا ملي كتخلّص الحساب للحوايج اللي تخلصو نيشان). الستورنو كيرجّع. التقسيم والتنقال ما كيحسبوش جوج مرات. فالمونيات كينقصو الماكلات، ماشي السطر ديال المونو. الريتور (بون ديال الكريدي) ما كيرجعش السطوك (اللي ترجع غالبا ما بقاش كيتباع)؛ إلا بغيتي سجّلو كاستلام.
• إلا سالا السطوك (ولا شي مكون ما بقاش كافي حتى لمرة وحدة)، المنتوج كيولي بوحدو مبيوع كامل فكاع الكاسات. ملي يكون قريب يسالي كيبان باقي N على البوطونة ديال المنتوج. من بعد الاستلام ولا الحساب كتقدر توصي عليه نيشان. حتى السيرفور ديال الكاسة كيرفض المنتوج ("Pils" سالا (السطوك 0))، حتى من تابليط اللي باقي ما عرفاتش.
• السطوك يقدر ينزل تحت 0 (مثلا جوج تابليطات فنفس الوقت، ولا كوموند بلا أنترنيت)؛ الحساب كيرجّعو مزيان.
• لائحة الطلبيات: الإعدادات → السطوك → لائحة الطلبيات. لكل منتوج (حسب المنتوج) ولكل مكون، حدا مستوى التنبيه كتحدد حتى كمّل حتى ل والمورّد. فلائحة الطلبيات كيبان كلشي اللي سالي ولا تحت مستوى التنبيه (بلا مستوى التنبيه: ف 0)، حسب المورّد، والاقتراح هو كمّل حتى ل − الحالة. تقدر تبدّل الأعداد وتعلّم ولا تحيد العلامة. من بعد طبع (الطابعة ديال التيكيات)، نسخ (للإيميل ولا WhatsApp)، تصدير (CSV)، ومن بعد الليفريزون توصلنا: سجّل كاستلام (كيسجّل كلشي مرة وحدة). بالعلامة اللي الفوق كتشوف حتى اللي باقي ما ساليش، باش توصي زايد.
• الاختيارات: عند مجموعة ديال الاختيارات (الإعدادات → المنتوجات → الاختيارات) كاينة البوطونة السطوك. حدد لكل اختيار المكونات للحبة، مثلا فرماج زايد = 1 طرف ديال الفرماج، فريت = 150 g ديال الفريت. ملي كيتختار هاد الاختيار، هاد المكونات كينقصو للحبة (حتى إلا كان المنتوج براسو ما كيتبعش السطوك؛ فالستورنو كيرجعو). إلا سالا شي مكون، الاختيار كيبان فالكاسة ب (سالا) وما يمكنش تختارو.

الطلب من المورّدين

بشكل عادي مطفي. كيتشعل فـ الإعدادات → السطوك → الطلب من المورّدين (غير إلا كان تتبّع السطوك شاعل). مطفي = لائحة الطلبيات خدّامة بحال ديما.

• المورّدين (الأونگلي المورّدين): ختار واحد من اللائحة ولا صاوب مورّد ديالك. اللائحة فيها بائعين الجملة و cash & carry (Sligro، Sligro-ISPC/Sligro-M، HANOS، Makro، De Kweker، Horeca Totaal، Van Zon، zegro، Lekkerland)، foodservice (Bidfood وBidfood Belgium، Solucious، Chefs Culinar، Java، Q-Food، Agora Culinair، VHC Jongens/Kreko/Actifood، Hocras، Van Hoeckel ...)، بائعين الجملة ديال المشروبات (De Klok، Henk Smit، Horesca، De Monnik، Hansen، Dranken Geers ...)، البراسري والمشروبات الغازية (Heineken عبر Sligro، AB InBev/BEES، Alken-Maes، Haacht، Duvel Moortgat، Martens، Coca-Cola، Spadel، Grolsch، Bavaria)، مورّدي الطري (Van Gelder، Driessen، FiliusKaas، Bakkers Brigade، Rungis ...)، non-food (Bunzl، Takeaware، Supplierz)، الحانوت ديال الشراب أونلاين Vinify.nl ومنصات الطلب (Apicbase، Exact Horeko، Growzer، inOne، Cuisin.io، OrderXL). غير المورّدين ديال البلاد ديال المحل اللي كاينين فيها. إيلا ختاريتي واحد، الطريقة ديال الطلب، الفيشي والأعمدة كيكونو مظبوطين؛ وعند كل مورّد مكتوب كيفاش كتطلب من عندو.
• لكل مورّد: نمرة الكليان، اطلب عبر:
  • الإيميل: الطلبية كإيميل (مع جدول) للإيميل ديال الطلبيات، اختياريا نسخة، مع لائحة الطلبيات كبياس جوانت: CSV، Excel، CSV لـ Care4Fresh (بزاف ديال بائعين الجملة ديال الطري)، UBL 2.1 Order (Peppol BIS Order)، EANCOM ORDERS (D96A فهولندا، D01B/HO2C فبلجيكا) ولا cXML. الأجوبة كيوصلو للإيميل ديال المحل.
  • فيشي: الكاسة كتصاوب الفيشي، وانت كتطلّعو فالويب شوب ديال المورّد (بحال Bunzl Snel bestellen: artikel;aantal، Takeaware: SKU,Quantity). الفاصل، سطر العناوين والأعمدة كيتظبطو (artikel، ean، omschrijving، aantal، eenheid، prijs، totaal؛ بـ artikel=SKU كتعطي للعنوان سمية ديالك).
  • ربط (cXML): cXML OrderRequest مع نمرة الكليان والسر المشترك للعنوان ديال الطلبيات ديال المورّد، بحال برامج الشرا اللي كيصيفطو لـ Sligro، HANOS وBidfood. العنوان، نمرة الكليان والسر كيعطيهم ليك المورّد (Sligro: koppelingen@sligro.nl). السر عمرو ما كيرجع للشاشة.
  • ف جوج د الربطات تقدر حتى تستعمل سمية المستخدم وكلمة السر (Basic) وheaders زايدين (واحد ف كل سطر، مثلاً X-Api-Key: ...).
  • الرفع (SFTP/FTPS): الكاسة كتحط الملف (EANCOM، UBL، CSV، Excel ...) بوحدها ف دوسي على السيرفور ديال المورّد، بحال كيفاش بزاف د البائعين بالجملة كيقبلو الطلبيات ديال EDI. SFTP (SSH)، FTPS (صريح على البور 21 ولا ضمني على البور 990) ولا، غير ف الريزو ديالك، FTP. الدخول بكلمة السر ولا بساروت SSH (OpenSSH، PEM ولا PuTTY .ppk؛ ed25519، ECDSA ولا RSA). صاوب ساروت كيصاوب جوج سواريت ف الكاسة؛ الساروت العمومي كتصيفطو للمورّد. جرّب الاتصال كيدخل وكيقلب على الدوسي. البصمة ديال السيرفور SFTP كتتسجّل ف أول اتصال ومن بعد كتتراقب (سيرفور آخر ما كياخدش كلمة السر)؛ ف FTPS مع شهادة ديالك كتثبّت البصمة ديال الشهادة. ما خصك حتى برنامج زايد.
  • الطبع: الطلبية فطابعة التيكيات، باش تعطيها بالتيليفون.
• كلمات السر، السواريت، التوكنات والheaders عمرهم ما كيرجعو للشاشة (خلّيه خاوي = خلّيه، مسح = حيّد).
• طلب الربط: عند المورّد الكاسة كتوجّد إيميل باش تطلب ربط (cXML، EDI عبر SFTP/FTPS، UBL/Peppol ولا الـAPI ديال المورّد) مع المعلومات ديال المحل (السمية، العنوان، نمرة TVA، نمرة الكليان، GLN) وشنو خاص؛ ف EDI مع الساروت العمومي. بدّل وصيفط؛ نسخة والأجوبة كيمشيو للإيميل ديال المحل. التاريخ ديال الطلب كيبان عند المورّد. ف Sligro كيمشي ل koppelingen@sligro.nl، وإلا عمّر العنوان ديال الأكاونت مانجر ديالك.
• مورّد ديالك (ماشي من اللائحة) يقدر يدير كلشي من غير داكشي اللي خاص المورّد براسو يوفّرو: الإيميل، الملف والطبع ديما خدامين؛ الربط ولا الرفع غير بالمعلومات ديال داك المورّد.
• نهارات الطلب والتوصيل: نهارات الطلب، آخر وقت، مدة التوصيل (تاريخ التوصيل اللي بغيتي ف الطلبية) والمبلغ الأدنى ديال الطلب. أوتوماتيكي: ف نهارات الطلب من داك الوقت الكاسة كتوجّد طلبية كمسودة بوحدها (نتا كتراجعها) ولا كتصيفطها نيشان (بالإيميل، بالرفع ولا بالربط؛ تحت المبلغ الأدنى ديال الطلب غير كتوجّدها كمسودة). مرة ف النهار لكل مورّد.
• لكل منتوج (الإعدادات → المنتوجات → (المنتوج) → السطوك، فـ لكل منتوج) ولكل مكوّن: اطلب من عند (المورّد)، النمرة ديال الطلب عند داك المورّد، EAN، لكل باكية (صندوق ديال 24 = 24)، السمية ديال الباكية وثمن الشرا لكل باكية. مستوى التنبيه هو الوقت باش تطلب؛ كمّل حتى شحال خاص يكون من بعد.
• طلبيات الشرا (الأونگلي طلبيات الشرا):
  • اقتراح ديال الطلبية لكل مورّد: كلشي اللي وصل لمستوى التنبيه ولا تحتو. اللي تطلب وباقي ما وصلش (فالطريق) محسوب، باش ما تطلبش شي حاجة جوج مرات. الاقتراح = كمّل حتى − اللي كاين − فالطريق (بلا كمّل حتى: حتى لمستوى التنبيه)، مدوّر للفوق لباكيات كاملين. بدّل الأعداد وصاوب الطلبية.
  • الطلبية كتكون الأول موجّدة كمسودة: الأعداد، السطور بوحدهم (بلا منتوج، بحال الكلينكس)، الملاحظة ونهار التوصيل باقي يتبدلو. من بعد صيفط (بالطريقة ديال المورّد ولا بطريقة أخرى هاد المرة). إيلا ما نجحاتش (بحال المورّد رفضها)، السبب كيتكتب حداها وتقدر تعاود.
  • توصلات: لكل سطر العدد اللي توصل (معمّر بالعدد اللي تطلب)؛ السطوك كيزيد بالباكية (2 صناديق ديال 24 = 48)، مع الطلبية فالتاريخ.
  • كل فيشي (CSV، Excel، UBL، EANCOM، cXML) تقدر حتى تنزّلو بوحدو.
• اللي تصيفط، اللي ما نجحش، اللي توصل واللي تلغى كيتسجّلو فالسجل. لائحة الطلبيات العادية كتبقى خدّامة؛ إيلا كان عند منتوج مورّد من اللائحة، كيبان تما تحت داك السمية.

تسيير التقييمات

قرا التقييمات ديال Google وTrustpilot فـ الكاسة وجاوب عليهم. شعلها فـ الإعدادات ← الپوانات والتقييمات ← تسيير التقييمات (عادةً مطفي، وعاد ما كيبان منو والو فتا بلاصة). القراية والجواب فـ الرابور ← التقييمات (الحق قرا التقييمات وجاوب عليهم، بشكل افتراضي حتى للمسير). إلا طفيتيها، الروابط والتقييمات كيبقاو محفوظين.

• من بعد، كل محل غير كيكليكي على ربط مع Google وكيدخل بحساب Google ديال الملف التجاري ديالو. مفتاح Places حتى هو يقدر يتدار مركزي (وديك الساعة المصاريف على المورّد). Trustpilot لكل محل: كل محل عندو حساب Trustpilot Business ديالو (الـ API كيجي مع اشتراك بالخلاص)، ومنو كيجيو المفتاح، السر والـ business user ID. ف الكاشير، حدا كل طريقة كاين "شكون اللي كيدير هادشي؟".
• الأپليكاسيون ديال المورّد (من بوابة الكليان): إلا كان الأپليكاسيون ديال Google و/ولا ديال Trustpilot ديال المورّد ف بوابة الكليان (شوف الـ README ديال horecapos-portaal، "Reviews: apps van de leverancier")، الأدمين كيختار ف الدخول والمفاتيح الأپليكاسيون ديال المورّد (هو الافتراضي ف ربط جديد إلا كان البوابة فيها الأپليكاسيون). المحل كيضغط على ربط مع Google ولا دخل بـ Trustpilot وكيدخل بالحساب ديالو؛ الكاسة كتسنى بوحدها حتى يكمل الدخول (كل 3 ثانية، ماشي كثر من 15 دقايق) وكتجيب الـ tokens من البوابة مرة وحدة. التجديد حتى هو كيدوز من البوابة. ما محتاجش client-ID ولا secret ولا مفتاح API ف الكاسة؛ ف Trustpilot خاص غير الدومين، وللأجوبة الـ business user ID. Trustpilot العمومي كيقرا ملي هكا بالمفتاح ديال البوابة. خاص PORTAAL_URL وPORTAAL_SLEUTEL. الأپليكاسيون ديالك ولا مفتاح API كيبقى خدام بحال اللي لتحت.
• ديال من هوما التقييمات: كيبقاو ف البروفيل ديال الشركة ديال المحل على Google وف الصفحة ديالو على Trustpilot، والكاسة كتحفظهم غير ف الداتاباز ديال الكاسة ديالو. الأجوبة كيبانو بسمية المحل. البوابة كدوّز غير الدخول (ف الذاكرة، ماشي كثر من 15 دقايق، كيتجاب غير مرة وحدة) وما كتحفظ لا تقييمات لا tokens؛ سمية الأپليكاسيون ديال المورّد كتبان غير ف شاشة الموافقة.
• سجّل براسك: عند كل پلاطفورم كاين ليان باش دير براسك البروفيل ديال الشركة على Google (business.google.com/create) ولا حساب Trustpilot Business (business.trustpilot.com)، وعند Trustpilot ليان للاشتراكات (business.trustpilot.com/plans). التسجيل والخلاص كيكونو عند الپلاطفورم نيت؛ ما كاينش API لهادشي.
• من بعد ربط مع Google ودخل بالحساب اللي كيسير البروفيل ديال الشركة. فرع واحد فـ البروفيل = كيتختار ديريكت؛ كثر = ختار فـ الكاسة.
• Google Places (غير القراية): بالـ Place ID والساروت API ديال Places API (ولا GOOGLE_PLACES_API_KEY): المعدل، عدد التقييمات و5 ديال التقييمات اللي عندهم علاقة أكثر. بهاد الطريقة ما تقدرش تجاوب.
• Trustpilot Business (قراية وجواب): الساروت API والسر API ديال تطبيق فـ Trustpilot Business (Integrations ← API؛ ولا TRUSTPILOT_API_KEY وTRUSTPILOT_API_SECRET)، الدومين ديال المحل (الكاسة كتقلب على الـ business unit) و، باش تجاوب، الـ business user ID ديال اللي كيجاوب.
• Trustpilot العمومي (غير القراية): غير الساروت API.
• الكاسة كتجيب كل 30 دقيقة (وديريكت من بعد الربط؛ جيب دابا). الإيميل ونمرة الكوموند ديال الزبون (اللي كيصيفطهم Trustpilot) الكاسة ما كتحفظهمش.
• الرابور ← التقييمات: المعدل، العدد لكل نجمة، بلا جواب وما تقراوش؛ فلتر حسب المنصة، النجوم، بلا جواب وما تقراوش. لكل تقييم جاوب (ما يفوتش 4000 حرف؛ أي واحد يقدر يقراه)، بدل الجواب، حيد الجواب وتقرا. التقييم الجديد ولا اللي تبدل كيولي ما تقراش. فـ السجل كيتكتبو review_beantwoord وreview_antwoord_weg.
• فك الربط كيخلي التقييمات اللي تجابو.

الماركوتينغ ب SMS والإيميل

ميساجات للكليان ديال كارط الفيدليتي اللي عطاو الموافقة ديالهم. بلا كارط الفيدليتي ما يمكن تشعل حتى واحد فيهم.

• الموافقة لكل كليان ولكل قناة: ملي كيتزاد كليان جديد فالكاسة كاينين العلامات "الكليان بغا يوصلوه الحملات ب SMS" و "... بالإيميل" (طافيين بشكل افتراضي). فـ الرابور ← الكليان كتشوف وكتبدّل الموافقة (مع التاريخ فاش تعطات) و عيد الميلاد (غير النهار والشهر). باش يحيّد الاشتراك: حيّد العلامات وسجّل.
• المينو كيتحدّث دغيا: إلا شعلتي ولا طفيتي الماركوتينغ ولا كارط الفيدليتي، الكاسة كتعاود تصيفط المينو للمتجر ديال الأنترنيت ف شي ثواني (غير إلا تبدّل شي حاجة)، باش العلامة تبان ولا تختفي دغيا.
• الموافقة عبر المتجر ديال الأنترنيت: إلا كان عند المحل متجر ديال الأنترنيت، ف الخلاص كتبان العلامة "بغيت نتوصل بالعروض فالإيميل/SMS" (غير القنوات اللي شاعلين؛ عادةً مطفية). ملي كتجي شي كوموند بحال هادي، الكاسة كتقلّب على الكليان بنمرة التيليفون (ولا بالإيميل)، كتصاوبو إلا خاص وكتسجّل الموافقة مع التاريخ. النمرة ولا العنوان اللي ناقص عند كليان كاين كيتزاد؛ ف السجل كيبان klant_toestemming مع المصدر webshop.
• الرابور ← الماركوتينغ (الحق: تسيير كارط الفيدليتي): لفوق شحال من كليان وافق على SMS وعلى الإيميل.
• الحملات (مرة وحدة): السمية، SMS ولا الإيميل، (الموضوع،) نص فيه {naam} و {zaak} و {punten}، وإيلا بغيتي غير الكليان اللي غابو شي مدة ولا عندهم على الأقل هاد العدد ديال النقط. شوف كيبيّن لشحال من كليان غادي يمشي، الميساج كيفما غادي يوصل للكليان وشحال من SMS لكل كليان. صيفط تجربة للنمرة ولا العنوان ديالك. من بعد صيفط: الكاسة كتصيفط فالخلفية (على الأكثر 1000 فالمرة) وكتحسب شنو تصيفط وشنو ما نجحش. حتى واحد ما كيوصلو نفس الحملة جوج مرات؛ إيلا الكاسة وقفات فالنص، كمّل الإرسال كيكمّل مع اللي مازال ما وصلو والو.
• صيفط عبر Mailchimp ولا Klaviyo (مع ربط بليستة مختارة، شوف لتحت): ف حملة بالإيميل كتختار ف صيفط عبر الكاسة (السيرفور ديال الإيميل ديالها، بحال الفوق) ولا Mailchimp ولا Klaviyo. عاد الكاسة كتحدّث الليستة الأول (الإلغاءات، النقط) وكتصاوب تمّا حملة للكليان المختارين اللي ف الليستة بالضبط (Mailchimp: مجموعة ثابتة ف الـ audience؛ Klaviyo: ليستة خاصة بالحملة)، وكتصيفطها بالمرسل الافتراضي ديال الـ audience ولا الحساب. {naam} و{punten} كيعمّرهم Mailchimp/Klaviyo لكل كليان؛ اللينك ديال إلغاء الاشتراك ديال الخدمة كيكون لتحت. ما كاينش حد ديال 1000 ف كل مرة وما كاينش كود التخفيض الشخصي ({code}). إلا ما نجحاتش، الحملة كتبقى مسودة مع الميساج. التاب ديال الماركوتينغ كاين حتى إلا كان غير الربط شاعل (عاد غير حملات عبر Mailchimp/Klaviyo؛ صيفط تجربة ممكن بالسيرفور ديال الإيميل ديال الكاسة). الميساجات الأوتوماتيكية ديما كتصيفطهم الكاسة براسها؛ ف Mailchimp/Klaviyo كتصاوبهم ك Customer Journey ولا Flow. المفتاح ديال Klaviyo: حتى الحق ديال الكتابة ل Campaigns وTemplates (اللي دخل من قبل: يدخل عاوتاني).
• ك نوتيفيكاسيون عبر المتجر ديال الأنترنيت (إلا كانت النوتيفيكاسيونات مع العروض شاعلة ف تسيير المتجر): ف صيفط ب ختار نوتيفيكاسيون (المتجر ديال الأنترنيت ك أبليكاسيون)، مع عنوان (ماكسيموم 60 حرف) ونص قصير (ماكسيموم 200 حرف؛ غير {zaak} اللي كيتعمّر، حيت المتجر ما كيعرفش شكون هو الضيف). الكاسة كتصيفط البروموسيون عبر بوابة الإدارة للمتجر ديال الأنترنيت، وهو كيصيفطها للضياف اللي شعلو تمّا العروض ف النوتيفيكاسيون؛ ملي كيكليكيو كيتحل المنيو ديال المتجر. من بعد شي ثواني كيبان عند البروموسيون شحال وصلات. ماكسيموم 3 ف النهار، مجموعين مع داكشي اللي كيصيفط المحل من تسيير المتجر؛ وإلا البروموسيون كتبقى مسودة مع السبب. التبويب ديال الماركوتينغ كاين حتى إلا كان غير هادا مشعول (بلا كارط الفيدليتي ولا الماركوتينغ بالإيميل). بلا كود التخفيض وبلا اختيار (الأيام، النقط)؛ للتجربة: شعّل العروض ف النوتيفيكاسيون ف المتجر ديال الأنترنيت على التيليفون ديالك.
• أوتوماتيكي: ميساج عيد الميلاد (نهار عيد الميلاد، مرة فالعام) و "توحّشناك" (من بعد هاد العدد ديال الأيام بلا زيارة، مرة على كل غيبة ديال الكليان). شاعل/طافي لكل ميساج؛ كيتصيفطو غير فالنهار (10:00–20:00).
• كود تخفيض شخصي (اختياري، لكل ميساج ولا بروموسيون؛ غير إلا كانو أكواد التخفيض شاعلين فالإعدادات → المحل): كل كليان كياخد كود ديالو، بحال TERUG-7K4Q2M (عيد الميلاد JARIG-…، بروموسيون ACTIE-…)، بالنسبة المئوية ولا بمبلغ ثابت، وإلا بغيتي مع حد أدنى ديال الطلبية، كيتخدم مرة وحدة، وصالح لعدد ديال الأيام من بعد الإرسال (عادةً 30)، فالكاسة و/ولا فالمتجر ديال الأنترنيت. حط {code} و{geldig} فالنص فين بغيتيهم؛ وإلا الكاسة كتحط تحت الميساج "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". «شوف» و«صيفط تجربة» كيبيّنو كود مثال (TERUG-VOORBEELD، ما خدامش). إلا ما تصيفطش الميساج، الكود ما كيتصاوبش. فالبروموسيون كيبان شحال من كود تعطى وشحال تخدم.
• إلغاء الاشتراك مكتوب تحت كل ميساج: ف SMS "بغيتي تحيّد الاشتراك؟ عيّط ل ... ولا قولها فالزيارة الجاية"، وفالإيميل ليان ديال إلغاء الاشتراك للإيميل ديال المحل (حتى البوطونة إلغاء الاشتراك ف Gmail و Outlook). الجواب على الإيميل كيمشي للمحل.
• الخصوصية (GDPR): غير الكليان اللي وافقو وعندهم نمرة ولا عنوان؛ ما كاينين لا نمر لا عناوين فالسجل، ولكن كاين لكل حملة شحال تصيفط وشحال ما نجحش. إيلا مسحتي كليان، كيمشي حتى من لائحة الإرسال.
• المصاريف: SMS كيتصيفطو من الكونط ديالك ف CM.com (كثر من 160 حرف = بزاف ديال SMS لكل كليان). Gmail والسيرفورات الأخرى ديال الإيميل عندهم حد يومي؛ إيلا كانو عندك بزاف ديال الكليان صيفط على دفعات.

البوربوار لكل خدّام

ف الإعدادات → المحل → البوربوار (غير إلا كان "بيّن البوطونات ديال البوربوار ملي تخلّص الحساب" مشعول) كتختار كيفاش البوربوار لكل خدّام كيبان ف الحالة دابا (X)، رابور Z (التيكي والإيميل) والمبيعات حسب المدة (حتى ف CSV):

السنتيمات اللي بقاو كيمشيو للي قريب أكثر للسنتيم الجاي، باش المجموع ديما يكون صحيح. هادا غير ملخص: الكاسة ما كتخلّص والو (هادشي تقدر تديرو ب "خرّج الفلوس من التيروار"). رابورات Z القدام كيبقاو كيف كانو.

الرابور Z فالإيميل

دخّل مرة وحدة ف الإعدادات → المحل → صيفط رابور Z ل الإيميل ديال المسؤول (بزاف ديال العناوين: فاصلة بيناتهم، ماكسيموم 3). من بعد سدّ النهار رابور Z كيمشي بوحدو لداك العنوان، حدا التيكي المطبوع. خاوي = بلا إيميل، بحال ديما.

• الإرسال ديال الإيميل كيوقع فالخلفية، باش سيرفور ديال الإيميل اللي بطيء ما يعطّلش السدّان ديال النهار.
• ما نجحش ولا خاصك تعاود: الرابور → رابورات Z القدام → (الرابور) → عاود صيفط (مكتوب عليه KOPIE).

ملخص النهار (اختياري)

إلا كان شي عنوان فصيفط الرابور Z بالإيميل لـ، كتبان تحتو الخانة مع ملخص قصير ديال النهار فالفوق ديال الإيميل (بشكل افتراضي مطفي). شاعل = فالفوق ديال الإيميل ديال الرابور Z شي سطورة بكلام ساهل، غير من المعلومات ديال الكاسة براسها (بلا ذكاء اصطناعي، والو ما كيخرج لبرّا):

• المداخيل، التيكيات والضياف وشحال تصرف فكل تيكي، مقارنة مع نفس الوقت سيمانة قبل (بالبورسونطاج)؛ إلا ما كان والو ديك الساعة، كيتكتب هادشي؛
• ال 5 ديال المنتوجات اللي تباعو كتر، وشنو اللي باين: المنتوجات اللي تباع منهم على الأقل 3 كتر ولا قل من السيمانة اللي فاتت؛
• العدد ديال الستورنوات (مقارنة مع السيمانة اللي فاتت) والساعة اللي فيها كتر الخدمة (التيكيات والمداخيل).

الرابور Z براسو (التيكي والإيميل) كيبقى بحال بحال. شوف نموذج ديال اليوم كيوري الملخص من آخر تسدّيد النهار حتى لدابا. الملخص بالهولندية، بحال الإيميل ديال الرابور Z.

الداشبورد

الأونغلي الداشبورد فالرابور (الحق المبيعات حسب المدة)، غير للقراية:

• المبيعات فكل ساعة كمبيان: النهار اللي ختاريتي (زرق) حدا نفس النهار فالسيمانة اللي فاتت (رمادي). اليوم كيتقارن مع السيمانة اللي فاتت حتى لنفس الوقت، باش النسبة تكون عادلة. ب ◀ ▶ ولا بالتاريخ كتختار نهار آخر.
• الخانات: المبيعات (± % مقارنة مع السيمانة اللي فاتت)، التيكيات والمعدل لكل تيكي، المعدل اللي كيصرف كل كليان (غير فالبلاصة؛ ياخدها معاه/التوصيل ما كيتحسبوش) لداك النهار وللمدة اللي ختاريتي.
• أحسن 10 منتوجات والسوايع اللي فيهم الضغط فآخر 7، 28 ولا 90 يام. السوايع اللي فيهم الضغط هي خريطة حرارية نهار السيمانة × الساعة (معدل المبيعات لكل نهار محلول) مع التلاتة ديال السوايع اللي فيهم أكثر ضغط الفوق، مزيانة باش تنظم البلانينغ.

بونات كادو اللي تباعو ما كيتحسبوش كمبيعات، والتخفيضات والعناوين ديال المونو ما كيدخلوش ف أحسن 10 (بحال فالرابورات الأخرى). النهار كيمشي من 00:00 حتى ل 24:00.

رابورات زايدة

تلاتة ديال الأونگليات زايدين ف الرابور، كل واحد كيتشعل بوحدو من الإعدادات → المحل → التسيير والرابورات → رابورات زايدة (افتراضيا طافي: يعني ما كاين حتى أونگلي). كيطلبو نفس الحق ديال المداخيل حسب المدة وغير للقراية. المدة: هاد السيمانة، السيمانة اللي فاتت، هاد الشهر، الشهر اللي فات، آخر 90 يوم، هاد العام ولا ختار براسك (ماكسيموم شي حاجة كثر من عام).

• هندسة المنيو: لكل منتوج شحال تباع (الحصة ديالو من كاع الحبات اللي تباعو) مقارنة مع شحال كيدخّل ف الحبة (الهامش = ثمن البيع بلا TVA ناقص التكلفة). كل منتوج كياخد تصنيف: نجمة (مطلوب وفيه هامش كبير: خليه كيف هو)، عود الحرث (مطلوب، هامش قليل: زيد شوية فالثمن ولا رخّص التكلفة ديالو)، لغز (قليل البيع، هامش كبير: بيّنو مزيان) وكلب (قليل البيع، هامش قليل: حيّدو من الكارطة ولا بدّلو). مطلوب = على الأقل 70% من حصة متساوية؛ هامش كبير = على الأقل الهامش المتوسط ف كل حبة تباعت. التكلفة كتجي من Apicbase (الإعدادات → الوصفات)، وإلا من ثمن الشرا ديال المنتوج (ثمن الشرا لكل باكية مقسوم على العدد اللي ف الباكية)، وإلا من الوصفة ديال المكونات اللي عندها ثمن الشرا (السطوك). المنتوجات اللي ما عندهاش التكلفة كيبانو بوحدهم لتحت. اختياري حسب مجموعة المنتوجات (?groep=).
• الحملات والأكواد: لكل كود التخفيض، لكل حملة من الماركوتينغ (الأكواد الشخصية مجموعين) ولكل هابي آور: شحال من مرة تستعمل (التيكيات؛ ف الهابي آور حتى الحبات)، شحال ديال التخفيض، المداخيل والمتوسط ديال كل تيكي.
• الضياع: شنو تنقّص من السطوك (الإعدادات → السطوك، نقّص من السطوك (−))، حسب السبب (الحروف الكبار والفراغات ما كيفرقوش) وحسب المنتوج ولا المكوّن، مع القيمة بالتكلفة؛ وشنو تلغى من بعد ما كان ديجا تصيفط للكوزينة ولا للبار، مع قيمة البيع وقيمة التكلفة.

التخفيضات

المانجير ولا المسؤول كيشوف فالشاشة ديال الكوموند حدا المجموع البوطونة % تخفيض:

• على التيكي كامل ولا على سطر واحد؛
• ك نسبة (10، 15، 20، 25، 50، 100% = فابور، ولا كتبها براسك) ولا ك مبلغ ثابت؛
• ديما مع سبب (الخدّامة، كليان دايم، شكاية، عرض، استعمال شخصي ولا كتبو براسك).

التخفيض كيبان كسطر بوحدو فالتيكي ("تخفيض 10%"، والسبب تحتو) بنفس النسبة ديال TVA، باش المجموع والتفصيل ديال TVA يكونو صحاح. على التيكي كامل، التخفيض كيتقسم على كل نسبة ديال TVA. باش تحيدو: كليكي على المبلغ ديال السطر ديال التخفيض. إلا تلغى سطر عندو التخفيض ديالو، داك التخفيض كيمشي معاه. إلا حيّدتي منتوج من تيكي فيه تخفيض بالبورسونطاج على التيكي كامل، الكاسة كتعاود تحسب داك التخفيض على اللي بقا (فبلجيكا UC226)؛ أما المبلغ الثابت كيبقى وكيتقسم من جديد على السطورة فالخلاص. إلا بسبب 100% تخفيض ما بقا والو للخلاص، كتسدّ ب "سدّ (ما كاين ما يتخلّص)". التخفيضات كيبانو فالسجل، وفالرابور X/Z وفالملخص ديال المدة ك "منهم تخفيض". فالريتور ديال تيكي فيه تخفيض، التخفيض كيرجع بالنسبة.

أكواد التخفيض (اختياري)

أكواد فيهم تخفيض على التيكي كامل، مثلا ل شي پروموسيون (ZOMER10). كتشعلهم ف الإعدادات → المحل → أكواد التخفيض (عادةً مطفي)؛ والأكواد كتصاوبهم ف الإعدادات → أكواد التخفيض (الحق: تسيير المنتوجات):

• تخفيض فالمية ولا مبلغ ثابت، وإلا بغيتي مع حد أدنى ديال مبلغ الكوموند، صالح من/حتى وماكسيموم ديال المرات (خاوي = بلا حد)؛
• لكل كود: ف الكاسة و/ولا ف المتجر ديال الأنترنيت (الكاسة كتصيفط الأكواد مع المنيو؛ الاستعمال كيتحسب للكاسة والمتجر بجوج).

ف شاشة الكوموند كاين البوطون كود التخفيض (أي واحد يقدر يدخّل كود؛ الكود صاوبو المحل من قبل). التخفيض كيطلع كسطر "كود التخفيض CODE" ف التيكي، مقسوم على نسب TVA؛ كود واحد ف كل تيكي، وما بقاش ممكن إلا تخلّص شي حاجة (ولا كلشي). إلا حيّدتي السطر ولا تلغات الكوموند، الاستعمال ما بقاش كيتحسب. إلا حيّدتي كود مستعمل كيتطفى (والرابورات كيبقاو مضبوطين). كلشي مكتوب ف السجل (كود التخفيض). الكود: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

ما كيبانوش فاللائحة فالإعدادات → أكواد التخفيض (ولكن العدد ديال كل بروموسيون كيبان فالرابور → الماركوتينغ) وكيمشيو للمتجر ديال الأنترنيت مادام صالحين وما تخدموش.

الرابورات وسدّان النهار

البوطونة الرابور فالبار اللي الفوق:

• الحالة دابا (X): المبيعات، TVA، طرق الخلاص، حسب المجموعة والتيروار ديال الكاسة من آخر سدّان ديال النهار. تقدر تطبعو حتى هو. ما كيسدّ والو.
• سدّ النهار (Z) (المدير ولا المسؤول): حسب التيروار ديال الكاسة (كيبان الفرق مع الفلوس ديال البداية + الكاش)، دخّل الفلوس ديال البداية ديال النهار الجاي، وسدّ. الرابور Z كياخد نمرة متسلسلة، كيتسجّل وكيتطبع ف الطابعة ديال التيكي. ما تقدرش تديرها ما دام كاينين كوموندات محلولين. اختياري: حسب حسب كل بيسة وكل ورقة (مساعدة ف الحساب) كتعمّر ليك المبلغ اللي حسبتي؛ والحساب حسب كل بيسة/ورقة كيبان حتى هو ف الرابور Z. إلا بغيتي تكتب المجموع بيدك كيخدم بحال ديما.
• التيروار ديال الكاسة (المدير ولا المسؤول، اختياري):
  • فلوس خارجة من التيروار (تدّيهم للبانكة، مصروف، بوربوار تخلّص) ولا فلوس داخلة للتيروار (الصرف) مع المبلغ والسبب. التيروار كيتحل وكيخرج تيكي صغير فيه بلاصة للتوقيع باش تخليه مع الفلوس (تقدر تطفيه). كيتحسب ف اللي خصو يكون ف التيروار وكيبان سطر بسطر ف الرابور X و Z.
  • دخّل ولا صحّح الفلوس ديال البداية ديال اليوم (عادةً كتدخلهم ملي كتسدّ النهار، للنهار الجاي).
  • حلّ التيروار بلا بيع، مع السبب.
  • كلشي كيتسجّل ف السجل. إلا ما كتستعملش هادشي، سدّان النهار كيخدم بالضبط بحال قبل (الفلوس ديال البداية + الكاش = اللي خصو يكون ف التيروار).
• تحت المداخيل كيبان عدد الضياف (الناس ديال الكوموندات اللي تخلّصو) والمعدّل لكل ضيف، حتى ف الرابور X/Z المطبوع.
• المداخيل حسب المدة (المدير ولا المسؤول): اليوم، البارح، هاد السيمانة/السيمانة اللي فاتت، هاد الشهر/الشهر اللي فات، هاد العام ولا ختار بيدك من-حتى. كيبيّن المداخيل، TVA، طرق الخلاص، البوربوار، الضياف، الأصناف، حسب النهار وحسب الخدّام. ب صدّر (Excel/CSV) كتاخد فيشي للكونطابل (نقطة-فاصلة وفاصلة للأعشار، كيتحل نيشان ف Excel الهولندي).
• الرابورات Z اللي فاتو: لائحة فيها المداخيل والفرق ف الكاسة؛ حلّهم واطبع نسخة (مكتوب عليها "KOPIE").

تصدير للمحاسبة

الرابور → المداخيل حسب المدة → التصدير للحسابات (الجورنال) (الصلاحية المداخيل حسب المدة) كيدير CSV فيه قيد ف الجورنال لكل نهار، واجد باش يتقرا ف e-Boekhouden وExact وSnelStart وTwinfield وهادشي (عبر الاستيراد ديال CSV/قيود التسوية ديالهم)، ولا وحدة من الفورمات اللي لتحت (UBL، XAF وفورمات واجدين ل 14 برنامج).

لكل نهار وثيقة وحدة (KASSA-JJJJMMDD) اللي ديما متوازنة (المدين = الدائن):

الرجوعات والتخفيضات ديجا داخلين ف التيكيات وكينقّصو من المداخيل. الأعمدة: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (نقطة-فاصلة، فاصلة للأعشار). من بعد التحميل، الكاسة كتقول ليك واش كاينين شي أيام ما متوازنينش ولا فيهم فرق كبر من التقريب.

حدا البوطونة كتختار الفورما (الاختيار كيتحفظ ف المتصفح). نفس الجورنال، ولكن مرتّب بطريقة اللي البرنامج يقدر يقراه نيشان. اللائحة كتبيّن غير الفورمات ديال البلاد ديال المحل (الإعدادات → المحل)، الأول المعايير (CSV، UBL، XAF)، من بعد البرامج على حساب الحروف:

نظرة عامة: أشمن برنامج حسابات وبأشمن طريقة

حسب الصنف، على حساب الحروف. NL/BE = ف أنهي بلاد خدّام البرنامج: ف الإعدادات → المحاسبة → برنامج الحسابات كتشوف غير البرامج ديال البلاد ديال المحل (البرامج الهولندية ما خدّامينش ف بلجيكا والعكس). مباشر = الكاسة كتسجّل بوحدها كل نهار (الاختيار ف الإعدادات → المحاسبة → برنامج الحسابات)؛ على حساب الطلب = كاين API، ولكن خاصو الأول تسجيل شريك ولا موافقة عند المورّد (علّمنا). ملف = الفورما ف التصدير للحسابات. فين يمكنو بجوج، تقدر تخدم بجوج. اللائحة كاينة ف packages/shared/src/boekhoudcatalogus.ts وكتبان حتى ف الإعدادات → المحاسبة.

خلّي الكونطابل يشوف أول استيراد. الفورما كاينة ف packages/shared/src/journaalexport.ts (مع التيستات).

الإعدادات ← المحاسبة (الصلاحية ضبط المحل، الخلاص والطابعات): الكود ديال الجورنال (عادةً MEM) والحساب ف الدفتر الكبير لكل جزء. خاوي = حساب مثال (NL: 8000/8010/8020 المداخيل، 1500/1510 TVA، 1000 الكاش، 1100 لكارط؛ BE: 7000xx المداخيل، 451000 TVA، 570000 الكاش). خلّي الكونطابل يعمّر الحسابات الحقيقية.

الربط مع برنامج الحسابات

ربط مباشر مع Acumulus وAFAS Profit وMicrosoft Dynamics 365 Business Central وExact Online وHorus وMoneybird وOdoo وQuickBooks Online وSAP Business One وSilvasoft وSnelStart وTwinfield وXero وYuki وZoho Books. من بعد كل نهار الكاسة كتسجّل نفس القيد ديال التصدير اللي لفوق (المدخول و TVA على حساب كل نسبة، طرق الخلاص، البوربوار، التقريب، التيروار والفرق فالكاسة) كقيد تسوية ف البرنامج اللي ختاريتي، بالدفتر وحسابات الدفتر الكبير ديال الإعدادات → المحاسبة. ديما كيكون شاعل برنامج واحد على الأكثر.

• اللائحة مقسّمة حسب الصنف (المقاولات الصغيرة والمتوسطة والمستقلين، دولي، الشركات الكبار والسلاسل) وكتبيّن غير البرامج اللي خدّامين ف البلاد ديال المحل؛ السيرفر كيرفض برنامج من بلاد أخرى (400) وما كيسجّلش بيه (409). نيشان تحتها المسيّر كياخد بالضبط الخانات ديال داك البرنامج؛ الربط واللائحة ديال النهارات المسجّلة كاينين تحت حسابات الدفتر الكبير، وتحتهم الملخّص ديال كاع البرامج لهاد البلاد. إيلا كانو جوج شاعلين ف التحديث (ف نسخة قديمة كان ممكن)، Exact Online كيبقى شاعل والبرنامج الآخر كيطفا.

• OAuth (Horus، QuickBooks، Twinfield، Xero، Zoho): سجّل تطبيق مرة وحدة عند البرنامج.
• ف شي برامج الخانات ديال API ما يمكنش تتأكّد كاملين من الوثائق العمومية (من بيناتهم Horus، Zoho Books، الإشارة ف Business Central والتركيبة ف SAP Business One): ديما خلّي المحاسب يراجع القيد الأول.
• Exact Online: كيسجّل القيد كقيد تسوية ف الإدارة المحاسبية اللي ختاريتي.
  • الاختيار ف الإعدادات → المحاسبة → برنامج الحسابات → Exact Online (عادةً مطفي). بلجيكا: الكاسة كتستعمل بوحدها start.exactonline.be.
  • الإعدادات ← المحاسبة ← Exact Online: ربط مع Exact Online كيحل الدخول ل Exact؛ من بعد كيبان مع أنهي إدارة محاسبية الكاسة مربوطة. دخّل ف الدفتر الكود ديال دفتر التسوية ف Exact (بحال 90) وتأكد بلي حسابات الدفتر الكبير كاينين ف Exact.
  • إمتى: نيشان من بعد سدّ النهار ومن بعد كل ساعة، لكل الأيام اللي فاتو (حتى للبارح) من سجّل من (بشكل افتراضي نهار الربط؛ الأيام اللي قبل راه عند الكونطابل). كل نهار مرة وحدة؛ الأيام بلا مدخول كيتدوّزو. سجّل دابا ديما ممكن.
  • الغلطات (حساب ما كاينش ف Exact، النهار ما متوازنش، ما كاينش الأنترنيت) كيبانو مع السبب حدا داك النهار؛ الكاسة كتعاود تجرب من بعد، والأيام اللي من بعد كيتسناو حتى ينجح (باش يبقى الترتيب مزيان). فالسجل: "exact_geboekt".
  • TVA كتسجّل فحسابات TVA (بلا كود TVA، بحال فالتصدير). خلّي الكونطابل ديالك يشوف أول القيود.
  • Exact: الربط كيبقى خدّام ما دام الكاسة كتستعملو (كل 10 دقيقة token جديد، وكل مرة refresh token جديد). إيلا تلغى ولا ما تستعملش مدة طويلة، الكاسة كتطلب عاود الربط. فكّ الربط كيمسح tokens؛ داكشي اللي تسجّل كيبقى.
• AFAS Profit: الرقم ديال البيئة (بحال 12345؛ الإنتاج، التيست ولا القبول)، الـ token ديال app-connector ب UpdateConnector FiEntries والرقم ديال الإدارة المحاسبية (عادةً 1). الدفتر = الكود ديال دفتر التسوية ف AFAS (بحال 90).
• الدفتر = الرقم ولا السمية ديال دفتر التسوية؛ إيلا كان غير دفتر تسوية واحد، الكاسة كتاخدو. حسابات الدفتر الكبير خاصها تكون أرقام.
• Twinfield: الدخول ب OAuth. بلا داك التطبيق الكاسة ما تقدرش تربط. الكاسة كتقلّب على الـ cluster والإدارة المحاسبية (خاوي = الأولى)؛ الدفتر = الكود ديال دفتر التسوية (بحال MEMO). كيسجّل نهائي (destiny="final").
• Yuki: مفتاح API ديال الإدارة المحاسبية (Yuki ← الإعدادات ← Webservices)؛ الإدارة خاوية = الأولى ديال داك المفتاح. كيسجّل قيد تسوية (GeneralJournal)؛ Yuki ما كيستعملش كود الدفتر.
• إمتى: نيشان من بعد سدّ النهار وكل ساعة، لجميع النهارات اللي فاتو من سجّل من (عادةً النهار ديال الربط؛ مع برنامج آخر عاوتاني من داك النهار). كل نهار مرة وحدة لكل برنامج؛ النهارات بلا مداخيل كيتفوّتو؛ ملي كاين غلط السبب كيبان حدا داك النهار والنهارات اللي من بعد كيتسناو. سجّل دابا ممكن ديما. ف السجل: "boekhoudpakket_geboekt".
• المفاتيح والـ tokens عمرهم ما كيبانو ف الشاشة (خلّيهم خاويين ملي تعاود الربط = يبقاو). ف النسخة ديال الكاسة اللي ف البوابة ما كيتسجّل والو.

ملف الأوديت ديال الكاسة (XAA)

للمحلات الهولندية، ف الرابور → المداخيل حسب المدة حدا التصدير للحسابات كاين الزر ملف الأوديت ديال الكاسة (XAA): XML Auditfile Afrekensystemen 3.2 ديال إدارة الضرائب الهولندية (Belastingdienst) و XML Platform (SRA) على المدة اللي ختاريتي (ماشي كثر من عام وشوية؛ الحق المداخيل حسب المدة). هادا هو الملف اللي كتنصح بيه Belastingdienst باش تعطي المعلومات ديال الكاسة فوقت المراقبة ولا للمحاسب؛ القواعد كاينين ف Handreiking voor een betrouwbaar afrekensysteem (دليل لنظام خلاص مضمون، docs/xaa).

فالملف (auditfile_kassa_<van>_tm_<tot>.xml، السكيما docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• المعلومات الأساسية: المحل (السمية، رقم TVA، العنوان)، الكودات ديال TVA، كاع الخدّامة (بالدور والتاريخ فاش تزادو؛ زايد SYSTEEM للحوايج اللي كتديرهم الكاسة بوحدها، بحال الويبشوب والربط) وكاع السلعة بالمجموعة ديالها؛
• الأحداث: كلشي من السجل فهاد المدة (الدخول والخروج من الحساب، تحلّ الكاشير ديال الفلوس، سدّان النهار، تبدّلو الإعدادات والأثمنة، الإلغاء، التخفيض، الرجوع، نسخة التيكي، الدخول والخروج ديال الخدمة ...) وتحلان النهار ديال الكاسة بالفلوس ديال البداية، كل واحد بالكود ديال Belastingdienst (18001 الدخول، 18003 الكاشير، 18006 تبديل فالتركيب، 18008 رابور Z، وإلا 18999)؛
• المعاملات ديال الكاسة: كل تيكي (بيع، رجوع وبروفورما، برقم التيكي، الخدّام والحالة الضريبية إلا ماكانتش مزيانة) بكاع السطور (السلعة، المجموعة، الكمية، الثمن، TVA؛ حتى التخفيضات، بطاقات الهدية، العناوين ديال المينو والسطور اللي تلغاو قبل الخلاص، هادو بمبلغ 0)، TVA على حساب كل نسبة، التقريب، الخلاص على حساب كل طريقة (كاش، كارطة، بطاقة هدية، أونلاين؛ البقشيش بوحدو) والفلوس اللي دخلات/خرجات من الكاشير ديال الفلوس.

المبالغ موجبة ب C (بيع، قبض) ولا D (رجوع، خلاص)؛ الأوقات بالوقت الهولندي مع الفرق. كاع المفاتيح هوما الـ ids ديال قاعدة البيانات بلا شرطات، يعني تقدر تلقاهم فالكاسة.

التوقيع (الفصل 6 ديال المواصفات): إلا Optimum POS دار شهادة، ملف الأوديت كيجي مسيني فواحد الغلاف (XML Signature) والملف سميتو …_ondertekend.xml؛ وإلا راه ملف أوديت بوحدو، والكاسة كتقول هادشي فاش كتحمّلو.

الخلاص على الحساب

الكليان ديال الشركات (شركة كتجيب الغدا كل سيمانة، أوطيل، جمعية) كيشريو على الحساب وكيخلّصو من بعد بفاتورة. شعّلها ف الإعدادات ← الفواتير ← الخلاص على الحساب (غير إلا كانو الفواتير مشعولين؛ عادةً مطفية).

• الكليان: ف الرابور ← على الحساب كتسجّل الكليان ديال الشركات مع المعلومات ديال الفاتورة (السمية، العنوان، رقم TVA، رقم KvK ولا رقم الشركة، Peppol-ID، الإيميل)، وإلا بغيتي حد (شحال أكثر يقدر يبقى) وأجل خلاص خاص (ولا ديال الفواتير)، وواش الفاتورة تتصيفط دغيا.
• خلّص الحساب: طريقة الخلاص على الحساب، ختار الكليان (مع شحال باقي عليه والحد). البون بيعة عادية: المبيعات و TVA ف داك النهار، ف بلجيكا عادي عبر الصندوق الكحل، وعلى البون "على الحساب". الكاسة كتصاوب الفاتورة دغيا (UBL/Peppol وباش تطبعها) بالمبلغ اللي باقي وتاريخ الأجل، وكتصيفطها بحال ما مريڭل ف الفواتير (إيميل، Peppol عبر Billit/Storecove/Banqup ولا العنوان ديالك). على الحساب هو مبلغ واحد لباقي الحساب (تقدر تخلّص جزء بشي طريقة أخرى قبل)، بلا بوربوار؛ ما يمكنش تبيع بون كادو على الحساب. إلا فات الحد، الكاسة كترفض.
• الخلاص: الكليان كيخلّص ف المحل كاش، بلكارط ولا ببون كادو (الرابور ← على الحساب ← الخلاص توصّل؛ حتى جزء). هادي ماشي بيعة جديدة وماشي بون جديد: الكاش كيدخل كفلوس فالتيروار (التيروار كيتحل)، وكلشي كيبان ف X و Z تحت المقبوض على الحساب. إلا تخلّص كلشي، الفاتورة كتولّي "مخلّصة". الخلاص أونلاين ماشي جزء من هادشي.
• الفيرمو: إلا كان IBAN ف المعلومات على الفاتورة، كيبان على الفاتورة (و ف UBL)، مع "تقدر تخلص حتى ف المحل". إلا الكليان حوّل الفلوس، كتسجّلها ب الخلاص توصّل ← تحوّل (البنكة): ماشي فالتيروار، ولكن كيبان ف X و Z تحت المقبوض على الحساب. بلا IBAN كيبان "الخلاص ف المحل". ف بلجيكا كيبان المرجع المهيكل (+++123/4567/89012+++، من نمرة الفاتورة) على الفاتورة و ف UBL، باش البنكة تصيفطو مع الخلاص.
• البنكة: قيّد التحويلات بلا ما تعاود تكتبهم، شوف لتحت.
• الرصيد (فلوس مسبّقة): ف الرابور → على الحساب → حط الرصيد كتحط فلوس مسبّقة على الحساب ديال كليان، كاش (التيروار كيتحل) ولا بلكارط، مثلا لسلسلة ديال الغدا. فالبيعة الجاية على الحساب الرصيد كيتنقص الأول من الفاتورة؛ إلا كانت الفاتورة كثر، الباقي كيبقى مفتوح. الرصيد كيبان عند الكليان (الرصيد € ...)، ف X و Z تحت المقبوض على الحساب (الرصيد تحط، بالرصيد ديال الكليان) وفالجورنال كمقبوض مسبّق (من الأول 1640 / 460000). فبلجيكا الحطان كيمشي كفلوس داخلة (signMoneyInOut) للصندوق الكحل (UC4100).
• فاتورة مجموعة (لكل كليان، مطفية من الأول): بفاتورة وحدة لكاع البونات الكليان ما كياخدش فاتورة دابا ملي كيشري على الحساب. البون كيبقى مفتوح عند الكليان (بونات باقي ما تفوترو، كيتحسب فالحد) ويقدر يتخلص من دابا. بدير فاتورة مجموعة (بحال فآخر الشهر) كاع البونات المفتوحين كيجيو ففاتورة وحدة، كل سطر قدامو نمرة البون؛ اللي تخلص كيبان مخلص. الرجوع للحساب كيبان سطور بالناقص. مطفية = فاتورة لكل بيعة بحال ديما. فبلجيكا فاتورة وحدة بكاع البونات فالصندوق الكحل (signInvoice، UC4121 وUC4122).
• بلجيكا: إلا الكليان خلّص من بعد بيعة على الحساب (كاش، لكارط، بون كادو ولا بالفيرمة)، الكاسة كتعلن هادشي ك تصحيح الخلاص فالتيكي: من الكريدي ديال الكليان لطريقة الخلاص الحقيقية (signPaymentCorrection، UC4118).
• نظرة عامة: الفواتير اللي باقي مع تاريخ الأجل (المعطّلين بالحمر)، والفواتير والخلاصات ديال كل كليان. ف الإعدادات ← الفواتير كاينة كولونة باقي.
• المحاسبة: ف الجورنال البيعة على الحساب كتمشي ل المدينين (عادةً 1300 ف هولندا، 400000 ف بلجيكا؛ كتريڭلها ف الإعدادات ← المحاسبة)، والخلاص من الكاسة، لكارط، بون كادو ولا البنكة (عادةً 1050 / 550000) ل المدينين. XAA: طريقة الخلاص "على الحساب".
• الصلاحية: خلّص الحساب على الحساب واستقبل الخلاصات على الحساب (عادةً السيرفيس لا، المدير إيه). كلشي مسجّل ف السجل.
• مطفية: الكليان والفواتير والخلاصات كيبقاو محفوظين (حتى ف السوفڭارد)؛ البوطونة كتمشي مع تصدير الإعدادات، الكليان لا (هوما ديال محل واحد).
• ف المتجر ديال الأنترنيت (اختياري، عادةً مطفي): مع حتى ف المتجر ديال الأنترنيت الكليان ديال الشركات كيكومانديو أونلاين على الحساب (الدّي والتوصيل). ف الرابور ← على الحساب كتصاوب لكل كليان كود الكليان وكتعطيه ليه؛ الكاسة كتحفظ غير نسخة مشفّرة، يعني كتشوفو مرة وحدة. كود كليان جديد = القديم مابقاش خدام؛ حيّد كود الكليان = داك الكليان مابقاش يقدر يكوماندي أونلاين على الحساب. المتجر ديال الأنترنيت كيحترم الحد. ف النافذة ديال المتجر ديال الأنترنيت كتسالي بحال هاد الكوموند ب سالي (على الحساب): الخلاص على الحساب، ومعاه الفاتورة ديريكت.

البنكة: قيّد التحويلات

ف الرابور ← على الحساب ← البنكة الكاسة كتقلب لكل تحويلة داخلة على الفاتورة على الحساب ديالها:

• دخّل الكشف ديال البنكة: الفيشي من البنكة ديالك فالأنترنيت، ب CAMT.053 (XML، كاع البنكات ف هولندا وبلجيكا)، MT940 (.sta/.940) ولا CODA (.cod، بلجيكا). غير التحويلات الداخلة؛ إلا دخّلتي نفس الكشف جوج مرات ما كيتعاودوش السطورة.
• القلبان: ب نمرة الفاتورة ولا المرجع المهيكل ف الوصف (أكيد)، وإلا ب المبلغ (والسمية): هنا كيكون اقتراح. كل سطر تقدر تقيّدو (مع الاقتراح ولا مع فاتورة أخرى)، تتجاهلو ولا من بعد تقيّدو حتى هكا. التقييد = تحوّل (البنكة) ب تاريخ البنكة، عمرو ما كيفوت داكشي اللي باقي؛ ماشي فالتيروار.
• الربط مع البنكة (PSD2، اختياري): ف الإعدادات ← الفواتير ← الربط مع البنكة الكاسة كتجيب بوحدها كل ساعة التحويلات الداخلة ب Enable Banking (بنكات ف هولندا وبلجيكا وباقي أوروبا). ختار البنكة ودخل للبنكة (حساب الشركة)؛ الموافقة صالحة 180 يوم، من بعد عاود الربط. فكّ الربط كيحيّد الموافقة؛ التحويلات الداخلة كيبقاو. بلا عقد مع Enable Banking هادشي خدام غير للحسابات ديالك نتا (restricted production).
• التقييد الأوتوماتيكي (عادةً مطفي): التحويلة الداخلة اللي أكيد ديال شي فاتورة، الكاسة كتقيّدها دغيا (حتى ملي كتدخّل الكشف).
• الصلاحية: التقييد ب خلّص الحساب على الحساب واستقبل الخلاصات على الحساب؛ ضبط الربط مع البنكة ب ضبط المحل، الخلاص والطابعات. الإدخال، الربط، الجيبان والتقييد كيتسجّلو ف السجل.
• مطفي: إلا الخلاص على الحساب مطفي الكاسة ما كتجيب والو؛ التحويلات الداخلة والربط كيبقاو محفوظين (حتى ف الباكاب).

تصاور الكاميرات فالكاسة

جميع التصاور ديال الكاميرات ديال المحل فصفحة وحدة، بلا شاشة ولا تطبيق بوحدو. شعلها ف الإعدادات → المحل → الشاشات والخدمة بالكيسة → تصاور الكاميرات فالكاسة (عادةً مطفية). من بعد كتبان البوطونة الكاميرات فالبارة الفوقانية للي عندو الحق شوف تصاور الكاميرات (عادةً المدير والمسؤول؛ ف الإعدادات → الصلاحيات تقدر تشعلها حتى للسيرفيس). جميع الكاميرات حدا بعضياتهم؛ ضغط على كاميرا باش تشوفها كبيرة. إلا طفيتيها: السيستيمات ديال الكاميرات كيبقاو محفوظين.

حتى كشاشة بوحدها: على شاشة بوحدها كيحل http://<kassaserver>:3000/camera (مثلا شاشة مور البار)، وعلى طابليط ولا تيليفون كيبيّن كود QR: الخدام كيسكانيه بالطابليط ولا التيليفون ديالو وكيدخل بالكود PIN ديالو (تما حتى هو غير بالحق شوف تصاور الكاميرات). فشاشة ضيقة الكاميرات كيبانو وحدة تحت لوخرا. شوف شاشة تانية على طابليط ولا تيليفون.

المسؤول كيزيد السيستيمات ديال الكاميرات ب + سيستيم ديال الكاميرات، كيجربهم ب جرّب وكيختار لكل كاميرا السمية وواش كاينة فالصفحة:

• Hikvision، Dahua، Axis وReolink: كاميرا ولا ريكوردر (NVR) فالريزو: عنوان IP (إلا بغيتي مع :poort)، مستخدم (حسن يكون غير للشوفان) والقنوات، بحال 1-8 ولا 1,3,5. الدخول ب Basic ولا Digest؛ https مع شهادة ديالك مقبول.
• Synology Surveillance Station: العنوان ديال NAS (البور العادي 5000، وب https ‏5001) ومستخدم؛ جيب الكاميرات كيجيب الكاميرات بالسميات ديالهم.
• UniFi Protect: العنوان ديال الكونسول (https) وكونط محلي؛ جيب الكاميرات.
• ONVIF: أي كاميرا ولا ريكوردر فيه ONVIF (بحال Hanwha، Bosch، Uniview، Annke)؛ جيب الكاميرات كيقلب على عنوان التصويرة لكل مصدر ديال الفيديو.
• عنوان ويب ديالك: تصويرة (JPEG)، ستريم MJPEG ولا عنوان rtsp://.
• صفحة الويب ديال سيستيم الكاميرات (بحال Frigate، Blue Iris ولا go2rtc): كتحل فالكاسة فالبوطونة ديال الكاميرات (ولا فنافذة بوحدها).

بلا ffmpeg: التصويرة.

الخصوصية: الكاسة كتجيب التصاور من سيستيم الكاميرات وكتدوزهم غير؛ ما كيتسجل والو (لا تسجيلات، لا كاش). المستخدمين وكلمات السر كيبقاو فالسيرفور وعمرهم ما كيبانو فالشاشة ولا فالسجل. فالسجل كاين شكون شاف الكاميرات. التصاور براسهم كتطلبهم الصفحة بمفتاح (صالح 12 ساعة، ما دام الخدّام داخل)، حيت التصويرة فالبراوزر ما تقدرش تصيفط توكن. الإكسبور ديال الإعدادات كياخد غير شاعل/مطفي.

سجل ديال العمليات الحساسة

الرابور ← السجل (المدير ولا المسؤول) كيبيّن شكون دار شنو وفوقاش.

• ختار مدة (اليوم، البارح، هاد السيمانة، هاد الشهر/الشهر اللي فات ولا بيدك من-حتى)، شنو بغيتي تشوف (عادةً العمليات الحساسة، ولا مثلا غير الإلغاءات والتخفيضات، ولا كلشي) وإلا بغيتي خدّام واحد.
• لفوق حسب كل خدّام: العدد والمبلغ ديال الإلغاءات (اللي تمسحو من بعد الكوموند)، التخفيضات والرجوعات، وشحال من مرة تحل التيروار بلا بيع، الفلوس اللي خرجات من التيروار، النسخ ديال التيكيات، البرو فورما والخلاص بلكارط باليد. كليكي على سمية باش تشوف غير داك الخدّام. وحتى شحال من مرة تدخّل كود سري غالط.
• تحت منها كل عملية مع الوقت، شكون، شنو ووصف مفهوم (مثلا "2x Cola تمسحات من بعد الكوموند € 5,60 · الطابلة 4 · السبب: الكليان ما بقاش بغاها").
• تحميل (CSV) ل Excel.

أشنو كيتسجّل: الإلغاءات، التخفيضات (والحيدان ديالهم)، الرجوعات، نسخ ديال التيكيات، الفواتير pro forma، الخلاص بالكارطة يدوي، حلان الكيسة، دخول/خروج الفلوس من الكيسة، فلوس البداية، سدّان النهار، تحويل السطورا ولا الطوابل، سدّان الكوموندات الخاويين، تبديل الثمن/السمية/TVA ديال المنتوجات، منتوجات جداد ولا متحيدين، تبديل الخدّامة والإعدادات، تعديل أوقات الخدمة، الدخول والخروج، أكواد PIN غالطين، والبوانطاج دخول وخروج. مع الخلاص على الحساب حتى: الكليان، البيع والخلاص على الحساب، قراية الكشوفات ديال البنكة، الربط مع البنكة والجيبان من البنكة. مع التنبيه ملّي الكوموند كتطوّل بزاف: الكوموندات المعطّلة والاعتذارات اللي تصيفطو. مع Mailchimp ولا Klaviyo: الاتّصال، اختيار الليستة، فكّ الربط والإلغاءات اللي جاو من تمّا. مع التحكم فالموسيقى: شاعل/مطفي والزيادة، التبديل والحيدان ديال مصادر الموسيقى. مع تصاور الكاميرات: شكون شاف الكاميرات (مرة وحدة كل نص ساعة لكل خدّام على الأكثر)، شاعل/مطفي والسيستيمات ديال الكاميرات. مع المراقبة: كل تنبيه، التقاد ديالو والتشعال والتطفية.

المراقبة: الغش والتغييرات ماشي عادية

الإعدادات ← المراقبة. جوج حوايج، كل وحدة كتشعل بوحدها ومطفية من الأول؛ التطفية كتخلي كل التنبيهات والإعدادات محفوظين. يقدر يضبط غير اللي عندو الحق ضبط المراقبة (من الأول المانجير والمسؤول)؛ يشوف التنبيهات ويقادهم اللي عندو الحق يشوف السجل. الكاسة كتشيك كل 5 دقايق (ومع شيك دابا)؛ ماشي فالكاسة ديال الظل.

مراقبة الغش والسرقة (لكل خدّام، لكل نهار خدمة من 05:00)، كل قاعدة كتشعل ولا كتطفى بوحدها مع حد ديالها:

• ستورنو من بعد Pro forma: تمسح من بعد ما الكليان شاف الحساب؛
• ستورنو، تخفيضات ورجوع: من شحال من مرة، ولا المجموع من مبلغ (0 = ماشي على المبلغ)؛
• الكاشير تحلّ بلا بيع (بوطونة حلّ الكاشير)؛
• البون محلول شحال هادي: تكوموندا ولكن من بعد شحال من دقيقة باقي ما تخلّصش.

تنبيهات على التغييرات ماشي عادية، مقارنة مع نفس نهار السيمانة ونفس الوقت فالسيمانات اللي فاتو (من الأول 4؛ النهارات بلا مبيعات ما كيتحسبوش، على الأقل جوج نهارات ديال المقارنة):

• المبيعات حتى لدابا قل (و/ولا كثر) من العادة بكثر من الهامش، غير من مبيعات عادية ديال مبلغ محدد؛
• وقت الكوزينة (من البون للكوزينة حتى يولي واجد فشاشة الكوزينة) فالساعة اللخرة فوق الهامش، ولا فوق عدد ثابت ديال الدقايق؛
• الستورنو اليوم فوق الهامش، غير من عدد أدنى.

كل تنبيه كيجي مرة وحدة (لكل قاعدة وخدّام ونهار؛ وقت الكوزينة مرة فالساعة على الأكثر) وكيمشي ل:

• الكاسة: بوطونة التنبيهات (n) فالبار الفوقاني مع تنبيهات النهار، السيمانة ولا 30 يوم اللي فاتو؛ تقاد مع ملاحظة. الشاشات الأخرى كياخدو غير إشارة بلا سميات؛
• إشعار ب ntfy (أپليكاسيون فابور؛ ntfy.sh ولا سيرفور ديالك، topic ويلا بغيتي token)، Pushover (API-token ديال الأپليكاسيون والـ user key) ولا Telegram (token ديال البوت والـ chat-id)؛

كل قناة عندها بوطونة ميساج ديال التجربة. الـ tokens والمفاتيح كيبقاو فالكاسة (الشاشات كيشوفو غير واش معمّرين). التنبيه ماشي دليل: شوف البون والسجل وهضر مع الخدّام.

التيكيات: نسخة ورجوع (تيكي ديال الكريدي)

البوطون التيكيات ف الشريط اللي لفوق:

• لائحة التيكيات من آخر سدّان ديال النهار، ولا آخر 7 ديال الأيام؛ التيكي القديم كتقلّب عليه بالنمرة ديالو.
• اطبع نسخة: نفس التيكي مكتوب عليه "KOPIE" (ف بلجيكا مع البلوك ديال FDM ديال التيكي الأصلي). كيتسجّل ف السجل.
• رجوع / تيكي ديال الكريدي (المدير ولا المسؤول): ختار ف كل سطر شحال اللي راجع، السبب وكيفاش ترجع الفلوس (كاش، لكارط، بون كادو، أخرى). التيكي القديم كيبقى كيف ما هو: كيتزاد تيكي كريدي جديد بنمرة ديالو ف الجورنال (النوع ديال التيكي retour، مبالغ ناقصة، ف بلجيكا كيمشي ل FDM ك NR). عمرك ما تقدر ترجّع كثر من اللي تباع. ف الرابور X و Z الرجوع كيتحسب مداخيل ناقصة.
• مع CCV ولا شي تيرمينال آخر: رجّع الفلوس الأول ف التيرمينال براسو ومن بعد علّم على "ديجا ترجّعو الفلوس ف التيرمينال".
• الكاش مع التقريب على 5 سنتيم: المبلغ اللي غادي ترجّع حتى هو كيتقادّ.
• رجّع للحساب (بيعة على الحساب): إلا كان التيكي على الحساب ديال كليان ديال شركة، كتختار على الحساب. المبلغ كيتنقص من الفاتورة المفتوحة والكاسة كتصاوب دغيا فاتورة أفوار (ف UBL هي CreditNote، النوع 381، مع إشارة للفاتورة؛ فبلجيكا مسنية ب signInvoice، UC4122). ما يمكنش ترجّع للحساب كثر من اللي مفتوح فالفاتورة؛ رجّع الباقي كاش ولا بلكارط. فاتورة الأفوار كتبان ف الفواتير وكتصيفطها بحال فاتورة.

الكاشير ديال الفلوس بالكابتور وكاشير لكل خدّام

بشكل عادي مطفي. كيتظبط فـ الإعدادات → الخلاص → الكاشير ديال الفلوس.

• الكابتور: بزاف ديال الكاشيرات كيقولو عبر طابعة التيكيات واش محلولين ولا مسدودين (ESC/POS DLE EOT 1، البور DK البروش 3). هادشي كيخدم غير مع طابعة التيكيات عبر الريزو. كليكي على قيس: الكاشير مسدود وقيس: الكاشير محلول؛ إيلا كان فرق، خود الحالة الصحيحة (عالي = محلول ولا هابط = محلول). ما كاين فرق = هاد الكاشير (ولا الكابل) ما فيهش كابتور. الطابعة ما جاوباتش = ما معروفش، وعمرو ما "مسدود".
  • ما تخلّصش الحساب ما دام الكاشير محلول: السيرفور ديال الكاسة كيرفض أي خلاص جديد بـ "الكاشير ديال الفلوس باقي محلول".
• كاشير خاص بكل خدّام: طابعة التيكيات تقدر تحلّ جوج كاشيرات (الكاشير 1 والكاشير 2). ختار لكل خدّام الكاشير ديالو؛ الكاسة من بعد كتحلّ ملي كتخلّص كاش، ملي كتدخّل/تخرّج الفلوس من الكاشير وفـ حلّ الكاشير الكاشير ديال اللي داخل. فـ الرابور → الكاسة كيبان من بعد كاشير لكل خدّام: فلوس البداية لكل خدّام، الكاش (بلا ماكينة الفلوس)، اللي خاص يكون، حسب والفرق لكل واحد (فالسجل كـ ladetelling). السدّان العادي ديال النهار كيبقى كيف ما هو.
• جرّب الكاشير 1 وجرّب الكاشير 2 كيحلّو الكاشير باش تشوف.
• حلّ الكاشير بلا بيع ديما كيتسجّل (مع السبب) فالسجل وفالأوديت فيشي ديال الكاسة (XAA)، كيف كتطلب الضرائب (Belastingdienst) (الاستثناءات بحال "no sale").

الجزء 3 · المسؤول

بدا الخدمة

التثبيت. HorecaPOS كتثبّتو بالبرنامج ديال التثبيت اللي مناسب للسيستيم ديالك، كاين ف الصفحة ديال التحميل ديال OptimumPOS: Android (أپليكاسيون)، Windows (برنامج التثبيت)، macOS (إنستالور ل Macs ب Apple Silicon و Intel)، Linux (إنستالور ب الواجهة، ولا الباكيت .deb ولا .rpm)، Raspberry Pi (إنستالور ب الواجهة ولا .deb ل Raspberry Pi 3، 4 ولا 5 مع Raspberry Pi OS ديال 64-bit) وChromebook (الأپليكاسيون ديال Android من Google Play). ختار لجميع المستعملين إلا بغيتي سيرفور ديال الكاسة اللي كيتربطو بيه الطابليطات وشاشة الكوزينة، ولا غير ليا إلا بغيتي غير كاسة ف داك الجهاز. الإنستالور كيحط كلشي اللي خاص، حتى الداتابيز، وكيصاوب نسخة احتياطية كل ليلة. باش تحدّث، ثبّت النسخة الجديدة: المعلومات ديالك كيبقاو. برنامج التثبيت كيبدا باللغة ديال البي سي ديالك (وإلا بالإنجليزية)؛ ف Windows و Linux تقدر تختار لغة أخرى ف الشاشة الأولى إلا بغيتي. من بعد الكاسة كتبدا نيشان بديك اللغة. الباكيتات .deb و .rpm والأپليكاسيون ديال Android كيتبعو اللغة ديال السيستيم، وإلا بالهولندية.

المسؤول كيوجّد الكاسة من الإعدادات. تما كاينين أونگلي بحال المحل، الخدّامة، الصلاحيات، أوقات الخدمة، المنتوجات، الهابي آور، السطوك، البلانات، الخلاص، الطابعات، المحاسبة، النسخ الاحتياطية، الاستيراد/التصدير والداتابيز. أنهي أونگلي كيشوفهم حتى المدير، كيتعلّق بالصلاحيات.

قاعدة البيانات. ف الإعدادات → قاعدة البيانات (غير المسؤول) كتختار بين MySQL / MariaDB، قاعدة البيانات المدمجة و PostgreSQL؛ ملي كتبدّل، كاع البيانات كتمشي معاك (شوف قاعدة البيانات). إلا كانت Optimum POS ريگلات عنوان ثابت ف التثبيت، داك العنوان هو اللي كيخدم وما كايناش خانات تعمّرها. وإلا، نتا اللي كتعمّر السيرفور، البور (Port)، قاعدة البيانات، المستخدم وكلمة السر. الكاسة كتحفظهم بوحدها، من بعد كتورّيهم عامرين، وتقدر ديما تبدّلهم ب بدّل معلومات MySQL/MariaDB ولا بدّل معلومات PostgreSQL. إلا خلّيتي كلمة السر خاوية، يعني: كتبقى كلمة السر المحفوظة (لنفس المستخدم). الإنستالور والتحديث ما كيبدّلو والو ف DATABASE_URL ولا ف قاعدة البيانات اللي ختاريتي.

المحاسبة

كلشي ديال الحسابات كاين ف الإعدادات → المحاسبة. عمّر مع المحاسب ديالك الدفتر وحسابات الدفتر الكبير. إيلا بغيتي الكاسة تسجّل المداخيل ديال النهار بوحدها كل نهار، ختار لفوق ف برنامج الحسابات البرنامج ديالك، حتى Exact Online: كتشوف غير البرامج اللي خدّامين ف البلاد ديال المحل ديالك. نيشان تحتو كتعمّر المعلومات ديال داك البرنامج وكتربط. ف البرامج اللي كتدخل ليهم (بحال Exact Online ولا Twinfield ولا Xero) كتعمّر الأول التطبيق: الـ client-ID والسر ديال الكليان. إيلا Optimum POS ضبطات البرنامج ولا شي معلومة ثابتة ف التثبيت، ما غاديش تشوف داك الاختيار ولا داك الخانة. تما كاين حتى ملخّص ديال كاع البرامج: أشمن واحدين يتربطو مباشر وأشمن واحدين كياخدو ملف. الملف كتديرو ف الرابور → المداخيل حسب المدة → التصدير للحسابات: ختار الفورما ديال البرنامج ديالك، ولا UBL (Peppol)، XAF ولا كشف ديال النهار. ديما خلّي المحاسب ديالك يراجع القيد الأول ولا الاستيراد الأول.

لمحل هولندي كاين تما حتى ملف الأوديت ديال الكاسة (XAA): XML Auditfile Afrekensystemen ديال إدارة الضرائب الهولندية (Belastingdienst) بكاع التيكيات، السطور، الخلاص والأحداث ديال الكاسة على المدة اللي ختاريتي. كتعطيه للمحاسب ديالك ولا ل Belastingdienst فوقت المراقبة.

الخلصة والتخطيط

إلا كانو الخدّامة ديالك كيخدمو بالپوانطاج (دخول وخروج)، كتلقى ف الإعدادات → أوقات الخدمة لتحت الخلصة والتخطيط، فجوج بلوكات. ف الخلصة كتختار برنامج الخلصة ديالك ولا (فبلجيكا) السكريتارية الاجتماعية ديالك، وكتعمّر لكل خدّام الرقم ديالو فداك البرنامج. من بعد كتصاوب لمدة معيّنة الملف فيه الساعات اللي تخدمات والمداخيل على حساب كل خدّام، وكتدخلو فبرنامج الخلصة. ف التخطيط ديال الخدّامة كتختار نظام التخطيط ديالك: مع Deputy و Dyflexis و Shiftbase المداخيل كتمشي كل ساعة بوحدها، ومع الآخرين كتصاوب ملف ديال المداخيل. هكا كتشوف فالتخطيط ديالك مصاريف الخلصة حدا المداخيل. إلا كنتي خدام بلا پوانطاج، تقدر مع ذلك تصيفط المداخيل للتخطيط ديالك: كتلقاها فهاد الحالة لتحت ف الإعدادات → المحاسبة، عند المداخيل للتخطيط ديالك. إلا Optimum POS حطّ شي حاجة ثابتة فالتثبيت، ما غاديش تشوف داك الاختيار ولا داك الخانة.

النسخ الاحتياطية (back-ups)

الكاسة كتصاوب نسخة احتياطية كل ليلة أوتوماتيكيا، وديما قبل أي تحديث. ف الإعدادات ← النسخ الاحتياطية كتشوف جميع النسخ الاحتياطية (فوقاش، شكون صاوبها ولا أوتوماتيك، الحجم) وتقدر تصاوب وحدة بيدك ب صاوب نسخة احتياطية. إلا كانت آخر نسخة احتياطية عندها كثر من جوج أيام، كيبان تحذير حمر: تواصل ساعتها مع Optimum POS.

الرجوع لنسخة كيتدار بالبوطون رجّع حدا شي نسخة احتياطية. كلشي اللي وقع من بعد ديك النسخة غادي يضيع. خصك تعلّم على هادشي وتعاود تدخّل الكود السري ديالك. الكاسة كتصاوب الأول نسخة احتياطية ديال الأمان ديال الحالة دابا ومن بعد كتخرّج كلشي. ف بلجيكا ما يمكنش تديرها من الكاسة (العدّادات ديال الصندوق الكحل كيبقاو ماشيين)؛ تما Optimum POS هي اللي كتديرها.

قاعدة البيانات

ف الإعدادات → قاعدة البيانات (غير المسؤول) كتشوف فين كتخبّي الكاسة البيانات ديالها. الفوق كاينة قاعدة البيانات الحالية مع البرنامج، النسخة، الجداول، السطور والعنوان ولا الدوسي. للخدامة والتابليطات، الكاسة كتخدم بحال بحال مع أي قاعدة بيانات. ف Windows وmacOS وLinux وRaspberry Pi كتختار من بين تلاتة ديال قواعد البيانات:

• MySQL / MariaDB: برنامج ديال قاعدة البيانات بوحدو (MySQL 8.0 ولا جديد، MariaDB 10.6 ولا جديد)، بحال ف سيرفور ولا NAS اللي عندك من قبل. ملي يكون هكا، گاع البيانات كيكونو ف جداول عاديين ف MySQL ولا MariaDB، والبرنامج ديال التقارير ولا BI ديالك يقدر يقراهم. الكاسة كتحسب بالضبط بحال مع PostgreSQL.
• مدمجة (PGlite): كاينة ف الكاسة براسها، ما خاصك تنصّب والو. هي أحسن اختيار لأغلبية المحلات، وهي قاعدة البيانات ف Android وChromebook.
• PostgreSQL: برنامج ديال قاعدة البيانات بوحدو ف الپيسي ديال الكاسة ولا ف شي بلاصة أخرى ف الريزو.

إمتا MySQL ولا MariaDB؟ إلا كان المحل ديالك عندو من قبل سيرفور MySQL ولا MariaDB، إلا كان المسؤول ديال IT كيخدم بيه، ولا إلا بغيتي تقرا البيانات ف التقارير ديالك، Excel ولا برنامج BI. إلا ما كنتيش متأكد، ختار المدمجة: كتخدم ديريكت.

شنو خاصك لـ MySQL ولا MariaDB؟

• MySQL 8.0 ولا جديد، ولا MariaDB 10.6 ولا جديد، اللي يقدر يوصل ليه السيرفور ديال الكاسة.
• قاعدة بيانات بوحدها للكاسة (ولا للكاسات ديال سلسلة)، بمجموعة الحروف utf8mb4.
• مستخدم ديال قاعدة البيانات اللي عندو الحق يصاوب، يبدّل، يبدّل السمية ويحيّد الجداول ف ديك القاعدة (CREATE، ALTER، DROP، INDEX، SELECT، INSERT، UPDATE، DELETE)، بحال هكا:

CREATE DATABASE horecapos CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'horecapos'@'localhost' IDENTIFIED BY 'wachtwoord';
GRANT ALL PRIVILEGES ON horecapos.* TO 'horecapos'@'localhost';

إلا كان MySQL ولا MariaDB خدام ف أورديناتور آخر، كتب ف جوج السطور اللخرين العنوان IP ديال السيرفور ديال الكاسة ف بلاصة localhost.

التحويل لـ MySQL / MariaDB:

1. تحت العنوان ديال MySQL/MariaDB عمّر الخانات: السيرفور (عادةً localhost)، البور (Port) (عادةً 3306)، قاعدة البيانات (عادةً horecapos)، المستخدم وكلمة السر؛ بحال بحال لـ MariaDB. إلا كان العنوان مريگل من قبل، الخانات كيكونو عامرين؛ إلا خلّيتي كلمة السر خاوية، كتبقى كلمة السر المحفوظة (لنفس المستخدم). الكاسة كتحفظ العنوان بوحدها؛ إلا كانت Optimum POS ديجا ريگلات عنوان ثابت، داك العنوان هو اللي كيخدم وما كايناش الخانات. إلا كانت الكاسة ديجا خدامة ب MySQL/MariaDB، كتبدّل المعلومات من بعد ب بدّل معلومات MySQL/MariaDB. الاتصال المشفّر كتريگلو ليك Optimum POS.
2. ورّك على جرّب الاتصال: كتشوف البرنامج والنسخة، ولا علاش ما خدماتش.
3. ورّك على حوّل لـ MySQL/MariaDB، علّم بلي فهمتي ودخّل الكود السري ديالك.

التحويل كيخدم ف أي اتجاه بين تلاتة ديال قواعد البيانات، وگاع البيانات كيمشيو معاه:

1. الكاسة ما كتقبل حتى طلب شوية ديال الوقت (غالبًا قل من دقيقة)؛ من بعد التابليطات كيكمّلو بوحدهم.
2. الأول، الكاسة كتصاوب نسخة احتياطية ديال الحالة دابا (ف الإعدادات → النسخ الاحتياطية (back-ups)).
3. كلشي كيمشي لقاعدة البيانات الجديدة والكاسة كتحسب ف كل جدول واش كلشي كاين بالضبط.
4. غير ملي كلشي كيتوافق، الكاسة كتكمّل مع قاعدة البيانات الجديدة. الخدامة اللي داخلين كيبقاو داخلين.

إلا شي حاجة ما نجحاتش، والو ما كيتبدّل والكاسة كتكمّل تخدم بقاعدة البيانات القديمة. القاعدة القديمة كتبقى، يعني ديما تقدر ترجع. البيانات ديال الكاسة اللي كانو من قبل ف قاعدة MySQL/MariaDB ولا PostgreSQL الجديدة كيتبدّلو. ف بلجيكا حتى هي ممكنة: العدّادات ديال الصندوق الكحل كيتنقلو بالضبط.

النسخ الاحتياطية والرجوع كيخدمو بحال بحال مع تلاتة ديال قواعد البيانات (الإعدادات → النسخ الاحتياطية (back-ups)). نسخة احتياطية ديال قاعدة وحدة تقدر ترجّعها ف أي قاعدة أخرى، حتى نسخة ديال PostgreSQL ف MySQL ولا MariaDB.

شنو كاين ف MySQL ولا MariaDB؟ كل جدول ديال الكاسة، بنفس السمية ونفس الأعمدة (الوقت ب UTC). كل جدول كتزاد ليه عمود ديال المفتاح _hp_sleutel، وف الجداول ديال المساعدة _horecapos_stand و_horecapos_kolom و_horecapos_reeks و_horecapos_wijziging (سجل ديال التبديلات، كيبقى 14 يوم) الكاسة كتسجّل الحالة، أنواع الأعمدة، العدّادات والتبديلات. البرامج الأخرى كيقراو البيانات؛ غير الكاسات اللي كيكتبو.

كيفاش كتخدم: الكاسة كتحسب ف نسخة خدمة سريعة ف السيرفور ديال الكاسة وكتكتب كل تبديل ف MySQL/MariaDB ف نفس الخطوة. إلا ما نجحش هادشي، التبديل ما كيتدارش والكاسة كتبيّن غلط؛ داكشي علاش خلّي MySQL/MariaDB ديما موصول. ملي كتبدا، الكاسة كتقرا كلشي من MySQL/MariaDB.

بزاف ديال الكاسات ف قاعدة بيانات وحدة. بحال مع PostgreSQL، بزاف ديال الكاسات يقدرو يخدمو بنفس قاعدة البيانات MySQL/MariaDB، بحال كل محل ف سلسلة عندو السيرفور ديال الكاسة ديالو. التبديلات كيتدارو واحد مور واحد وكل كاسة كتاخد الأول شنو دارو الأخرين، داكشي علاش والو ما كيضيع ملي كيتبدّل شي حاجة ف نفس الوقت. إلا شي كاسة رجّعات نسخة احتياطية ولا كاسة بنسخة جديدة دارت تحديث لقاعدة البيانات، الكاسات الأخرين كيعاودو يقراو كلشي بوحدهم؛ داكشي علاش حدّث گاع الكاسات ف نفس الوقت. الكاسة اللي كانت طافية كثر من 14 يوم كتعاود تقرا كلشي ملي كتبدا.

ف التنصيب كتختار حتى قاعدة البيانات: MySQL / MariaDB، مدمجة (منصوح بيها) ولا PostgreSQL مع العنوان. إلا ما تقدرش توصل ليها، الكاسة كتتنصّب بقاعدة البيانات المدمجة؛ من بعد تقدر تحوّل هنا. ف التحديث الاختيار كيبقى.

ربط الطابليطات والشاشات

• حلّ ف كل طابليط/كاسة العنوان ديال السيرفور ديال الكاسة، مثلا http://192.168.1.20:3000، وحطّو كاختصار ف الشاشة الرئيسية (Chrome: زيد للشاشة الرئيسية).
• شاشة الكوزينة: http://192.168.1.20:3000/keuken.
• شاشة الكليان (مقابلة للكليان، اختيارية): http://192.168.1.20:3000/klantscherm، شوف شاشة الكليان.
• الشاشات كيلقاو السيرفور ديال الكاسة بوحدهم (نفس العنوان، البور 4000).

شاشة الكليان

شاشة فالكاسة اللي مقابلة للكليان. الكليان كيشوف تقريباً شنو تكومندا، وكيشوف مزيان المبلغ وكيفاش كيتخلّص. ما فيها حتى تحكم: الشاشة غير كتبّع شنو كتدير الكاسة. فالأصل مطفية؛ شعلها من الإعدادات → المحل → شاشة الكليان. ف بيسي ديال الكاسة فيه جوج شاشات، الكاسة كتشعلها بوحدها أول مرة؛ إلا طفيتيها من بعد، كتبقى مطفية. بلا شاشة الكليان (مطفية، ولا ما كايناش) كلشي كيخدم بحال ديما: الكاسة كتصيفط الصورة من اللور، والسيرفيس عمرو ما كيحس بشي غلط ولا بشاشة ناقصة.

شنو كيشوف الكليان:

• الراحة (حتى واحد ما كيخلّص): السمية ديال المحل وجملة ترحيب ديالك (الإعدادات → المحل؛ خاوية = "Welkom").
• الكوموند: المنتوجات مع العدد والمبلغ (السطور اللي بحال بحال مجموعين، المينيو كسطر واحد والمكونات ديالو صغار تحتو، التخفيض كسطر واحد)، والمجموع كبير. اللي تخلّص ديجا ملي كيتقسم الحساب كيبان تحت. مع الإعدادات → المحل → تصاور المنتوجات → فشاشة الكليان كتبان تصويرة صغيرة حدا كل منتوج.
• خلّص الحساب: طريقة الخلاص (لكارط، كاش، بون كادو)، البوربوار وخاصك تخلّص كبيرة. كاش: شحال عطى الكليان وشحال غادي ياخد الصرف، ملي يتدخّل فالكاسة. لكارط: "تبّع التعليمات اللي فالتيرمينال ديال لكارط".
• شكراً: من بعد ما يتخلّص الحساب كتبان "شكراً!" شي ثواني مع المبلغ اللي تخلّص (كاش: الصرف ديال الكليان)، ومن بعد كترجع شاشة الراحة.

الربط، بجوج طرق (بجوج كيتعدّلو فالجهاز براسو):

• شاشة تانية ف البيسي ديال الكاشة (Windows، Linux/Raspberry Pi، macOS): بوحدها. ملي كتدخل ومن بعد التثبيت، الكاشة كتحل شاشة الكليان كاملة على أصغر شاشة اللي ماشي هي الشاشة الرئيسية (إلا كانو بحال بحال، على اللي ف اليمين بزاف)؛ ف Windows ديما على شاشة أخرى ماشي ديال الكاشة (الكاشة كاينة على شاشة اللمس وكتحل حتى هي بوحدها ملي كيتشعل الجهاز). الحجم والبلاصة كيجيو من السيستيم، يعني أي قياس خدام. بلا شاشة تانية ما كيوقع والو. ف Windows شاشة الكليان إلا تسدات كترجع بوحدها؛ ف Linux و macOS الراكورسي HorecaPOS klantscherm اللي ف المنيو كيرجعها مزيانة. ف Windows كتحل ف مود الكيوسك ديال Chrome (ولا Edge): شاشة كاملة، بلا بارة ديال العنوان وبلا بارة ديال المهام (سدها ب Alt+F4). شاشة الكليان كتبع الكاشة ف نفس البيسي بلا كود ديال الربط.
  • ف كل متصفح، الضغطة الطويلة ما كتطلع قائمة المتصفح حتى فبلاصة، وما كيجي حتى سؤال باش تترجم الصفحة.
  • الكاشة تسدات = شاشة الكليان تسدات. إلا وقف البرنامج ديال الكاشة (إعادة التشغيل، تحديث، الكاشة توقفات ولا تحيدات)، شاشة الكليان حتى هي كتسد من بعد شوية كثر من 10 ثواني؛ ملي الكاشة كترجع تخدم، كترجع بوحدها. ف Windows كتسد حتى إلا سديتي غير الفنيطرة ديال الكاشة. تحت Wayland (Linux) الكاشة ما تقدرش تسد الفنيطرة بوحدها.
  • شاشة الكليان تسدات بالغلط؟ ف Windows كترجع بوحدها من بعد شي ثواني، ما دامت الكاشة محلولة والشاشة الثانية مركبة.
  • ديما غير شاشة كليان وحدة. ف Windows شاشة الكليان كتبان غير ف مود الكيوسك على الشاشة التانية. شي شاشة كليان وسط الفنيطرة ديال الكاشة (مثلا Edge رجعها من بعد ما طفا الضو، ولا تحلات بالبوطونة ف الكاشة) كتسد بوحدها ف شي ثواني؛ ومن بعد شاشة الكليان الصحيحة كتجي ف بلاصتها.
  • حتى واحد ما داخل = غير المرحبا. إلا كانت الكاشة على شاشة الكود السري (حتى من بعد إعادة التشغيل ولا الخروج)، شاشة الكليان كتبين غير النص ديال المرحبا، عمرها ما كتبين الحساب اللي كان قبل.
  • ف Windows تقدر حتى تطفي الفتح الأوتوماتيكي بالكوشة حل شاشة الكليان بوحدها ... ف الإنستالور.
  • ف Linux الكاشة كتحرك الفنيطرة ب wmctrl (كيجي مع الباكيج). تحت Wayland (بحال Raspberry Pi OS مع labwc) هادشي ما كيمشيش: دير شاشة الكليان نتا براسك مرة وحدة على الشاشة التانية (البراوزر كيتفكرها)، ولا ختار X11 ف raspi-config. ف macOS، الـ Mac كيطلب الإذن أول مرة ف إمكانية الوصول.
  • باليد: الإعدادات → المحل → شاشة الكليان → حل شاشة الكليان (الشاشة التانية). ف Chrome و Edge (حتى ف Chromebook) البوطونة كتدي الفنيطرة دغيا لشاشة الكليان (أول مرة البراوزر كيطلب الإذن)؛ كليك وحدة على شاشة الكليان كتخليها كاملة. ف البراوزرات الأخرين: جرها وضغط F11.
• كاشة Android فيها شاشة الكليان مدمجة (بحال Sunmi D2/T2) ولا شاشة ب HDMI/USB-C: حتى هي بوحدها. غير يتحط الأبليكاسيون على الكاشة، شاشة الكليان كتبان ف الشاشة التانية؛ التبريش والتحياد خدامين دغيا.
• Sunmi T1 mini / T2 mini مع الشاشة الصغيرة ديال الكتابة (2 سطورا): الأبليكاسيون كيبين تما المبلغ بوحدو: المجموع، للخلاص، ف الكاش الصرف، من بعد الخلاص شكرا! وملي ما كاين والو سمية المحل. خاص شاشة الكليان تكون شاعلة.
• iPad (شاشة الخدمة) مع شاشة برانية ب HDMI/USB-C ولا AirPlay: الأبليكاسيون كيحط شاشة الكليان بوحدو ف ديك الشاشة (موجد؛ الأبليكاسيون ديال iOS مازال ما خرجش).
• Chromebook: كشاشة الخدمة ف Chrome، البوطونة حل شاشة الكليان (الشاشة التانية) خدامة بحال الفوق. ف الأبليكاسيون ديال Android، شاشة الكليان كتبان بوحدها ف الشاشة التانية غير يعطي ChromeOS ديك الشاشة للأبليكاسيونات ديال Android؛ إلا ما عطاهاش، خدم بجهاز بوحدو مع كود ديال الربط.
• جهاز بوحدو (تابليط ولا بيسي ديالك حدا الكاسة): حلّ http://<kassaserver>:3000/klantscherm. الشاشة كتبيّن لتحت على اليمين كود الربط فيه 6 ديال الحروف. دخّلو فالكاسة فالإعدادات → المحل → شاشة الكليان → ربط. فك الربط كيرجّع الشاشة لكود الربط. الربط كيتسجّل لكل كاسة (فالبراوزر ديال ديك الكاسة)، يعني كل كاسة تقدر يكون عندها شاشة الكليان ديالها.

شاشة الكليان ما كتطلبش كود PIN (ما كاين ما يتحكم فيه) وكتبيّن غير الصورة ديال الكاسة اللي مربوطة معاها. الصورة كاينة غير فالذاكرة ديال السيرفور ديال الكاسة؛ من بعد إعادة التشغيل الشاشة كتبقى خاوية حتى للتبديل الجاي. الإعداد (شاعل/مطفي وجملة الترحيب) كيدخل فالنسخة الاحتياطية (back-up) وفالإدخال/التصدير (إعدادات أخرى).

التيكي الرقمي ب QR (اختياري)

افتراضيا طافي. كيتشعل من الإعدادات → المحل → الكوزينة وشاشة الكليان → التيكي الرقمي (الخيار كيبان ملي تكون شاشة الكليان مسجّلة شاعلة). من بعد الخلاص كيبان كود QR ف شكرا؛ وديك الساعة كتبقى 45 ثانية فبلاصة شي ثواني. الكليان كيسكانيه بالتيليفون ديالو وكيشوف التيكي بحال التيكي ديال الورق بالضبط (نفس النص، وف كاسة بلجيكية حتى مع البلوك ديال FDM). فالتيليفون يقدر يطبع التيكي، يحفظو ك pdf ولا يتيليشارجيه ك فيشي ديال النص.

• هادشي كيدوز من بوابة الإدارة: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. يعني خاص الكاسة تكون مربوطة مع البوابة؛ وإلا ما كيبان حتى كود QR وما كيتبدّل والو.
• الساروت عشوائي وما يمكنش يتخمّن، وكيخدم 30 يوم. من بعد الكاسة كتمسحو بوحدها. البوابة ما كتحفظ والو.
• كيخدم مع شاشة تانية ومع شاشة كليان بوحدها. التيكي ديال الورق والتيكي بالإيميل كيبقاو خدامين عادي.

شاشة الكليان فاش ما كاين حتى خلاص: عرض السلايدات (اختياري)

افتراضيا طافي. كيتشعل من الإعدادات → المحل → الكوزينة وشاشة الكليان → شاشة الكليان فاش ما كاين حتى خلاص. إلا ما كاين حتى حساب ف شاشة الكليان، السلايدات كيتبدّلو وحدة من بعد وحدة (افتراضيا كل 8 ثانية، تقدر تختار من 4 حتى ل 60):

• الحملات: الهابي آورز (إلا كان هابي آور شاعل)، مع التخفيض، الأيام والأوقات والمنتوجات ولا المجموعات؛ اللي خدامين دابا كيجيو هوما اللولين، مع "دابا!".
• منتوجات مبرّزة (ماكسيموم 12، بحال الجديد فالكارطة)، بالثمن و(إلا كانت التصاور ديال المنتوجات شاعلة ف شاشة الكليان) التصويرة. المنتوج اللي سالا كتفوتو الشاشة.
• كارط النقط: النقط على كل أورو، الكادو والكارطات ديال الطوابع (غير إلا كانت كارط الفيدليتي شاعلة).
• نصوص ديالك: ماكسيموم 5، كل واحد ف سلايد بوحدو (مثلا "من الجمعة جديد: المنيو ديال الصيف").

بلا سلايدات، شاشة الكليان كتبيّن شاشة الترحيب بحال ديما.

Happy hour

فالأصل مطفي. شعلو من الإعدادات → المحل → ستعمل happy hour؛ ومن بعد كتبان الخانة الإعدادات → Happy hour.

• لكل happy hour: السمية (كتبان فالتيكي)، الأيام، من–حتى (يمكن يفوت نص الليل، مثلاً 23:00–01:00)، تخفيض ب % ولا ثمن ثابت، ولشمن مجموعات المنتوجات و/ولا شمن منتوجات بوحدهم.
• فداك الوقت الكاسة كتحسب بوحدها ثمن happy hour ملي كتضغط على المنتوج (عمرو ما يكون غلى من العادي؛ مع الثمن الثابت الأوبسيونات كتزاد عادي). فالبوطونة ديال المنتوج كيبان الثمن القديم مشطّب عليه مع الثمن الجديد وHH؛ فالكوموند وفالتيكي كتبان السمية ديال happy hour. اللي تضغط عليه من قبل كيبقى بالثمن ديالو.
• عرض النهار: شعّل النهار كامل (00:00–24:00) واختار النهار (النهارات)، مثلا كل ثلاثاء spareribs بثمن ثابت.
• الموسم: شعّل غير ف موسم (كل عام) واختار من وحتى ل (النهار والشهر، مثلا 1 يونيو حتى 31 غشت؛ يقدر يدوز راس العام، مثلا 1 دجنبر حتى 28 فبراير). برا الموسم الهابي آور ما كيخدمش.
• التبديلات كتسجّل فالسجل.

الفترات ديال النهار والمواسم

فالأصل مطفي. شعلو من الإعدادات → المحل → الفترات ديال النهار وطريقة الطلب → المنتوجات حسب الفترة ديال النهار والموسم؛ ومن بعد كتبان الخانة الإعدادات → الفترات ديال النهار. إلا طفيتيه، كاع المنتوجات كيرجعو كيتباعو ديما والفترات كيبقاو محفوظين.

• لكل فترة: السمية (مثلا الفطور، الغدا، العشا، منيو ديال الصيف)، النهارات، من–حتى (يقدر يدوز نص الليل؛ النهار كامل = 00:00–24:00)، وإلا بغيتي شي موسم (كل عام، النهار والشهر)، وشمن مجموعات و/ولا منتوجات بوحدهم تابعين ليها.
• المنتوجات والمجموعات اللي ف وحدة ولا كثر من الفترات كيتباعو غير ملي تكون وحدة من ديك الفترات خدامة؛ اللي ماكاينش ف حتى فترة كيتباع ديما. الشاشة ديال الطلب كتبين غير اللي كيتباع دابا وكتبدل بوحدها ملي كتبدا ولا كتسالي شي فترة؛ والسيرفور كيرفض الباقي ("ما كيتباعش دابا، غير ف الفطور").
• المتجر ديال الأنترنيت كيبين وكيحسب نفس المنتوجات (ف الوقت ديال الطلب).
• ثمن آخر ف شي نهار ولا ف شي موسم هو هابي آور (عرض النهار، شوف الفوق).
• منيو لكل بلاصة: كل كاسة (فرع) عندها المنتوجات، الفترات والأثمنة ديالها.
• التبديلات كتسجّل فالسجل.

المنتوجات والأثمنة حسب طريقة الطلب

فالأصل مطفي. شعلو من الإعدادات → المحل → الفترات ديال النهار وطريقة الطلب → المنتوجات والأثمنة حسب طريقة الطلب. إلا طفيتيه، كيرجع الثمن العادي ف كل بلاصة وكلشي كيتباع ف كل بلاصة؛ والأثمنة اللي دخلتي كيبقاو محفوظين.

• ف الإعدادات → المنتوجات لكل منتوج: الثمن ديال ياخدها معاه والثمن ديال التوصيل (خاوي = الثمن العادي) وكيتباع ف (فالمحل، ياخدها معاه، التوصيل؛ على الأقل وحدة). ف المجموعة حتى هي كيتباع ف، لكاع المنتوجات اللي فيها.
• الشاشة ديال الطلب ف كوموند ديال ياخدها معاه ولا التوصيل كتبين الثمن ديال ديك الطريقة وغير اللي كيتباع تما؛ والسيرفور كيحسب داك الثمن وكيرفض الباقي. هابي آور، المونيات والاختيارات كيتحسبو بداك الثمن.
• نسبة TVA ديال ياخدها معاه (ف المنتوج) بوحدها، بحال ديما.
• المتجر ديال الأنترنيت كيبين ف ياخدها معاه والتوصيل الأثمنة والمنتوجات ديال داك الاختيار (ملي كتبدل كتعاود تشارجا صفحة المنيو)، وف الطابلة ديال فالمحل.
• التصدير والاستيراد ديال الإعدادات (الإعدادات → استيراد/تصدير) كياخدو معاهم الأثمنة حسب طريقة الطلب، "كيتباع ف"، الفترات ديال النهار والموسم ديال الهابي آور.

المينيوات

فالأصل مطفي. شعلو من الإعدادات → المحل → ستعمل المينيوات.

• المينيو هو منتوج عادي (بثمن المينيو) اللي كتحدد ليه المكونات فـ الإعدادات → المنتوجات → (المنتوج) → المينيو:
  • ثابت: ديما هاد المنتوج (مثلاً "المشروب: شراب الدار")؛
  • على حساب الاختيار: ختار 1 (ولا كثر) من مجموعة ديال المنتوجات، ويمكن تحددها لشي منتوجات معينين (مثلاً "الطبق الرئيسي: ختار 1 من الأطباق الرئيسية").
  • لكل مكوّن الطبق (1 = ديريكت، 2/3 = كيتسنّى حتى ينادى عليه).
• ملي كتضغط على المينيو، كتختار الماكلة لكل مكوّن. لكل طبق (حتى الثابتين) تقدر تختار الأوبسيونات بحال المنتوج بوحدو (طريقة الطياب، فرماج زايد؛ الأوبسيونات الضرورية خاصهم يتختارو) وملاحظة. الزيادة ديال الأوبسيونات كتزاد على ثمن المينيو. المينيو كيبان كسطر واحد والماكلة (مع الأوبسيونات ديالها) تحتو.
• الماكلة كتمشي للكوزينة/البار كسطور بوحدهم (تيكي ديال الكوزينة وشاشة الكوزينة)، فالطبق ديالها. السطر ديال المينيو براسو لا.
• ثمن المينيو كيتقسم على المكونات ديال TVA على حساب الثمن العادي ديال كل واحد، باش الماكلة والمشروبات كل واحد ياخد النسبة الصحيحة ديالو. فالتيكي كيبان المينيو مع الثمن الكامل والماكلة تحتو.
• إلا كان المينيو براسو فيه أوبسيونات (مثلاً الحجم)، كتختارهم الفوق فالنافذة ديال المينيو. كيبانو مع السطر ديال المينيو فالتيكي، ومع كل طبق من المينيو فتيكي ديال الكوزينة وشاشة الكوزينة ب "(menu)".
• المسح/الستورنو كيكون على المينيو كامل (ضغط على السطر ديال المينيو).
• قسم / نقل: ختار السطر ديال المينيو؛ الماكلة كتمشي معاه. إلا كان 2× نفس المينيو تقدر تنقل حتى 1 (الراس والماكلة كيتقسمو).
• بلا كونيكسيون تقدر تضغط على المينيوات عادي؛ كيتسجّلو فالتابليط وكيتصيفطو ملي يرجع الكونيكسيون (بحال المنتوجات بوحدهم).
• Happy hour يقدر يتطبّق حتى على المينيو.

الوصفات والتكلفة (Apicbase)

الربط مع Apicbase (الوصفات، التكلفة، السطوك والشرا) عبر Generic POS API ديال Apicbase (عادةً مطفي، كل جزء كيتشعل ولا كيتطفا بوحدو). كيتريّح ف الإعدادات → الوصفات (الحق ترياح المحل، الخلاص والطابعات). الكاسة كتهضر بوحدها مع Apicbase (غير الترافيك اللي خارج، ماخاصش البورطاي).

1. الاتّصال (كلشي كيعمّرو المسؤول)، بوحدة من تلاتة ديال الطرق:
   • لصق token: ف Apicbase Library Settings → API Settings → New token → Service Account Token (scopes accounts و library و sales)؛ لصق access token و refresh token؛
   • دخل ب API-app ديال المحل براسو (client-id والسر من API Settings): دخل ل Apicbase، ولصق الكود اللي كيبيّن Apicbase من بعد؛
   • token اللي سالا (من بعد 7 يوم) كتجدّدو الكاسة بوحدها ب refresh token.
2. Outlet: جيب الـ outlets وختار الـ outlet ديال هاد المحل. الكاسة كتحط تما الـ POS على Generic POS API مع location-id ديالها (تقدر تعمّرو؛ من الأول HORECAPOS-…، فريد لكل كاسة).
3. شاعل، بالعلامات:
   • المنتوجات، المجموعات والاختيارات ل Apicbase: المجموعات ديال المنتوجات، المنتوجات (PLU = النمرة PLU ديال المنتوج، ولا الكود، ولا id)، الاختيارات بحال modifiers، مع الثمن و TVA. بوحدها من بعد كل تبديل (من بعد دقيقة) وكل نهار. من بعد ف Apicbase كتربط كل منتوج ديال الكاسة بوصفة؛
   • كل تيكي تخلّص ل Apicbase: القدام هوما الأولين، ماكثر من 100 ف كل مرة، ف ربع ساعة من بعد الخلاص (وكل 5 دقايق). الريميز كيتقسم على السطورا؛ المبالغ الحلّة، الخلاص ديال الباكيج اللي كيتلاح والضمانة كيبانو بحال منتوجات بوحدهم ف Apicbase؛ المنتوجات اللي كتوزن بحال 1 حبة بالمبلغ الكامل. إلا ما نجحش، الكاسة كتوقف (Apicbase باغي التيكيات بالترتيب) وكتعاود من بعد: الخلاص ما كيتأثرش. ملي كتشعّل كتختار من أنهي نهار (من الأول من دابا)؛
   • رجّع التكلفة ديال كل حصة (كل 6 سوايع): لكل وصفة مربوطة food cost (المكونات والضياع)، مع التكاليف ديال الخدّامة، ثمن البيع والهامش حسب Apicbase. كتتحسب بأرخص مورّد، آخر ثمن تكوموندا ولا المعدّل ديال القيمة ديال السطوك؛
   • خود ثمن البيع من Apicbase (من الأول مطفي): كيحط ثمن البيع ديال المنتوجات المربوطة ف الكاسة (كيتكتب ف السجل).
4. لتحت: التكلفة ديال كل منتوج مع التكلفة، التكلفة مع الخدّامة، الثمن ف الكاسة، التكلفة % والهامش. البوطونات صيفط الكاطالوگ دابا، صيفط التيكيات دابا و جيب التكاليف دابا.

الكود: apps/pos-server/src/lib/apicbase.ts، routes/apicbase.ts؛ الشاشة Apicbase.tsx. السجل: Apicbase. الشرط: الموديل API ديال Apicbase. باش يكون التطبيق ديال Pin Voordeel لجميع الكليان: شراكة وسيرتيفيكاسيون عند Apicbase (شوف الـ backlog). الدوكيمونطاسيون: https://developers.apicbase.com/docs/generic-pos-api-guide

برنامج الأوطيل: حط على البيت

لريسطو ولا بار فأوطيل: حط الحساب على البيت ديال ضيف. من الأول مطفي: الإعدادات → الأوطيل (الحق ضبط المحل، الخلاص والطابعات).

• ليستة وحدة فيها كاع البرامج ديال الأوطيلات (البرنامج ديال الأوطيل اللي خدام بيه الأوطيل). الربطات المدمجة:
  • Mews (Connector API: client token و access token، السيرفيس ديال الريسطو ولكل نسبة ديال TVA الكود ديال TVA ف Mews)، apaleo (أبليكاسيون خاصة ب client-id و client secret، و property-id؛ ولكل نسبة ديال TVA النوع ديال TVA إلا خصّ) و Cloudbeds (مفتاح API و property-id)، كل واحد فيهم عندو بيئة ديال التجريب وبيئة حقيقية؛
  • Oracle OPERA Cloud (OHIP)، protel (protel I/O)، RoomRaccoon، Booking Experts، Amadeus (XMLPOS)، VIPS، Stayntouch، Clock PMS+، Guestline (Rezlynx)، Hotelogix، eviivo، Little Hotelier، Shiji و Infor HMS (Databridge). من بعد ما تختار، كيبانو بالضبط الخانات ديال داك البرنامج ديال الأوطيل (المفاتيح، hotel-id، إلا خصّ العنوان ديال API ديالهم ولكل نسبة ديال TVA الكود ديالهم)، مع شرح قصير على شنو خاصك تطلب من المورّد. هاد الربطات تبناو على حساب الوثائق ديال المورّدين؛ خلّي المورّد يأكّد الربط وجرّب الأول ب جرّب الاتصال وتيكي واحد؛
  • ديمو (ربعة ديال السويتات، الغرفة من 4 حتى ل 7) باش تجرّب؛
  • Sirvoy، كربط ناقص وغير مع Sirvoy Pro. Sirvoy ما عندوش API باش الكاسة تزيد شي حاجة فالريزيرفاسيون، حتى بفيشي (الإمبورت ديال CSV كيدير غير ريزيرفاسيونات جداد). بهادشي الكاسة كتعرف الضيوف (البيت، السمية، الوصول، الخروج): التقليب ف على البيت، والخدمة الذاتية فالكيوسك وفالمتجر ديال الأنترنيت خدامين عادي. التيكي ما كيدخلش بوحدو ل Sirvoy: من بعد الخلاص كيبان ف الإعدادات → الأوطيل تحت مازال خاصو يتحط ف Sirvoy، مع البيت، الضيف، النمرة ديال التيكي والمبلغ لكل نسبة ديال TVA. الأوطيل كيحطو بيدّو ك إكسترا فالريزيرفاسيون وكيكليكي على راه تحط (الرجوع ب مازال لا). خاص:
    1. المزيان كاسة مربوطة مع بوابة الإدارة: داك الساع العنوان كيدوز من البوابة (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) وما خاصكش تحل شي port فالأوطيل. وإلا، الكاسة براسها خاصها توصل ليها من الأنترنيت ب https (دومين ديالك مع سرتيفيكا ولا port forwarding؛ Sirvoy بغا TLS 1.2 ولا كثر) ودخل داك العنوان؛
    2. العنوان كيبان غير مرة وحدة؛ الكاسة كتخبي غير الـhash. دير عنوان جديد = القديم ما بقاش خدام؛

Sirvoy ما كيصيفط والو غير إلا تبدّل شي ريزيرفاسيون: الريزيرفاسيونات ديال قبل الربط الكاسة ما كتعرفهومش غير من بعد شي تبديل ف Sirvoy. الميساجات يمكن يجيو مخلّطين؛ ميساج أقدم (generatedAt) من داكشي اللي عند الكاسة كيتخطّى. فالأوطيل = ما تلغاش وما خرجش، دخل ولا الوصول اليوم ولا قبل، والخروج اليوم ولا من بعد. جرّب الاتصال كيقول شحال من ريزيرفاسيون دخلات.

كاع البرامج ديال الأوطيلات كيتباعو فهولندا و/ولا بلجيكا. جرّب الاتصال كيتأكد من المعلومات. الكود لكل ربط: apps/pos-server/src/lib/pms/<naam>.ts.

• الخدمة الذاتية (مطفية من الأول): الضيف ديال الأوطيل كيحط الكوموند ديالو براسو على الغرفة ديالو، فالكيوسك و/ولا فالمتجر ديال الأنترنيت (الديباش والتوصيل، ماشي ملي كيطلب فالطابلة). كيكتب النمرة ديال الغرفة والكنية ديالو؛ والكاسة كتشوف عند البرنامج ديال الأوطيل واش هاد الضيف ساكن دابا فهاد الغرفة. مع حد أقصى لكل كوموند (من الأول € 150)، ومن بعد 5 محاولات غالطين فربع ساعة خاصو يمشي الأول للريسيبسيون. الميساج عمّرو ما كيقول شكون ساكن فشي غرفة.
• خلّص الحساب: إلا كان الربط شاعل، كاينة طريقة الخلاص على البيت. قلّب على الضيف بالسمية ولا النمرة ديال البيت (غير الضيوف اللي ساكنين دابا فالأوطيل) وكليكي على حط على البيت .... الكاسة كتسجّل التيكي لكل نسبة ديال TVA فالحساب ديال الضيف فالأوطيل؛ الضيف كيخلّص ملّي كيخرج.
• بلجيكا: إلا كان الطلب ديجا على الطابلة عند الصندوق الكحل، كيدوز الأول من الطابلة للبيت (signCostCenterChange ل ROOM، UC4101)؛ التيكي كيمشي ككريدي ديال البيت (ROOM_CREDIT) للصندوق الكحل.
• إلا التسجيل فبرنامج الأوطيل ما نجحش (ما كاينش الأنترنيت)، البيعة كاينة والتسجيل كيبان ك ما نجحش ف الإعدادات → الأوطيل، مع عاوتاني.
• الرابورات والحسابات: على البيت (الأوطيل) طريقة خلاص بوحدها فالرابور X و Z، فالكشف ديال النهار وفملف الأوديت (XAA).

الكود: apps/pos-server/src/lib/hotel.ts، routes/hotel.ts، الربطات ف lib/pms/، الكاطالوك packages/shared/src/hotelcatalogus.ts؛ الشاشة Hotel.tsx. السجل: الأوطيل. الأسرار (tokens) كاينين غير فالداتاباز، عمرهم ما كيبانو فالشاشة.

تسيير الشراب مع Vinify

الإعدادات → تسيير الشراب (عادةً مطفي؛ ملي كتطفيه كلشي كيبقى محفوظ). Vinify كيتبّع الكاڤ ديال الشراب، الكارطة ديال الشراب والسطوك، وهو المصدر الرئيسي ديال الشراب. على حساب الشروط ديال POS عند Vinify، الكاسة كتعطي API اللي بيه Vinify كيقدر:

يدخل، بالتلاتة ديال الطرق اللي كيعرف Vinify (المسؤول كيشعّل اللي بغا):

1. API-id ومفتاح API (X-Api-Id و X-Api-Key، ولا Authorization: Bearer <id>:<sleutel>)؛
2. مفتاح API و API-secret مع توقيع: X-Api-Key، X-Timestamp و X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>)، ماشي قدم من 5 دقايق.

المفتاح والـ secret كتصاوبهم الكاسة (كيبانو مرة وحدة)؛ الشاشات كيشوفو غير واش معمّرين. كتوصل ليها من البورطاي على https://<portaal>/vinify/<kassa-id>/... (حتى بور ما خاصو يتحل فالمحل؛ العنوان كاين فالإعدادات → تسيير الشراب). شمن منتوجات هي شراب: اللي كيصاوب Vinify، زايد المجموعات اللي كتعلّم. إلا عطى Vinify عنوان باش تصيفط ليه البيعات، الكاسة كتصيفطهم بوحدها حتى هي (push، مع token): من بعد كل تيكي تخلّص وكل 5 دقايق اللي مازال ما دازش. Vinify كيشعّل الربط مع HorecaPOS (hello@vinify.no). كلشي فالسجل. ما تخلطوش مع Vinify.nl، حانوت ديال الشراب أونلاين: كاين فالمورّدين (الطلب من المورّدين).

دخّل العنوان بالزربة بالكود البريدي ونمرة الدار

كتشعلو من الإعدادات ← المحل ← دخّل العنوان بالزربة (عادةً مطفي؛ غير لمحل ف هولندا). كتب الكود البريدي ونمرة الدار (حتى بحرف ولا زيادة، بحال 12A ولا 12-1) وضغط على قلّب على العنوان: الزنقة، نمرة الدار، الكود البريدي والمدينة كيتعمّرو. إيلا كانو فهاد النمرة بزاف ديال العناوين (12، 12A، 12B)، كتختار الصحيح. من بعد تقدر تبدّل كلشي بيدك.

• فـ المعلومات ديال المحل (الإعدادات ← المحل، فوق العنوان).
• عند كليان ديال كارط الفيدليتي: فالكاسة ملي كيتزاد كليان جديد وفالرابور ← الكليان. الكليان كيتزاد ليهم عنوان (اختياري): الزنقة ونمرة الدار، الكود البريدي والمدينة.
• العناوين كيجيو من Locatieserver ديال PDOK الفابور (العناوين الرسمية ديال هولندا، BAG): ما خاصك لا كونط لا ساروت، ولكن خاص الأنترنيت. بلا أنترنيت ولا لعنوان ف بلجيكا كتكتب العنوان بيدك.

تنبيه ملي تخرج نسخة جديدة

شعلو فـ الإعدادات → المحل → تنبيه النسخة الجديدة (عادةً مطفي).

• الكاسة تحدّثات: إلا تحدّث السيرفور ديال الكاسة وشي تابليط باقي حالّ الشاشات القدام، كتبان الفوق "الكاسة تحدّثات (النسخة …)" مع جدّد. التابليط كتشوف كل 5 دقايق، ملي الشاشة كترجع تبان ومن بعد إعادة التشغيل ديال السيرفور.
• كاينة نسخة جديدة: إلا كانت الكاسة مربوطة مع البورطاي ديال التسيير (PORTAAL_URL/PORTAAL_SLEUTEL) وNIEUWSTE_VERSIE معمّرة تما، اللي عندو الحق يسيّر الإعدادات كيشوف "كاينة نسخة جديدة: النسخة …" (مع الشرح من UPDATE_NOTITIE). من بعد كيخبّي التنبيه فداك التابليط حتى تخرج نسخة جديدة أخرى. التحديث كيكون بحال ديما ب scripts\windows\update.cmd (شوف التحديث).

منصات الحجز

الحجوزات ديال TheFork و Formitable و Zenchef و Resengo (غير فبلجيكا) و OpenTable (غير فهولندا) و PlanPanther و RestoManager و Aqqo (غير فهولندا) كيوصلو بوحدهم للكاسة وللبلان ديال الصالة. شعلها من الإعدادات → منصات الحجز (مطفية من الأول). كيخدم غير إلا كانو الحجوزات مشعلين.

• البلاد ديال المحل: تقدر تختار غير المنصات اللي خدامين فالبلاد ديال المحل (Resengo غير فبلجيكا، OpenTable و Aqqo غير فهولندا). السيرفور حتى هو كيتأكد من هادشي.
• بزاف ديال المنصات فمرة وحدة: تقدر تربط بزاف ديال المنصات جنب بعضياتهم، بحال TheFork وFormitable. جوج منصات عمرهم ما ياخدو نفس الطابلة فنفس الوقت؛ ديك الساعة الحجز التاني كيدخل بلا طابلة.
• + ربط منصة: ختار المنصة وعمّر المعلومات. الأسرار (client secret، الساروت ديال الرجوع) عمرهم ما كيبانو فالملخص؛ خليه خاوي = كيبقى، مسح = كيتحيد.
• TheFork (API عمومية B2B): Restaurant UUID و Client ID و Client Secret (كتطلبهم من TheFork). إلا لغات الكاسة، كتلغي حتى ف TheFork.
• Formitable و Zenchef و Resengo و OpenTable و PlanPanther و RestoManager و Aqqo: الـAPI ديالهم غير للشركاء ولا ماشي عمومية (PlanPanther و RestoManager و Aqqo: الربط مع الكاسة كيتدار بالتفاهم معاهم). الأحداث ديال Formitable (booking.created، .changed، .canceled، .checkin، .checkout) كيتعرفو عليهم.
• فالبلان ديال الصالة: إلا كانت طابلة فالكاسة عندها نفس السمية ديال الطابلة فالمنصة وخاوية فداك الوقت، الحجز كيتحط عليها؛ وإلا كيبقى بلا طابلة (ختارها ملي يوصلو). الحجز اللي كيرجع يدخل كيتحدث، ما كيتعاودش. فالملخص كيبان "عبر TheFork".
• الحالة: إلا المنصة لغات ولا علمات ب no-show، الكاسة كتاخدها. اللي وصل فالكاسة كيبقى واصل.
• رجوع الخبار (no-show كيرجعو): دخل عنوان الرجوع (مثلا ديال خدمة الربط ديالك). الكاسة كتصيفط كل تبديل من الكاسة (وصل، no-show، تلغى، تخلص مع المبلغ) ب JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (المبلغ بالسنتيم، غير ملي يتخلص)، مع Authorization: Bearer <terugmeld-sleutel> إلا دخلتيه. إلا ما نجحش، الكاسة كتعاود كل دقيقة والغلط كيبان عند المنصة. اللي جا من المنصة براسها ما كيترجعش.
• حجز تجريبي: كيدير حجز بحال اللي غادي تصيفطو المنصة.
• نحيد: الربط والساروت كيتحيدو؛ الحجوزات كيبقاو.
• كاع التبديلات مسجلين فالسجل (بلا أسرار).

برامج الفيدليتي والتقييمات

جوج ديال البوطونات بوحدهم ف الإعدادات ← الپوانات والتقييمات (بجوج عادةً مطفيين، وعاد ما كيبان منهم والو فتا بلاصة). إلا طفيتيهم، الإعدادات واللي وقع من قبل كيبقاو محفوظين.

برنامج فيدليتي ديال پلاتفورم أخرى: الضيف كيجمع الپوانات ف Joyn (بلجيكا) و/ولا Piggy (Leat؛ هولندا وبلجيكا). هادشي بوحدو على كارط الفيدليتي ديال الكاسة؛ يقدرو يكونو بجوج مشعولين.

• بزاف ف نفس الوقت: ف بلجيكا Piggy وJoyn يقدرو يكونو شاعلين بجوج، كل واحد بالمعلومات ديالو (ختار الپلاتفورم، عمّر، سجّل؛ بدّل ومسح لكل پلاتفورم). الكليان كياخد لكل برنامج QR code بوحدو على التيكي، ليان بوحدو ف التيكي اللي تصيفط بالإيميل وبوطونة بوحدها ف المتجر ديال الأنترنيت، وكيجمع ف كل برنامج مرة وحدة ف كل كوموند. داكشي اللي كان ديجا مسجّل كيبقى خدّام عادي.
• كود QR ف التيكي: من بعد الخلاص كيبان تحت التيكي كود QR مع "سكاني وجمع الپوانات ف ...". ف التيكي ديال الإيميل كاين ليان، وف المتجر ديال الأنترنيت (ياخدها معاه والتوصيل) بوطونة ف الصفحة ديال الكوموند وليان ف إيميل التأكيد. الكوموند الوحدة كتعطي الپوانات غير مرة وحدة: التيكي والإيميل والمتجر كيستعملو نفس الكود الوحيد (النمرة ديال الكوموند). "كود QR ف التيكي المطبوع" تقدر تطفيه؛ الإيميل والمتجر كيبقاو فيهم الليان.
• Piggy، الطريقة "كود QR وليان": عمّر العنوان ديال البوابة ديال الكليان ديال Piggy، وShop UUID وAccount secret (Piggy Business Dashboard). خدامة بلا أنترنيت: الكاسة كتصاوب الليان بوحدها.
• Piggy، الطريقة "زيد ديريكت": عمّر حتى personal access token (Piggy ← Marketplace ← Private App). إلا صيفطات الكاسة التيكي بالإيميل وكان الضيف ب داك الإيميل عضو من قبل، الكاسة كتزيد الپوانات ديريكت؛ وف التيكي كيبان "تزادو الپوانات ف Piggy". الكاسة عمرها ما كتصاوب عضو جديد؛ ماشي عضو (ولا ما عندوش إيميل) = كود QR.
• Joyn، الطريقة "كود QR وليان": بـ partner key وshop reference وshared secret ديال Joyn (طلبهم من api-integration@joyn.be). خدامة بلا أنترنيت. كود QR صالح 2 ساعة.
• Joyn، الطريقة "عن طريق API": بـ shop API key (شعل الربط ف البوابة ديال التجار ديال Joyn). ملي كتخلّص، الكاسة كتطلب من Joyn كود ديال الپوانات. تبديل الپوانات كيبقى بحال ديما ف Joyn-iPad.
• صايب ليان ديال التجربة: كيشوف واش المعلومات صحاح (ليان ديال € 10؛ حلّو غير باش تشوف).
• غير الپلاتفورمات ديال البلاد ديال المحل اللي تقدر تختار؛ الأسرار كيبقاو غير ف قاعدة البيانات وعمرهم ما كيبانو ف الشاشة (خليه خاوي = يبقى كيف ما كان).

طلب التقييمات: من بعد الزيارة إيميل واحد فيه بوطونة لـ Google و/ولا Trustpilot.

• شي ساعات من بعد (تقدر تبدلها، عادةً 3) الضيف كيوصلو الإيميل، باللغة ديال التيكي.
• المتجر ديال الأنترنيت: ف ياخدها معاه والتوصيل، المتجر هو اللي كيصيفط الإيميل، شي ساعات من بعد ما تسالات الكوموند ف الكاسة، باللغة ديال الضيف.
• Google: لصق ليان التقييم من البروفيل ديال البيزنس ديالك (Google ← البروفيل ديال البيزنس ديالك ← طلب التقييمات، https://g.page/r/.../review) ولا عمّر Place ID.
• Trustpilot: عمّر الدومين ديال المحل ديالك (البوطونة كتمشي لـ trustpilot.com/evaluate/<domein>). إلا عندك ف Trustpilot عنوان الدعوة (Automatic Feedback Service، ...@invite.trustpilot.com)، عمّرو حتى هو: الإيميل كيمشي لـ Trustpilot ف BCC، فيه السمية والإيميل والنمرة ديال التيكي مخبيين، وTrustpilot هي اللي كتصيفط الدعوة (وما كاينش بوطونة ديال Trustpilot بوحدها). غير Trustpilot مع عنوان الدعوة: الكاسة كتصيفط الإيميل غير لـ Trustpilot.
• ماشي بزاف: نفس الضيف (الإيميل) كيوصلو طلب واحد على الأكثر ف كل مدة (عادةً 90 يوم؛ 0 = كل مرة). لهادشي الكاسة كتحتافظ غير بـ hash ديال العنوان؛ الإيميل براسو كيتمسح غير كيتصيفط الميساج (إلا ما تصيفطش، من بعد تلت محاولات، وإلا من بعد 14 يوم).
• كود QR ف التيكي (اختياري): حتى كود QR ديال التقييم تحت التيكي المطبوع.
• شوف الإيميل كيفاش غادي يبان ومسح الإيميلات اللي كيتسناو (العناوين كيتمسحو ديريكت). السجل كيبيّن review_gevraagd مع a***@domein.nl.
• Google وTrustpilot كيمنعو تعطي شي حاجة مقابل التقييم وتطلب غير من الضياف اللي فرحانين ("review gating"). داكشي علاش الكاسة كتطلب من كلشي بحال بحال وما كتعطي والو مقابل التقييم.
• قرا التقييمات وجاوب عليهم فـ الكاسة: شوف تسيير التقييمات لتحت.

الربط مع Mailchimp و Klaviyo

الكليان ديال كارط الفيدليتي ف البرنامج ديال الإيميل ديالك: ف الإعدادات ← المحل ← Mailchimp و Klaviyo (تحت الماركوتينغ ب SMS والإيميل). ما كاينش بوطون تشعيل: بلا ربط مع ليستة مختارة ما كيوقع والو.

• الربط: ب مفتاح API (Mailchimp: البروفيل ← Extras ← API keys؛ Klaviyo: مفتاح خاص pk_… فيه الحق ديال الكتابة ل Lists وProfiles وSubscriptions وEvents وCampaigns وTemplates). السر ديال الكليان والمفتاح عمرهم ما كيبانو عاوتاني فالشاشة (خليه خاوي = يبقى). من بعد كتختار الليستة (Mailchimp: audience).
• الكليان: اللي وافق على الإيميل كيمشي لليستة (مشترك)، مع السمية، الكنية، التيليفون، عيد الميلاد والنقط (Mailchimp: الخانة PUNTEN، كتصاوبها الكاسة براسها؛ Klaviyo: الخاصية punten). الموافقة تحيّدات، الإيميل تبدّل ولا الكليان تمسح: كيتحيّد الاشتراك. غير اللي تبدّل كيتصيفط عاوتاني. مع الربط الكاسة (والعلامة "العروض" ف المتجر ديال الأنترنيت) كتطلب حتى هي من كل كليان جديد الموافقة على الإيميل، وتقدر تبدّلها ف الرابور ← الكليان، حتى بلا الماركوتينغ بالإيميل ديال الكاسة.
• حيدان الاشتراك: اللي حيّد الاشتراك ديالو ف Mailchimp ولا Klaviyo، حتى ف الكاسة ما بقاتش عندو الموافقة على الإيميل (السجل: "حيّد الاشتراك ف Mailchimp"). واللي حيّد راسو بيدّو، الكاسة ما كتعاودش تشركو.
• الكوموندات: كل تيكي مخلّص ديال كليان ف الليستة كيمشي كحدث (Mailchimp: bestelling، مع المبلغ، نمرة التيكي والعدد؛ Klaviyo: Placed Order، مع القيمة باليورو). بهادشي كتصاوب ف البرنامج ديال الإيميل إيميلات أوتوماتيكية، مثلا من بعد أول كوموند ولا إلا شي واحد ما جاش شهر. التيكيات اللي قبل ما تختار الليستة ما كيمشيوش.
• الحملات: ف الرابور ← الماركوتينغ تقدر تصيفط حملة حتى عبر Mailchimp ولا Klaviyo (شوف الماركوتينغ ب SMS والإيميل)؛ عاد الكاسة كتصاوب الحملة تمّا وكتصيفطها.
• التحديث: كل 5 دقيقة، ولا ب حدّث دابا. فكّ الربط: كيتحيّد من الكاسة؛ ف Mailchimp و Klaviyo كلشي كيبقى. المفاتيح كاينين ف قاعدة البيانات (ف الباك أب، ماشي ف التصدير ديال الإعدادات).

الكود: lib/mailinglijst.ts و routes/mailinglijst.ts و MailingKoppelingen.tsx.

BI وتصدير المعطيات

معطيات البيع ل Power BI، Looker Studio، Excel، Google Sheets، Tableau، Qlik Sense، Metabase، خدمة BI (مثلا YourBI، BI4Horeca ولا Moore DRV) ولا مخزن معطيات ديالك. كتشعلو من الإعدادات ← BI وتصدير المعطيات (عادةً مطفي). غير القراية: بالربط ما يمكن يتبدل حتى حاجة فالكيسة. حتى معطيات ديال الكليان ما كايناش.

• المعطيات: التيكيات (حتى تيكيات الرجوع)، المنتوجات اللي تباعو (سطور التيكي)، الخلصات، الروسيت كل نهار، الروسيت كل ساعة، الإلغاءات، المنتوجات، الخدامة (بلا PIN) وساعات الخدمة. المبالغ بالأورو مع نقطة كفاصلة عشرية، والأوقات بالوقت ديال المحل.
• + ربط: ختار البرنامج والطريقة. كل برنامج كيقبل طريقة وحدة ولا كثر؛ تقدر يكونو عندك بزاف ديال الربطات فنفس الوقت (حتى لنفس البرنامج).
• البرنامج كيجيب بوحدو (API): الكيسة كتعطي مرة وحدة ساروت القراية. المدة ب ?van=&tot= (YYYY-MM-DD) ولا عنوان ثابت ب ?periode= (اليوم، البارح، 7d، 30d، 90d، 365d، سيمانة، شهر، الشهر اللي فات، عام)؛ ماشي كثر من 366 يوم، وماشي كثر من 200.000 سطر. الساروت ف Authorization: Bearer، X-Sleutel ولا ?sleutel=.
• عن طريق البوابة: إلا كانت الكيسة مربوطة مع بوابة الكليان، نفس العنوان كيخدم حتى من برا المحل، بلا ما تحل بور: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... هكا خدمة Power BI كتحدّثو حسب البرمجة (بلا gateway) وGoogle Sheets يقدر يجيبو ب =IMPORTDATA("...") (وهو حتى المصدر ديال Looker Studio). الكيسة كتبين العنوان عند الربط.
• نظرة شاملة على السلسلة من بورطاي الكليان (بزاف ديال المحلات): عنوان واحد ومفتاح واحد لكاع الكاسات ديالك مجموعين. فكل كاسة خاصها تشارك، شعل نظرة شاملة على السلسلة من بورطاي الكليان (تحت الزر ديال BI) ودير مفتاح فبورطاي الكليان ف الكاسات ديالي → BI لكاع المحلات ديالك. من بعد: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... البورطاي كيجيب المعطيات من كل كاسة وكيجمعهم، وفكل سطر kassaId و zaak. الكاسات اللي طافيين ولا ما مشاركينش كيبانو ف ontbrekend (JSON) وفالراس X-Ontbrekend. الكاسة براسها ما محتاجاش مفتاح ديالها لهادشي؛ إلا طفيتيه فالكاسة ولا فبورطاي الكليان كيتوقف.
• إلا كان Token كيمشي ك Authorization: Bearer وكاين توقيع ف X-HorecaPOS-Handtekening (sha256= HMAC ديال المحتوى). إلا ما نجحش، الكيسة كتعاود كل دقيقة؛ والو ما كيتصيفط جوج مرات. ب من كتصيفط حتى التيكيات القدام.
• الكيسة كتعطي فيشيات: كل نهار (فوقت محدد، النهار اللي قبل؛ الأيام اللي فاتو كيتعاودو) ولا كل ساعة (اليوم حتى لدابا)، ك CSV (فاصلة، ولا فاصلة منقوطة ل Excel الهولندي) ولا JSON، ل دوسي فالبيسي ديال الكيسة (مثلا دوسي ديال OneDrive ولا SharePoint ل Power BI ولا Excel)، سيرفور FTP(S) ولا SFTP ولا ب الإيميل. سميات الفيشيات: horecapos_<gegevens>_<datum>.csv.
• صيفط تجربة (push) وصدّر دابا (فيشي) عند الربط.
• تيليشارجي بوحدك: ختار المعطيات، المدة والفورما.
• قالب Power BI (.pbit): تقرير واجد لـ Power BI Desktop، بـ تيليشارجي قالب Power BI ف BI وتصدير المعطيات. دير الأول ربط API ‏(Power BI). ف الموديل: جدول لكل مجموعة معطيات بالأنواع الصحيحة، كاليندري (العام، الشهر، السيمانة، نهار السيمانة)، علاقات (التاريخ → الكاليندري، سطورة البون → المنتوجات، ساعات الخدمة → الخدّامة) ومقاييس (المبيعات مع وبلا TVA، TVA، البقشيش، البونات، الضياف، المعدل ف كل بون وكل ضيف، الكمية المبيوعة، مبيعات المنتوجات، المخلّص، الستورنوات، ساعات الخدمة، المبيعات ف كل ساعة خدمة). تلت صفحات: نظرة عامة (الأرقام الأساسية، المبيعات حسب النهار، نهار السيمانة والساعة، طرق الخلاص)، المنتوجات (حسب المجموعة وحسب المنتوج) والخدّامة (الساعات والمبيعات ديال كل خدّام). عبر البوابة خدمة Power BI كتحدّث حتى هي حسب البرنامج.
• الأسرار (Token، كلمة السر، الساروت) عمرهم ما كيبانو فالملخص؛ خليه خاوي = يبقى، مسح = يتحيد. كلشي مسجل فالسجل (بلا الأسرار).

الخلصة والتخطيط

مع الپوانطاج (دخول وخروج) مشعول (الإعدادات → المحل) كتلقى ف الإعدادات → أوقات الخدمة لتحت الخلصة والتخطيط (الحق تسيير الإعدادات)، فجوج بلوكات بوحدهم. إلا كان الپوانطاج طافي، ما كايناش ساعات: فهاد الحالة كاين غير البلوك ديال التخطيط ديال الخدّامة (المداخيل، مباشر ولا كملف ديال المداخيل) لتحت ف الإعدادات → المحاسبة، تحت العنوان المداخيل للتخطيط ديالك:

• الخلصة (payroll): ختار برنامج الخلصة ولا (بلجيكا) السكريتارية الاجتماعية، عمّر الخانات ديالو، ولكل خدّام الرقم ديالو فداك البرنامج. من بعد كتصاوب لمدة معيّنة الملف فيه الساعات اللي تخدمات (النوبات المسدودة، لكل خدّام ولكل نهار ديال الدخول) والمداخيل على حساب كل خدّام (بلا TVA، اللي خلّص عليه هو/هي): واجد ل Loket.nl (Variabele gegevens، المجموع لكل خدّام فالمدة، السطر ديال العنوان aanslnr;persnr;ploeg;<looncomponent>) وSD Worx بلجيكا (Tijdsregistratie، مواضع ثابتة، لكل خدّام ونهار)، وإلا لائحة الساعات (CSV: التاريخ؛ رقم الخدّام؛ السمية؛ الساعات؛ المداخيل بلا TVA). الخدّامة اللي ما عندهمش رقم ما كيدخلوش فالملف ديال Loket ولا SD Worx؛ الكاسة كتقول ليك شكون هوما.
• التخطيط ديال الخدّامة (WFM): ختار نظام التخطيط. إلا عاودتي صيفطتي كيتبدّل اللي قبل. وزيد على هادشي لائحة المداخيل (CSV على حساب النهار والساعة، بلا TVA وب TVA) ول Strobbo ملف Excel ل Importeer omzet.
• غير البرامج اللي خدامين ف البلاد ديال المحل، على حساب المجموعة وبالترتيب ديال الحروف؛ السيرفر كيرفض برنامج من بلاد أخرى (400).
• المفاتيح والـ tokens عمرهم ما كيبانو فالشاشة.
• كيمسّ المحاسبة: مصاريف الخلصة كيسجّلها برنامج الخلصة فالمحاسبة، والمداخيل كتسجّلها الكاسة (الإعدادات → المحاسبة). AFAS Payroll و Exact Online Loon كاينين فنفس البيئة ديال المحاسبة ديال AFAS و Exact.
• فالنسخة ديال الكاسة اللي فالبورطاي هادشي ما كيمكنش (الكاسة اللي فالمحل هي اللي كتديرو).
• عند شي برامج الـ API ماشي منشور ولا غير للشركاء (من بيناتهم Loket و Nmbrs و Nostradamus و Employes و Shyfter و Planday و Eitje): هادو مكتوبين على حساب الطلب؛ حتى لداك الوقت الملف. الشكل ديال SD Worx و Strobbo جا من الوثائق ديالهم: خلّي شي واحد يراجع أول استيراد.

الشروط القانونية ف بلجيكا وهولندا

أشنو كيطلب القانون وأشنو كيدير HorecaPOS على ودّو (خلّي المحاسب ديالك يأكّد أشنو كيتطبّق على المحل ديالك):

القوانين والقواعد

الإعدادات ← القوانين والقواعد (المسؤول؛ مساعد الضريبة حتى بالحق تسيير المنتوجات). كلشي مطفي من الأول؛ بلا هاد الإعدادات الكاسة خدامة كيف ديما.

• التحقق من العمر للكحول (18+): علّم ف المنتوجات على فيه الكحول (ولا استعمل مساعد الضريبة). ف الطلبيات والتوصيل مع الكحول كيبان "18+" على بون الكوزينة، بون الكاسة وف شاشة الطلبيات. ف المتجر الإلكتروني الكليان كيأكّد براسو بلي عندو 18 عام ولا كثر (الخانة ماشي معلّمة من قبل) وكيشوف بلي العمر غادي يتشاف ملي توصل الطلبية.
• رسوم البلاستيك (هولندا): مبلغ لكل منتوج (أثمنة تقريبية: كاس € 0,25، علبة ماكلة € 0,50، علبة صغيرة € 0,05). ف الطلبيات والتوصيل الكاسة كتزيد بوحدها سطر "رسوم البلاستيك" على البون (بالضريبة ديال المنتوج)؛ كيمشي بوحدو مع المنتوجات (قاعدة البيانات كتتبعو، حتى من بعد الحذف، النقل ولا نوع طلبية آخر) وكيبان بوحدو ف المداخيل. ف المحل ما كايناش الرسوم. Thuisbezorgd.nl والمتجر الإلكتروني كيحسبو الرسوم ديالهم.
• الكونسينيا (هولندا): لكل منتوج (€ 0,15 كانيط/قرعة، € 0,25 قرعة كبيرة)، سطر "الكونسينيا" بلا ضريبة، غير ف الطلبيات والتوصيل.
• كاش € 3.000 ولا كثر (هولندا، ممنوع على السلعة من 1-1-2026): ف الطلبيات والتوصيل كيبان تنبيه ملي تخلّص وف ماكينة الفلوس؛ الخدام يقدر يأكّد (بحال التريتور كخدمة)، وهادشي كيتسجل ف السجل. الماكلة والشراب ف المحل خدمة: ما كاينش تنبيه.
• مساعد الضريبة: النوع ديال كل منتوج (ماكلة، مشروب بلا كحول، مشروب فيه الكحول، ماكلة بلا طياب، آخر؛ ف الأول تخمين على حساب السمية والمجموعة). الكاسة كتبيّن النسبة الصحيحة ف المحل وللطلبيات (بلجيكا من 1-3-2026: الماكلة والمونادا 12%، حتى للطلبيات؛ الكحول 21%؛ ماكلة بلا طياب 6%. هولندا: 9% و21%) وكتطبقها، دغيا ولا من تاريخ.
• برمجة تبديل الضريبة: منتوج لنسبة أخرى، ولا (غير ف هولندا) نسبة ببورسونطاج جديد، من تاريخ. الكاسة كديرو بوحدها ف داك النهار (كتشوف كل ربع ساعة، وملي كتشعل).

الفواتير (واجبة ف بلجيكا بين الشركات) كاينين ف فواتير للكليان ديال الشركات. مازال خاص يتدار: GKS 2.0، نسوّلو فين وصلات الشهادة (شوف docs/backlog-concurrenten.md).

فواتير للكليان ديال الشركات

الإعدادات ← الفواتير (المسؤول؛ عادةً مطفية): شعّل فواتير للكليان ديال الشركات (UBL / Peppol). تحتها، إلا كانت مشعولة، كاينين الخلاص على الحساب، المعلومات على الفاتورة، خدمات Peppol، الربط مع البنكة (مع الخلاص على الحساب) واللائحة ديال جميع الفواتير. ف بلجيكا الفوترة الإلكترونية بين الشركات واجبة من 1-1-2026.

• الفاتورات للكليان ديال الشركات: البونات ← ختار البون ← فاتورة. دخل الكليان (ولا ختار كليان قديم)؛ الكاشير كيصاوب فاتورة بنمرة (مثلا F2026-0001، كتزيد كل عام)، ب UBL حسب Peppol BIS Billing 3.0 وفاتورة للطبع ولا تسجلها PDF. الإرسال بالإيميل (بجوج كمرفقات، وإلا بغيتي نسخة للمحاسب)، عبر Billit لشبكة Peppol (BILLIT_API_KEY، BILLIT_PARTY_ID)، عبر Storecove (STORECOVE_API_KEY، STORECOVE_LEGAL_ENTITY_ID؛ المرسل إليه كيتاخد من Peppol ID ديال الكليان، مثلا 0208 → BE:EN، 0106 → NL:KVK، وإلا بالإيميل عبر Storecove) ولا عبر Banqup ديال Unifiedpost (BANQUP_CLIENT_ID، BANQUP_CLIENT_SECRET، BANQUP_SPACE_ID؛ BANQUP_SANDBOX=1 لبيئة التجريب؛ Banqup كيراجع UBL وكيوصلو بوحدو)، لعنوان ديالك (FACTUUR_HTTP_URL، مثلا برنامج محاسبة ولا خدمة Peppol أخرى) ولا التحميل. فاتورة وحدة لكل بون؛ البون ديجا مخلص، إذن "مخلصة". نمرة KvK/نمرة المقاولة، IBAN، Peppol ID، البادئة وأجل الخلاص ف المعلومات على الفاتورة. جميع الفاتورات ف التحت ديال التبويب (الصلاحية المداخيل حسب المدة).
• المفاتيح والأسرار والـ headers عمرهم ما كيبانو (غير "معمّر"؛ خليه خاوي = يبقى، مسح = يتحيّد) وما كيتكتبوش ف السجل (غير شمن خانات تبدلو). كاينين ف قاعدة البيانات (vestiging.peppol_gegevens): ف الباك أب آه، ف التصدير ديال الإعدادات لا.

كيوسك الخدمة الذاتية

الكليان كيطلبو بوحدهم فعمود ولا تابليت، بحال فالفاست فود، وكيخلّصو فالكاسة ولا بالكارط فالكيوسك. الشاشات ديال الطلب جزء من الكاسة براسها، داكشي علاش المنيو والثمن والاختيارات والمنيوات والهابي آور وأوقات النهار والتصاور والحساسيات واللغات والبون كيجيو من الكاسة وماخاصهمش يتقادو فبلاصة أخرى. فالكيوسك خدّام التطبيق PinPortal Kiosk 2 (أندرويد، حتى Sunmi، وويندوز ولينكس وmacOS) اللي كيبيّن الصفحة وكيطبع البون. طافي بشكل افتراضي.

التشعيل والإعداد (المسؤول): الإعدادات ← المحل ← الشاشات والخدمة بالكيسة ← كيوسك الخدمة الذاتية.

• ختار شنو يقدر يختار الكليان: ناكل هنا و/ولا ناخدها معايا (ناخدها معايا كتحسب بثمن الأخذ ونسبة الضريبة ديال الأخذ، إلا كانو مقادين).
• نص الترحيب، من بعد شحال من ثانية بلا ما يتقيس الكيوسك كيرجع للبداية (الباني كيتخوا)، وشمن مجموعات المنتوجات كاينين فالكيوسك (حتى حاجة ما مأشرة = كلشي).
• بغيتي شي حاجة خرا؟: أشر على مجموعات المنتوجات (مثلا المشروبات، الحلويات)؛ عند الباني الكيوسك كيقترح شي منتوجات منهم.
• الخلاص، لكل كيوسك (شوف زيد كيوسك وربطو):
  • فالكاسة (افتراضي، بحال الكيوسك القديم): الكليان كيطلب، كياخد نمرة ديال الاستلام وكيخلّص فالكاسة. ماكايحتاجش الكيوسك تيرمينال.
  • بالكارط فالكيوسك: الكليان كيخلّص فالتيرمينال اللي حدا الكيوسك.
  • الكليان كيختار: فالكاسة ولا بالكارط. إلا ماكانش عند الكيوسك تيرمينال، كيخلّص فالكاسة.
• للكوزينة (ملي كيخلّص فالكاسة): دغيا من بعد الطلب فالكيوسك (افتراضي)، ولا غير من بعد ما يتخلّص فالكاسة.
• البون: فالطابعة ديال الكيوسك (افتراضي)، فطابعة البونات ديال الكاسة، ولا بلا بون (غير النمرة فالشاشة). ملي كيخلّص فالكاسة، الكيوسك كيطبع ورقة فيها النمرة ومازال ماتخلّصش؛ والبون كيخرج ملي كيتحسب فالكاسة.
• حالة الطلبية فالتيليفون (اختياري، طافي افتراضيا): كيبان كود QR فالبون ديال الكيوسك وفالشاشة الأخيرة. الكليان كيسكانيه، كيشوف النمرة ديالو والحالة (تطلبات، كتوجد، واجدة) وكيجيه إشعار ملي تكون الطلبية واجدة. هادشي كيخدم عبر بوابة الإدارة، خاص الكاسة تكون مربوطة بيها.
• الكحول والمنتوجات بالكيلو عمرهم ما كيكونو فالكيوسك: بلا خدامة ما يمكنش تشوف العمر وما كايناش الميزان.
• سكانير الباركود (اختياري، بشكل افتراضي كلشي مطفي): علّم شنو يقدر يدير السكان فالكيوسك:
  • منتوج فالباني (الكود ديال المنتوج)؛
  • كود التخفيض؛
  • كارط الفيدليتي (الكليان كيجمع النقط)؛
  • بون كادو ولا كارطة الرصيد كخلاص. إلا كان الصولد كافي، الطلب كيتخلّص ديريكت. وإلا البون كيخلّص جزء والكليان كيخلّص الباقي بالكارط ولا فالكاسة (وهادشي مسموح حتى فكيوسك اللي فيه غير الكارط). من بعد هاد الخلاص الجزئي الكليان ما بقاش يقدر يلغي؛ الطلب كيبان فالكاسة بKiosk … · النمرة.

السكانير براسو كتضبطو فالكيوسك: فالتطبيق PinPortal Kiosk 2 فالإدارة ← سكانير الباركود (بحال الكلافيي، السكانير المدمج ولا بور COM)، مع تيست السكانير. السكانير اللي خدّام بحال الكلافيي كيخدم حتى بلا التطبيق.

• شارجي الرصيد (اختياري، عادةً مطفي؛ كيخدم غير إيلا كان الرصيد اللي كيتشارجا شاعل): فشاشة البداية ديال الكيوسك كيبان شارجي الرصيد. الكليان كيسكاني الكارطة ولا البون ديالو (ولا كيكتب الكود)، كيشوف الصولد وكيختار مبلغ. المبالغ كتضبطهم نتا (1 حتى 6، عادةً € 10، € 20 و € 50). الخلاص كيكون بحال ما مضبوط فالكيوسك: بالكارط، ولا فالكاسة بنمرة الاستلام. من بعد ما يتخلّص الحساب كيولّي المبلغ فالصولد. هاد الشارج ما كيمشيش للكوزينة، ما كيبانش فشاشة النداء وما كياخدش كود QR. أكبر صولد ديال الرصيد اللي كيتشارجا صالح حتى هنا.
• على الغرفة ديالي (الربط مع الأوطيل، مطفي من الأول؛ الإعدادات → الأوطيل → الخدمة الذاتية): ملي يتشعل، كتبان حدا السلة حطّو على الغرفة ديالي. الضيف ديال الأوطيل كيكتب النمرة ديال الغرفة والكنية؛ إلا تطابقو مع ضيف ساكن دابا فداك الغرفة، الكوموند كتمشي للكوزينة وكتتسجل مخلّصة على الغرفة (شوف البرنامج ديال الأوطيل: حط على الغرفة).
• بلجيكا (الصندوق الكحل): داكشي اللي مازال ما تجرّبش مع الصندوق الكحل كيكون مطفي بوحدو فالكيوسك (بون كادو ولا الرصيد بحال طريقة الخلاص، الشحن، كود الريميز، المنيوات، الاختيارات بثمن زايد، happy hour)، بحال فالكاسة.

زيد كيوسك وربطو

1. فـ الكيوسكات كتب سمية (مثلا كيوسك الباب) وختار زيد كيوسك. كتاخد كود الربط فيه 6 أرقام (صالح 30 دقيقة).
2. ختار عند الكيوسك كيفاش كيخلّص الكليان: افتراضيا فالكاسة. إلا كان كيوسك فيه تيرمينال، ختار بالكارط ولا الكليان كيختار، وختار التيرمينال ديال هاد الكيوسك (من الإعدادات ← الخلاص).
3. حل صفحة الكيوسك فالكيوسك:
   • فالمحل: فالتطبيق فالإدارة ← Vast adres العنوان اللي كاين عند الإعداد، مثلا http://192.168.1.20:3000/kiosk؛
   • ولا عبر بوابة الإدارة (https، حتى إلا الكيوسك ماشي فنفس الريزو): اربط عنوان الكيوسك اللي كاين عند الإعداد مع كود الكيوسك فالتطبيق، بحال الكيوسك القديم.
4. دخل كود الربط فالكيوسك. صافي: الكيوسك كيعقل على الساروت ديالو. عاود اربط كيعطي كود جديد؛ حيد كيفك الربط.

عند كل كيوسك كيبان واش أونلاين.

هكا كيطلب الكليان

1. شاشة البداية بنص الترحيب؛ الكليان كيختار اللغة ديالو (كاع لغات الكيسة) وكيكليكي باش يطلب.
2. ناكل هنا ولا ناخدها معايا.
3. المينو على حساب مجموعة المنتوجات، بالتصاور والثمن (بالهابي آور) والحساسية وشنو سالا. المنتوجات اللي فيها اختيارات ولا مينو كيحلو فنيترة الاختيار.
4. الباني: بدل الكميات وإلا بغيتي بغيتي شي حاجة خرا؟.
5. طلب (الخلاص فالكاسة): الكليان كيشوف نمرة الاستلام ديالو كبيرة فالشاشة مع المبلغ، كياخد الورقة وكيخلّص فالكاسة. فالكاسة الطلبية محلولة بسمية كيوسك الباب · 42 (النمرة اللي كيقول الكليان)؛ والحساب بحال ديما. من بعد كتبان متخلّصة فشاشة النداء وكتمشي للكوزينة إلا كان خاصها غير من بعد الخلاص.
6. خلّص بالكارط: الكاسة كتصيفط المبلغ للتيرمينال ديال هاد الكيوسك (نفس الربط ديال الخلاص بحال فالكاسة). إلا مانجحش، الكليان يقدر يعاود ولا يلغي (ولا، إلا عندو الاختيار، يخلّص فالكاسة). غير ملي ينجح الخلاص كتمشي الطلبية للكوزينة وكتتحسب. الكليان كيشوف نمرة الاستلام كبيرة فالشاشة وكياخد البون.
7. من بعد شي ثواني الكيوسك كيرجع للبداية.

فالعطب: تنبيه ووضع الطوارئ (فالتطبيق ديال الكيوسك، الإدارة ← Bij storing؛ مطفي بشكل عادي). إلا الكيوسك ما وصلش للكاسة، كيبان Even gesloten. جوج زيادات:

• Teams، Slack، Discord، ntfy، Home Assistant، Make ولا Zapier)، وhersteld ملي يرجع كلشي يخدم. بTestmelding sturen كتشوف واش العنوان مزيان.
• وضع الطوارئ: الكيوسك كيحفظ واحد الكارطة بسيطة كتعطيها صفحة الكيوسك: منتوجات بلا اختيارات ولا مونيات، بالثمن ديال الماكلة هنا (ولا ديال الدّي إلا كان هو الاختيار الوحيد).
  • إلا غابت الكاسة شي مدة (بشكل عادي 60 ثانية)، الضيف كيطلب من هاد الكارطة.
  • الضيف كيخلّص بالكارط ولا فالكونتوار. الخلاص بالكارط كيمشي غير إلا كان Pinbetaling مشعول فالتطبيق.
  • كيطلعو جوج تيكيات ديال الطوارئ: وحدة للضيف (N1، N2 …) ووحدة للكونتوار/الكوزينة. مكتوب فيهم بلي ماشي تيكي ديال الكاسة.
  • ملي ترجع الكاسة، صفحة الكيوسك كتحط الطلبات ديال الطوارئ فالكاسة بNood N… <kiosk>. ما كيمشيوش للكوزينة (عندها التيكي ديال الطوارئ من قبل) وما كيبانوش فشاشة النداء.
  • مخلّص بالكارط وبنفس المبلغ اللي فالكاسة: كيتخلّص كخلّص بلكارط باليد. ولا (خلاص فالكونتوار ولا مبلغ آخر) الطلب كيبقى محلول للسيرفيس.
  • كلشي كاين فالسجل.
• بلجيكا: مع الكاسة المسجّلة (GKS، الصندوق الكحل) خاص كل بيعة تدوز ديريكت عبر الكاسة والـFDM. داكشي علاش غالبًا وضع الطوارئ ما مسموحش؛ سوّل عليه قبل. التطبيق ديال الكيوسك ما كيشعلوش فبلجيكا غير من بعد تأكيد زايد، والكاسة كتنبّه عند الكيوسك.

فالكاسة، الطلبية ديال الكيوسك طلبية عادية (ديما ولا هنا، بسمية كيوسك الباب) بسمية الخدام Kiosk. الكاسة كتصاوبو بوحدها؛ حتى واحد مايقدر يدخل بيه. ماتردّوش غير نشيط، وإلا الكيوسك مايقدرش يطلب. الطلبيات ديال الكيوسك كيبانو فالتقارير، فالبونات وفشاشة النداء. الطلبية اللي ماكتكملش فالكيوسك (ماتطلباتش ولا ماتخلّصاتش بالكارط) كتسالي بوحدها من بعد 30 دقيقة.

الخلاص بالكارط فمود التيست (الإعدادات ← الخلاص)؟ إذن الكيوسك ما كيقبضش بصح؛ مزيان للتجربة. بلا أنترنيت ما يمكنش تخلص بالكارط؛ الكيوسك كيقول بلي تقدر تطلب فالكونطوار.

عطب: إلا ماوصلناش للكاسة، التطبيق ديال الكيوسك كيبيّن "مسدود شوية" وكيكمل بوحدو. إلا كان الكيوسك خدام عبر بوابة الإدارة وطاح الأنترنيت، التطبيق يقدر يرجع للكاسة فالشبكة المحلية (فالتطبيق: الإدارة ← الإضافات ← فالعطب رجع للشبكة المحلية)؛ الكيوسك كيعطي داك العنوان بوحدو.

التطفية: الكيوسك كيقول بلي مسدود شوية. الكيوسكات والإعدادات كيبقاو محفوظين. فالسجل كاين التشعيل/التطفية، الإعدادات، الكيوسكات اللي تزادو وتحيدو، الربط والطلبات الملغية.

لوحة المنيو الرقمية

الكارطة بالأثمنة على تلفازة (ولا شي شاشة أخرى فيها براوزر)، نيشان من الكاسة. افتراضيا طافي؛ كيتشعل من الإعدادات → المحل → الشاشات والخدمة بالكيسة → لوحة المنيو الرقمية. من بعد حلّ ف التلفازة http://<kassaserver>:3000/menubord (ولا البوطون على شاشة بوحدها / على طابليط ولا تيليفون مع كود QR). بلا تسجيل الدخول وبلا ربط.

• لكل مجموعة ديال المنتوجات، المنتوجات بالثمن، بنفس الترتيب ديال الكاسة. ختار براسك شمن مجموعات (وبأي ترتيب)، من 1 حتى ل 4 ديال الأعمدة، غامق ولا فاتح، عنوان ديالك (خاوي = سمية المحل)، التصاور ديال المنتوجات والمواد اللي كتسبّب الحساسية.
• ديما مزيان: اللوحة كتطلب الكارطة كل 10 ثانية (وديغيا ملي كاين شي تبديل)، يعني المنتوج اللي سالا (مشطّب ب سالا، ولا محيّد من اللوحة)، السطوك اللي خوا، الهابي آور (ثمن الحملة مع الثمن العادي مشطّب، والسمية ووقت النهاية لفوق) والفترات ديال النهار (غير اللي كيتباع دابا) كيبانو مزيان بوحدهم.
• إلا ما دخلش كلشي ف الشاشة، الصفحات كيتبدّلو (افتراضيا كل 12 ثانية، تقدر تختار من 5 حتى ل 120).

الخدّامة والكودات ديال PIN

الإعدادات → الخدّامة (غير المسؤول): زيد خدّامة، بدّل السمية، الدور والكود ديال PIN، ورجّعهم ماشي نشيطين.

• الأدوار: السيرفيس (الكوموند، خلّص الحساب، الرابور X)، المانجير (زيد على هادشي التخفيض، الرجوع، سدّ النهار، الكاسة والسجل) والمسؤول (كلشي، حتى كاع الإعدادات). هادا هو الأصل؛ شنو يقدر يدير السيرفيس والمانجير يمكن يتبدّل (شوف الصلاحيات على حساب الدور).
• الكود ديال PIN من 4 حتى ل 8 أرقام، ما يتعاودش بين الخدّامة النشيطين. الكودات ديال PIN كيتسجّلو غير مشفّرين (hash) فقاعدة البيانات وما يمكنش تقراهم من بعد.
• المسح النهائي ما يمكنش (التيكيات والسجل كيرجعو للخدّام)؛ ماشي نشيط = ما يقدرش يدخل عاوتاني.
• ديما كيبقى على الأقل مسؤول واحد نشيط.
• دور آخر، كود PIN جديد ولا ماشي نشيط: الجلسات اللي خدّامة ديال داك الخدّام كيتسدّو ديريكت.
• بلجيكا: اختيارياً الرقم الوطني (rijksregisternummer) للتسجيل ديال الخدّامة.
• اللغة: اللغة ديال الشاشات لهاد الخدّام (ولا "اللغة ديال الجهاز"). من بعد ما يدخل، الكاسة كتكون ديريكت بديك اللغة؛ والخدّام يقدر يبدّلها براسو بالدرابو الصغير لتحت على اليمين (شوف اللغات).
• نصيحة: بدّل الكودات ديال PIN ديال الديمو 1111 و 2222 قبل ما تبدا الكاسة تخدم بصّح.

الدخول بالبادج (اختياري)

عادةً مطفي. باش تشعلو: الإعدادات → الخدّامة، أشّر على الدخول بالبادج (NFC، RFID ولا iButton). خاصك: قارئ USB ديال البادجات اللي كيخدم بحال الكلافيي (للبادجات NFC ولا RFID، البورت-كلي، الأساور ولا المفاتيح iButton). هاد القارئ "كيكتب" النمرة ديال البادج وكيبرك على Enter؛ ما خاص لا درايفر لا ربط.

• الربط: برك على الخدّام، من بعد ربط البادج وقرّب البادج من القارئ. البادج ديال خدّام واحد. حيّد البادج إلا ضاع.
• الدخول: فشاشة الدخول قرّب البادج من القارئ. الكود ديال PIN كيبقى خدّام عادي حتى هو.
• البوانطاج ديال الدخول والخروج (إلا كان مشعول): فشاشة الدخول دخول / خروج (پوانطاج) والبادج قدّام القارئ.
• النمرة ديال البادج كتسجّل غير مشفّرة (hash) فقاعدة البيانات، بحال الكود ديال PIN. الخدّامة اللي ماشي نشيطين ما يقدروش يدخلو حتى بالبادج ديالهم.
• مطفي: الدخول غير بالكود ديال PIN، بحال ديما. البادجات المربوطين كيبقاو محفوظين.

الصلاحيات على حساب الدور

الإعدادات → الصلاحيات (غير المسؤول): علّم لكل دور شنو يقدر يدير السيرفيس والمانجير. فالأصل كلشي بحال اللي فوق بالضبط (بحال ما كانت الكاسة ديما كدير)؛ الخانة اللي مختلفة كتكون ملوّنة.

• المسؤول ديما عندو الحق ف كلشي. التبديل ديال الخدّامة والحقوق كيبقى ديما غير للمسؤول (وإلا شي واحد يقدر يعطي لراسو حقوق كثر).
• البوطونات والأونغليات اللي الدور ماعندوش الحق فيهم، كيكونو مخبّيين على داك الدور؛ والسيرفور ديال الكاسة حتى هو كيتحقق. مثلا إلا عطيتي للمانجير سيّر المنتوجات، غادي يشوف البوطونة الإعدادات وفيها غير الأونغلي ديال المنتوجات.
• التبديلات كيخدمو ديريكت ف كاع الكاسات وكيتسجلو ف السجل. رجع للعادي كيرجّع كلشي بحال ماكان.

المعلومات ديال المحل

الإعدادات ← المحل (غير المسؤول): السمية، العنوان، الكود البريدي، المدينة، التيليفون ونمرة TVA ديال المحل. هادو كيطلعو الفوق ف كل تيكي ديال الكاسة وف pro forma. وهنا تقدر تضبط حتى النص اللي ف التحت ديال التيكي (تقدر تدير بزاف ديال السطور؛ خاوي = بلا نص؛ العادي "شكرا وبالسلامة!")، وتحتو اللغة ديال التيكي (العادية هي الهولندية؛ شوف اللغات). كاين مثال ديال التيكي كيتبدّل مباشرة معاك. من بعد ماتسجّل، التيكي الجاي كياخد ديريكت المعلومات الجداد. البلاد والمعلومات الضريبية (GKS) ماكيتبدّلوش هنا بالقصد. ف بلجيكا نمرة TVA ضرورية. بالكوشة دوّر الخلاص كاش ل 5 سنتيم (عادةً مطفية) كيتدوّر المجموع ملي كيكون الخلاص كاش (€ 6,62 ← € 6,60، € 6,63 ← € 6,65)؛ والفرق كيطلع ف التيكي ك"التدوير". لكارط ديما كيبقى بالسنتيم بالضبط.

تسيير المنتوجات

دخل كمسؤول وختار الإعدادات ← المنتوجات.

• زيد، بدّل (السمية، الثمن، المجموعة، نسبة TVA ف المحل وملي ياخدها معاه، السمية ف التيكي، الكود، سالا) ومسح المجموعات ديال المنتوجات والمنتوجات. المجموعات والمنتوجات يقدرو ياخدو لون ديالهم؛ المنتوج اللي عندو لون كتولي عندو بوطونة ملوّنة ف الشاشة ديال الكوموند (النص كيولي أوتوماتيكيا بيض ولا غامق باش يتقرا مزيان).
• بدّل الترتيب ملي تجرّ مجموعة ولا منتوج من ≡. هادشي كيخدم بالفأرة وبالصبع ف الطابليط. ونفس داك الترتيب بالضبط هو اللي كيبان من بعد ف الشاشة ديال الكوموند؛ الشاشات ديال الكاسة اللي محلولين كيتجدّدو بوحدهم ديريكت.
• المسح كيحيّد المنتوج من الكاسة، ولكن الكوموندات القدام والجورنال الضريبي كيبقاو عارفين المنتوج. المجموعة ماتقدرش تمسحها حتى تكون خاوية.
• الاختيارات: حلّ منتوج ولا مجموعة ديال المنتوجات وزيد تحت "الاختيارات" مجموعات ديال الاختيارات، بحال "طريقة الطياب" (وحدة بالضبط، ضرورية)، "الصوص" (ماكثر من وحدة) ولا "إضافي" (بزاف، مع الأقل والأكثر؛ الأكثر خاوي = بلا حدود). كل اختيار عندو سمية وثمن زايد (يقدر يكون ناقص، مثلا -0,50). المجموعات ديال الاختيارات ديال مجموعة المنتوجات كيخدمو على كاع المنتوجات اللي فيها، زايدين على الاختيارات ديال المنتوج براسو. الترتيب ب ▲▼. المسح ديما ممكن: الكوموندات والتيكيات اللي كاينين كيحتافظو بالاختيارات اللي تختارو. السيرفور حتى هو كيتحقق من الاختيارات الضرورية ومن الأكثر.
• التصويرة ديال كل منتوج: شوف التصاور ديال المنتوجات.
• الثمن بالكيلو، نمرة PLU والتارة (غير إلا كان الميزان مشعول): شوف ضبط الميزان. بلا الكوشة المنتوج كيبقى عادي بالحبة.

تصاور المنتوجات

كل منتوج يقدر تكون عندو تصويرة.

• كيفاش تحط تصويرة: الإعدادات ← المنتوجات ← ختار المنتوج ← ختار تصويرة (ف الطابليط ولا التيليفون تقدر حتى تصوّر ديريكت بالكاميرا). التصويرة كتصغّر ف البراوزر حتى ل 512 × 512 بيكسل على الأكثر (JPEG، غالبا 20–80 kB) وكتسجّل ديريكت؛ تصويرة أخرى كتبدّلها، ومسح التصويرة كتحيّدها. ف الليستة ديال المنتوجات كاينة تصويرة صغيرة قدّام السمية. غير بالحق سيّر المنتوجات؛ jpg، png و webp، ماكثر من 512 kB.
• الإظهار كيختارو المسؤول ف الإعدادات ← المحل ← التصاور ديال المنتوجات، كل وحدة بوحدها، والعادي هو مطفي:
  • تصويرة المنتوج على البوطونات ديال الشاشة ديال الكوموند: التصويرة الفوق ف البوطونة ديال المنتوج، والسمية والثمن تحتها.
  • تصويرة المنتوج حدا المنتوجات ف الشاشة ديال الكليان: تصويرة صغيرة قدّام كل سطر ف الشاشة ديال الكليان (الشاشة ديال الكليان براسها خاصها تكون مشعولة). المنتوجات اللي ماعندهمش تصويرة كيبقاو بحال ماهوما؛ وإلا كان مطفي، كلشي كيخدم بالضبط بحال قبل.

سكانير الباركود

بسكانير الباركود فالكاسة كتسكاني المنتوجات، أكواد التخفيض، كارطات الفيدليتي وبونات كادو. كيتشعل فالإعدادات ← السكانير (أونگلي حدا الطابعات والميزان؛ بشكل افتراضي مطفي). علّم شنو كيدير السكان فشاشة الكوموند:

• منتوج فالتيكي: المنتوج اللي عندو داك الكود (الإعدادات ← المنتوجات، الخانة الكود؛ بحال الكود-بار EAN ديال الباكية). إلا كانو اختيارات، منيو ولا ثمن بالكيلو، كتتحل الأول نافذة الاختيار ولا الميزان، بحال ملي كتنقر. هادشي كيديرو حتى السكان فشاشة الكوموند فطبع الإتيكيتات؛ وهداك كيبقى خدّام عادي.
• كود التخفيض فالتيكي (إلا كانو أكواد التخفيض شاعلين).
• كارط الفيدليتي: الكليان اللي عندو داك النمرة ديال الكارطة كيتزاد فالتيكي (إلا كانت كارط الفيدليتي شاعلة). إلا سكانيتي كود ما معروفش فتيكي فيه كليان، الكاسة كتسول واش هادي هي الكارطة الجديدة ديالو.
• بون كادو ولا كارطة الرصيد: الكاسة كتبيّن الصولد (إلا كانو بونات كادو بالصولد شاعلين). الخلاص كيكون فخلّص الحساب ← بون كادو؛ تما تقدر حتى تسكاني البون.

الكاسة كتقلب الأول فالمنتوجات، من بعد فكارطات الفيدليتي، بونات كادو وأكواد التخفيض. السكان كيخدم فشاشة الكوموند، إلا ما كنتيش وسط شي خانة ديال الكتابة. وسط الخانة، الكود كيتكتب فداك الخانة عادي.

تيست السكانير: فالإعدادات ← السكانير كتشوف مع كل سكان الكود وشنو كتفهم منو الكاسة، حتى إلا كان السكانير مازال مطفي. إلا ما خدّامش:

• دير السكانير على الكلافيي (USB-HID)، مع Enter من بعد الكود. فأغلب السكانيرات هادشي ديجا هكا.
• السكانير المدمج (بحال ديال كاسة Sunmi) كتضبطو فالإعدادات ديال السكانير فالجهاز على الكتابة بالكلافيي.
• الإتيكيتات ديال الميزان TS6X (الوزن والثمن) كيتكلف بيهم الميزان براسو، حتى ملي يكون السكانير شاعل.

فالكيوسك كتضبط السكانير بوحدو (الإعدادات ← المحل ← الكيوسك)؛ شوف كيوسك الخدمة الذاتية.

طبع الإتيكيتات

إتيكيتات ديال المنتوجات فيهم السمية، الثمن وباركود، فطابعة ديال الإتيكيتات (Brother، Dymo، Zebra ...) مركّبة فالكمبيوتر ولا الطابليط. كيتشعل فالإعدادات → المحل → طبع الإتيكيتات (بشكل افتراضي مطفي). تما كتختار حتى القياس ديال الإتيكيت (38 × 25، 57 × 32، 62 × 29 ولا 100 × 50 مم) وواش الثمن والباركود يبانو عليه. طبع نموذج كيطبع إتيكيت واحد ديال التجربة.

• الإعدادات → المنتوجات → (المنتوج) → الإتيكيتات: ختار العدد وطبع.
• الشرا → (كوموند اللي توصّلتي بيها) → طبع الإتيكيتات: لكل منتوج عدد ديال الإتيكيتات قد اللي دخل (وحدات الكوموند اللي توصّلتي بيهم × شحال فكل وحدة؛ ماشي المكوّنات). ماشي كتر من 500 إتيكيت فمرة وحدة.
• الكاسة كتحل نافذة الطبع: ختار فيها الطابعة ديال الإتيكيتات والقياس ديال الرولو. كل إتيكيت صفحة وحدة.
• الباركود هو الكود ديال المنتوج (الإعدادات → المنتوجات): 8 ولا 13 ديال الأرقام مع رقم التحقق صحيح = EAN (12 ديال الأرقام: رقم التحقق كيتزاد)، وإلا Code 128 (حروف، أرقام وعلامات، حتى ل 30 حرف). بلا كود ما كاينش باركود.
• السكان فشاشة الكوموند (خانة، بشكل افتراضي مطفية): سكانير ديال الباركود اللي خدّام بحال الكلافيي كيزيد المنتوج اللي عندو داك الكود، مع الاختيارات العادية (الأوبسيونات، الميزان، الحساسية). ماشي مع الميزان TS6X، اللي عندو الإتيكيتات ديالو بالوزن والثمن.
• الحق: سيّر المنتوجات ولا تسيير السطوك.

إعداد الميزان (A&D، Aclas، Adam Equipment، Avery Berkel، Avery Weigh-Tronix، Balanzas Marques، Baxtran، Bizerba، Brecknell، CAS، Datalogic، Dibal، DIGI، Dini Argeo، Excell Precision، Gram، Ishida، Kern & Sohn، Mettler Toledo، Minebea Intec، Ohaus، Precia Molen، Precisa، Rice Lake، Rongta، Sartorius، Star Micronics، T-Scale، UWE، Wedderburn، Wintec، Zebra)

أونغلي بوحدو الإعدادات ← الميزان (الحق ضبط المحل، الخلاص والطابعات، العادي غير المسؤول؛ الأونغلي ديما كاين، حتى إلا كان الميزان مازال مطفي). العادي هو مطفي: هكا الكاسة كتخدم بالضبط بحال قبل. ماكتشوفش الأونغلي؟

التقليب أوتوماتيكي. إلا مازال ماتضبط والو، الكاسة كتقلّب بوحدها ملي كتحلّ هاد الجزء (البوطونة قلّب كتعاودها):

• واش الكاسة (ولا السيرفور) خدّامة ف ميزان Aclas ديال البيسي ولا AI (TS6X، TS3X، TS5EX/NX/GX، iS6X، iS2X، iR6X، Ti6X، iL8X؛ الماركة/الموديل ديال الجهاز: Windows عبر WMI، Android عبر getprop، Linux عبر DMI) و Aclas Scale Module كيجاوب؟ إيلا هكا، داك الميزان كيتوجّد كف هاد الجهاز، والميزان ديال الإتيكيتات حتى هو؛ ف Linux (بلا Scale Module) الميزان المدمج ف البور الداخلي اللي تلقى (/dev/ttyS...) ك"TS6X (مدمج)"، مع الموديل ديالو؛
• واش كاين OS6X مربوط ف بور COM/USB؟ كل بور كيتجرّب ب 9600، 4800، 2400 و 19200 baud: الأول كيتسنّط شوية (continu)، من بعد كيصيفط W (Toledo)، وإلا لا Dialog 06 (9600، 7 ديال data bits، parité فردية: كيسول على الحالة).

اللي تلقى = كيتحط ف الفورمولير مع البوطونة شعل وخدم بيه: تكليكة وحدة وكيخدم. (التقليب كيصيفط W لكل بور COM خاوي؛ والبور اللي مشغول، مثلا بالماكينة ديال لكارط، كيتفات.)

كاع الموازن ديال Aclas. لكل ميزان كتختار الموديل؛ هكا الكاسة كتعرف كيفاش يتربط. كاينين جوج أنواع:

• ف هاد الجهاز (كيتضبط مرة وحدة): الكاسة خدّامة ف الميزان براسو (ميزان ديال البيسي ولا AI). مع Windows ولا Android كيوزن عبر Aclas Scale Module، بلا بور، بلا سرعة وبلا بروتوكول؛ مع Linux (بلا Scale Module) عبر البور الداخلي ديال الميزان (غالبا /dev/ttyS0 ولا /dev/ttyS1)، مع البور، السرعة والبروتوكول. كاين غير واحد بحال هادا ف كل كاسة؛ التقليب كيلقاه بوحدو. ميزان ديال البيسي ولا AI (TS6X، iS6X ...) ديما ف هاد الجهاز: ف الليستة مايقدرش يكون غير مرة وحدة، والموديلات الأخرى ديال البيسي/AI مابقاوش كيتختارو. ولكن TS6X ف شي بلاصة أخرى ف المحل يقدر يطبع الإتيكيتات (شعل غير سكاني الإتيكيتات).
• مربوط (بزاف ف نفس الوقت): الميزان مربوط بالسيرفور ديال الكاسة بكابل (RS232/USB)، Bluetooth ولا الشبكة. شحال مابغيتي (ماكثر من 8)، كل واحد بسمية ديالو.

ليستة وحدة، جوج كوشات. كاع الموازن كاينين ف ليستة وحدة. لكل ميزان كتشعل شنو كيدير: وزن ف الكاسة (الكاسة كتسول على الوزن ملي كتدير الكوموند) و/ولا سكاني الإتيكيتات (الميزان كيطبع إتيكيت فيه كود-بار والكاسة كتسكانيه، وكياخد PLU من الكاسة). ميزان ديال البيسي ولا AI بحال TS6X يقدر يدير بجوج؛ والميزان ديال الإتيكيتات LS غير الإتيكيتات. الإتيكيتات يقدرو يجيو غير من ميزان واحد ف كل محل.

A&D، Adam Equipment، Avery Berkel، Avery Weigh-Tronix، Balanzas Marques، Baxtran، Bizerba، Brecknell، CAS، Datalogic، Dibal، DIGI، Dini Argeo، Excell Precision، Gram، Ishida، Kern & Sohn، Mettler Toledo، Minebea Intec، Ohaus، Precia Molen، Precisa، Rice Lake، Rongta، Sartorius، Star Micronics، T-Scale، UWE، Wedderburn، Wintec و Zebra. من هاد الماركات كاينين الموديلات المعروفين اللي واضح كيفاش الكاسة كتهضر معاهم (خاصو يتجرّب = البروطوكول ما مكتوبش بالحرف ف حتى مصدر؛ الكاسة كتختار اللي معقول كثر). كاملين مربوطين (بزاف ف نفس الوقت)، ولا كميزان ديال الإتيكيتات اللي الكاسة كتسكاني الإتيكيت ديالو:

• A&D EK-i و HV-WP: دير الميزان على stream (EK-i: prt 0؛ من المعمل كيكون على البوطونة PRINT) والكاسة على بلا ما يحبس ب 2400 baud و 7E1 (هكا كيجي A&D من المعمل). الميساج هو ST,+00512.00 g (US = كيتحرك، OL = تقيل بزاف).
• Adam Equipment Swift: دير الميزان على بلا ما يحبس للـ PC (8N1)؛ والكاسة كتكون على بلا ما يحبس.
• Avery Berkel FX110، FX120 و FX131: ف الميزان ختار البروطوكول Mettler Toledo 82/7 ودير الكاسة على طلب (Toledo) ب 7E1 (9600 baud). Dialog 06 حتى هو خدام. FX125 (اللي فيه الشاشة ديال الثمن) ما كيعرفش Toledo: تما Dialog 06. الكاسة كتوجد هادشي بوحدها ملي كتختار الموديل.
• Avery Weigh-Tronix 7820، 7829 و ZP900 و Brecknell 6702U، 6710U و 6720U: NCI، البروطوكول ديال Weigh-Tronix. الكاسة كتصيفط W (بحال Toledo)، والميزان كيجاوب بالوزن ( 1.234KG) وسطر ديال الحالة اللي كيقول واش كيتحرك، تقيل بزاف ولا خفيف بزاف. الكاسة كتكون على طلب (Toledo) ب 7E1 (9600 baud). USB كيخدم كبور COM افتراضي. ف ZP900 دير الكاسة على البور 2 (NCI). ف 67xxU تقدر حتى تدير ف الميزان 8213 (SCP03).
• Balanzas Marques BM1000P TOP: ف بور COM ختار البروطوكول B (METTLER) و 9600 baud، 7 bits ديال الداتا، parité even؛ الكاسة كتكون على طلب (Toledo) ب 7E1.
• Baxtran TW، VW، XTA و XTA-P (موازن ديال الثمن؛ VW و XTA-P بالعمود): ف المونيو RS232 ديال الميزان ختار البروطوكول Toledo، 9600 baud و 7 bits ديال الداتا ب parité even (7E1)؛ الكاسة كتكون على طلب (Toledo) ب 7E1. الكاسة كتوجد هادشي بوحدها ملي كتختار الموديل. CONT (الميزان كيصيفط بوحدو) حتى هو خدام: دير الكاسة على بلا ما يحبس بنفس السرعة ونفس bits ديال الداتا. ربط بالكابل RS232 (9 بروشات) ولا بكابل USB ل RS232.
• Bizerba CS 300: Checkout-Dialog 06 (المواصفات ديال Bizerba): الكاسة كتصيفط الثمن بالكيلو، والميزان المعاير كيحسب المبلغ. إلا طلب الميزان كودات ديال المراقبة، كتاخدهم من Bizerba ولا من المورّد.
• CAS PD-II، PDN، PDI و PDS-B (PDS-B كاين مثلا عند LRE): ختار ف الميزان ECR type 2 (Toledo) ودير الكاسة على طلب (Toledo) ب 7E1 (9600 baud).
• Datalogic Magellan 9300i، 9400i و 9800i: دير Scale Interface Type ديال بور الوزن على Mettler Toledo 8217 والكاسة على طلب (Toledo) ب 7E1.
• Dibal KS-400، D-POS 400، G-325 و PI-100: ف الميزان ختار البروطوكول Checkout_Dialog06 (البروطوكول 24) و 9600 baud، 7 bits ديال الداتا، parité odd (نوع البارامتر 5)؛ الكاسة كتكون على Dialog 06. D-POS 400 تقدر تتربط حتى ب USB.
• DIGI DS-781: دير الميزان على Type B / الأمر العادي (data transmission 00011)؛ الكاسة كتصيفط ENQ وكترجع ليها الصافي، التارة، الثمن بالكيلو والمبلغ.
• Dini Argeo DFW، DGT و 3590E: دير البور السيري على الإرسال بلا ما يحبس (9600 8N1)؛ والكاسة كتكون على بلا ما يحبس.
• Excell Precision TPE (والجيل 4 ديال AM4، FD4-P، FDP4-P، GE4، GEP4): دير الخروج RS232 على بلا ما يحبس (9600 8N1)؛ والكاسة كتكون على بلا ما يحبس.
• Gram XFOC RS، XFOC+ RS و ZFOC RS: البروطوكول Gram (9600 8N1). الكاسة كتصيفط ENQ، الميزان كيجاوب ACK، الكاسة كتصيفط DC1 والميزان كيصيفط الوزن: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = ثابت، U = كيتحرك، F = غلط؛ BCC = XOR من الحالة حتى للوحدة). ربطو ب RS232 ولا بالكابل USB ديال Gram.
• Kern & Sohn RPB و RFC: دير ف الميزان Prot = DLG-06 (الربط مع الكاسة هو الأوبسيون 965-419)؛ والكاسة كتكون على Dialog 06. RFE، IFB و EOC: إرسال بلا ما يحبس (8N1)، والكاسة على بلا ما يحبس.
• Mettler Toledo Ariva/Viva: دير الميزان على بروطوكول Toledo (8217) والكاسة على طلب (Toledo) مع Bits ديال الداتا / parité = 7E1 (Mettler: 9600 baud، 7 bits ديال الداتا، parité even؛ Ariva تقدر تتربط حتى ب USB كبور COM افتراضي). الكاسة كتوجد هادشي بوحدها ملي كتختار الموديل.
• Minebea Intec Signum، Combics، Midrics و Puro و Sartorius Entris و Quintix: SBI مع طباعة أوطوماتيك (9600 8N1)؛ والكاسة كتكون على بلا ما يحبس. الميساج هو N + 0.512 kg؛ بلا وحدة يعني باقي كيتحرك.
• Ohaus Aviator 7000: ف الإعدادات ديال الميزان (الخطوة 20) ختار البروطوكول Dialog 06؛ الكاسة كتكون على Dialog 06. RS232 ولا USB، على حساب الكابل.
• Ohaus Valor 7000، Ranger 3000/4000/7000 و Defender 3000 (الوزن بلا ثمن): دير الميزان على Auto Print Continuous (9600 baud، 8N1) والكاسة على بلا ما يحبس. الميزان كيصيفط 0.512 kg G؛ ? من بعد الوزن معناها باقي كيتحرك. Ranger 7000 تقدر تتربط حتى ب Ethernet (البور TCP 9761).
• Precia Molen DP400، DPOS CR و C 210 (موازن التجارة ولاو ديال Dibal من 2025): Dialog 06 (9600 7O1)، بحال Dibal. إلا ما خدمش ف C 210، جرّب طلب (Toledo) ب 7E1.
• Precisa XB، XT، LS و LX: دير وضع الطباعة على CONTINUOUS و 9600 8N1، بلا تاريخ، وقت و ID ف السطر؛ والكاسة كتكون على بلا ما يحبس. بلا وحدة يعني الوزن باقي كيتحرك.
• Rice Lake BenchPro BP-S (Toledo 8213) و BP-R (NCI): الكاسة كتكون على طلب (Toledo) ب 7E1.
• Star Micronics mG-T و mG-S8200: عبر RS232 ولا USB (بور COM افتراضي، بالدرايفر ديال Star) على بلا ما يحبس.
• UWE ASEP: RS232 للـ PC/الكاسة، والكاسة على بلا ما يحبس (خاصو يتجرّب).
• Wedderburn TSDS983، TSDS781T و TSDS782T هوما موازن DIGI تحت رقم ديالهم: DIGI (Type B)، بحال DIGI DS-781. إلا ما خدمش، جرّب طلب (Toledo) ب 7E1.
• Wintec ScalePOS ACS-S60E: الكاسة خدامة على ScalePOS براسو؛ الميزان المدمّج كاين ف COM6 (Windows) ولا COM4 (Android)، 9600 8N1. ختار بلا ما يحبس؛ إلا ما صيفط والو، قلّب كيلقى البروطوكول الصحيح.
• Zebra MP7000 و MP72: البور RS232-AUX من المعمل كيكون على SASI (9600 7E1، الكاسة كتصيفط W): الكاسة على طلب (Toledo) ب 7E1.
• موازن الإتيكيتات ديال هاد الماركات (Avery Berkel، Balanzas Marques، Bizerba، CAS، Dibal، DIGI، Ishida، Mettler Toledo، Precia Molen، Rongta، T-Scale و Wedderburn) سيستيمات مستقلين عندهم ملف PLU ديالهم. شعّل سكاني الإتيكيطات ف الميزان ودير نفس الكود-بار اللي ف الميزان (EAN-13، البداية 20–29، PLU والوزن ولا الثمن). PLU كتديرهم ف الميزان براسو ولا بالبرنامج ديال الماركة؛ صيفط لـ TS6X و تيليشارجي فيشي PLU غير ل Aclas.

نفس الليستة كاينة ف الكاسة ف الإعدادات → الميزان → جميع الموازن (ACLAS_MODELLEN ف packages/shared/src/weegschaal.ts، مع الماركة ديال كل موديل).

عمّر أقل ما يمكن: ملي كتختار موديل، الكاسة كتوجد الباقي بحال ما الماركة كتديرو من المعمل: الربط بور COM / USB ف أول بور خاوي، 9600 baud (A&D: 2400) والبروطوكول ديال الماركة (Toledo: Aclas ب 8N1، وب 7E1 Avery Berkel FX، Avery Weigh-Tronix، Balanzas Marques، Baxtran، Brecknell، CAS، Datalogic، Mettler Toledo، Rice Lake و Zebra؛ Dialog 06: Avery Berkel FX125، Bizerba، Dibal، Kern & Sohn RPB/RFC، Ohaus Aviator و Precia Molen؛ DIGI Type B: DIGI و Wedderburn؛ Gram: Gram؛ بلا ما يحبس: A&D، Adam Equipment، Dini Argeo، Excell Precision، Kern & Sohn الآخرين، Minebea Intec، Ohaus الآخرين، Precisa، Sartorius، Star Micronics، UWE و Wintec)، وسمية (مثلا OS6X، OS6X 2). ميزان PC ولا AI كيولي فهاد الجهاز (مثلا TS6X (ingebouwd)؛ ف Linux ف البور الداخلي /dev/ttyS0). إلا شي حاجة ما مزياناش، قلّب كيلقى البور، السرعة والبروطوكول الصحاح.

فهاد الجهاز (Aclas Scale Module): الميزان كيبيّن الوزن المعاير؛ الكاسة كتصيفط الثمن ديال الكيلو و التارا (كتارا مسبقة) و كتاخد المبلغ اللي حسبو الميزان، بحال Dialog 06.

• Android: الأبليكاسيون ديال Aclas ‏AclasScaleDriver (com.aclas.aclasscaledriver) غالبا كاينة ديجا فالميزان؛ إلا ما كانتش، ثبّت aclas-android/AclasScaleDriver.apk. الأبليكاسيون ديال HorecaPOS كتهضر نيشان مع السيرفيس ديال داك الأبليكاسيون، يعني ما خاصك حتى مكتبة زايدة.
• Linux: Aclas ما عندهاش Scale Module ل Linux. ختار غير الموديل (مثلا TS6X): الربط كيولي فهاد الجهاز (البور الداخلي) على /dev/ttyS0، 9600 baud، Toledo. الميزان المدمج غالبا كيكون على /dev/ttyS0 ولا /dev/ttyS1؛ قلّب كيجرّبهم و كيحط البور و السرعة و البروتوكول الصحاح. حتى هنا يقدر يتزاد غير مرة وحدة.

البرامج ديال Aclas جاية مع الكاسة: ‏Scale Module ديال Windows (aclas-module)، ‏AclasScaleDriver ديال Android (aclas-android) و‏Aclas Sync SDK ديال Windows و Linux (aclas-sdk). Aclas كتسمح لينا نعطيوهم مع الكاسة. المثبّتات ديال Windows و Linux فيهم؛ ما خاصك تحمّل ولا تثبّت والو بوحدو.

Bluetooth (مثلا OS6X): ربط الميزان هو اللول. Windows كيرجّعو بور COM (إعدادات Bluetooth ← خيارات Bluetooth أخرى ← بورات COM)، و Linux /dev/rfcomm0: عمّر داك البور. فـالأبليكاسيون ديال Android كتعمّر العنوان ديال Bluetooth (00:11:22:AA:BB:CC)؛ الأبليكاسيون كتطلب الإذن مرة وحدة ل الأجهزة اللي قريبة و كتربط عن طريق Bluetooth SPP.

موازين AI (التعرّف على المنتوج): الكاميرا كتعرف المنتوج فالبرنامج ديال Aclas اللي فالميزان. الوزن كيخدم عن طريق Scale Module (فهاد الجهاز) ولا البور RS232؛ موازين AI بالإتيكيتات كيطبعو من بعد التعرّف إتيكيت فيها كود بار و الكاسة كتسكانيها (بحال TS6X).

Aclas AI Recognition Plugin (ميزان AI والكاسة خدامة عليه، بحال iS6X ب Windows): البلوڭان ديال Aclas كيتعرف على المنتوج وكيكتب الكود-بار ديالو فالكاسة، بحال السكانير (ومن بعد Enter)؛ شاشة الكوموند كتزيد المنتوج مع الوزن فالكوموند. هكا كتريڭلو:

• شعّل ف الميزان السكان ديال الإتيكيتات بنفس الكود-بار اللي ف البلوڭان. النصيحة: كيبدا ب 27، PLU ب 5 أرقام، الوزن (Aclas نوع 17): الكاسة كتحسب بوحدها بالثمن للكيلو. ب الثمن (نوع 12، كيبدا ب 22) حتى هو ممكن.
• طفي وزن ف الكاسة ف هاد الميزان: البلوڭان و Scale Module مايقدروش يوصلو للميزان ف نفس الوقت. الوزن كيجي من الكود-بار. إلا جاوب البلوڭان ف قلّب، الكاسة كتقترح هاد الإعداد وماكتشعلش Scale Module. بلا كود التفعيل البلوڭان كيوزن وكيحسب المبلغ، ولكن مايتعرفش على المنتوجات.
• ف البلوڭان براسو: الكود-بار ف Scale and Barcode Format Settings → Default Barcode Format (النوع 17)، وف إعدادات الشرجم البلاصة فين البلوڭان كيكليكي وكيكتب الكود. ختار ليها بلاصة خاوية ف شاشة الكوموند، ماشي فوق شي بوطونة. المنتوجات الجداد المحل كيعلمهم للبلوڭان براسو ف الميزان (تدريب AI).
• عطي للمنتوجات اللي كيتوزنو نمرة PLU وصيفط PLU للميزان (صيفط لـ TS6X ولا ملف PLU)؛ البلوڭان كيتعرف بنمرة PLU.
• الكاسة كتخلي البلوڭان يتعرف غير ملي تكون شاشة الكوموند محلولة فالميزان براسو (POST /aiplugin/resume، ملي كتسدها /aiplugin/suspend، البور 5003 فالميزان؛ أول مرة حتى EmployeeMode: شاشة الكليان ديال الميزان ما كتبين حتى منتوج). فالكاسات والطابليطات الأخرى وعن طريق بوابة الإدارة ما كيوقع والو.
• البلوڭان ديما كيبدا ف Resume ومايقدرش يعطي الحالة ديالو. داكشي علاش شاشة الكوموند كتصيفط كل 30 ثانية resume من جديد؛ إلا وقف هادشي (الشاشة مسدودة، البلوڭان ولا الميزان تعاود شعل)، الكاسة كتحط البلوڭان ف Suspend ف أقل من دقيقة وكتخليه تما.
• البلوڭان كيطلب كود التفعيل من Aclas لكل ميزان (مربوط بالنمرة ديال السيري). دابا خدام ف Windows؛ النسخة ديال Android من Aclas جاية (الكاسة كتدير تما نفس الحاجة).

Aclas OS6X (ميزان POS مربوط بالكاسة، RS232/USB؛ هكا كيخدمو حتى الموازين الأخرى المربوطة):

• ميزان واحد ولا كثر (ماكسيموم 8)، كل واحد عندو سمية (مثلا الكونطوار، البار) و الربط ديالو: بور COM / USB (COM3 ف Windows، /dev/ttyUSB0 ف Linux/Android) مع السرعة، ولا الريزو عن طريق محوّل من السيري للريزو (عنوان IP و البور TCP، مثلا 4001).
• البروطوكول: طلب (Toledo) = الكاسة كتصيفط W والميزان كيجاوب بالوزن (Toledo 8217، هكا غالبا كيكون OS6X؛ حتى الميساجات ديال الحالة ما ثابتش/ثقيل بزاف/تحت الصفر) ولا بلا ما يحبس = الميزان كيصيفط الوزن بوحدو ديما (ST,GS, 0.512kg، US = ما ثابتش) ولا Dialog 06 (معاير)، شوف لتحت، ولا DIGI (Type B) = الكاسة كتصيفط ENQ و DIGI كيجاوب بالحالة، الصافي، التارة، الثمن بالكيلو والمبلغ (37 حرف: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF؛ الحالة bit 1 = ثابت، bit 2 = تحت الصفر، bit 3 = ثقيل بزاف، bit 4 = خفيف بزاف)، ولا Gram = الكاسة كتصيفط ENQ، كتسنى ACK، كتصيفط DC1 وكتقرا SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. دير ف الميزان نفس البروطوكول ونفس السرعة. Bits ديال الداتا / parité: 8N1 (Aclas، Adam Equipment، DIGI، Dini Argeo، Excell Precision، Gram، Kern & Sohn، Minebea Intec، Ohaus، Precisa، Sartorius، Star Micronics، UWE، Wedderburn، Wintec) ولا 7E1 (A&D، Avery Berkel، Avery Weigh-Tronix، Balanzas Marques، Baxtran، Brecknell، CAS، Datalogic، Mettler Toledo 8217، Rice Lake، Zebra)؛ Dialog 06 ديما 7O1. طلب كيقرا حتى NCI (Avery Weigh-Tronix، Brecknell، Rice Lake BP-R): على W الميزان كيجاوب LF 1.234KG CR LF S00 CR ETX؛ سطر الحالة (S + 2 ولا 3 bytes) كيقول واش كيتحرك (byte 1 bit 0)، خفيف بزاف (byte 2 bit 0) ولا تقيل بزاف (byte 2 bit 1)؛ ^^^^^ = تقيل بزاف، _____ = خفيف بزاف.
• Dialog 06 (Checkout-Dialog 06، البروتوكول الأوروبي ديال الميزان المعاير المربوط بالكاسة): الكاسة كتصيفط الثمن ديال الكيلو (و التارا ديال المنتوج) للميزان؛ الميزان كيوزن، كيحسب المبلغ بوحدو و كيبيّن الثمن ديال الكيلو و الوزن و المبلغ فالشاشة ديالو (المعايرة). الكاسة كتاخد الوزن و المبلغ؛ فشاشة الوزن كيبان "محسوب من طرف الميزان". ديما 9600 baud، 7 بيتات ديال البيانات، باريتي فردية، 1 stopbit (السرعة اللي فالإعدادات ما كتحسبش هنا). المراحل: EOT STX 01 ESC <kiloprijs 6> ESC ETX (مع التارا: الريكورد 03 فيه 4 أرقام ديال الغرام) → ACK؛ ENQ → STX 02 ESC 3 ESC <gram 5> ESC <kiloprijs 6> ESC <bedrag 6> ETX؛ NAK → EOT STX 08 ETX → STX 09 ESC <code> ETX (22 = مازال ما واجدش، عاود من بعد 100 ms؛ 20 = كيتحرك؛ 21 = هزّ هو اللول؛ 30/31 = خفيف بزاف؛ 32 = تقيل بزاف؛ 11 = الثمن ماشي صالح). كودات التحقق: بزاف ديال موازين Dialog 06 كيطلبو مرة مرة (مثلا كل 30 وزنات) كودات التحقق ديال البرنامج ديال الكاسة (الريكورد 11 ← الريكورد 10). هاد الكودات و كيفاش كيتحسبو، الفابريكة ديال الميزان كتعطيهم غير للمورّد ديال الكاسة. عمّرهم ف كودات التحقق (أزواج ديال 4 حروف hexadecimal، مثلا 74AE 1B2C)؛ الكاسة كتصيفطهم فاش كيطلبهم الميزان. إلا كان الميزان كيحسب برقم كيتبدّل (Z) و الكودات الثابتة ما كتمشيش، الكاسة كتقول ليك؛ ف هاد الحالة طلب من المورّد يريڭل الميزان بلا هاد التحقق، ولا خدم ب Toledo.
• الموازين مربوطين بالـ PC ولا الجهاز اللي خدام فيه السيرفور ديال الكاسة؛ كاع الكاسات و التابليتات كيوزنو عن طريق السيرفور ديال الكاسة و كيختارو فشاشة الوزن أشمن ميزان غادي يستعملو. جرّب كيوزن مرة وحدة.
• الريزو كيخدم فكل بلاصة.
• دخّل الوزن حتى بيدك: مشعول = حتى مع الميزان تقدر تدخّل الوزن بيدك؛ بلا OS6X ديما ممكن.

السكان ديال الإتيكيتات (علامة عند الميزان: Aclas TS6X، ميزان آخر ديال PC ولا AI، السيري LS ولا LH15X؛ ميزان + طابعة ديال الإتيكيتات، واحد فكل محل):

• عنوان IP: خاص غير ل Naar TS6X sturen. الوزن و السكان ديال الإتيكيتات كيخدمو بلا بيه. إلا كانت الكاسة خدامة فـ TS6X بوحدو، خليه خاوي: الكاسة غادي تصيفط لراسها (127.0.0.1). إلا كان نفس الميزان كيوزن حتى فالكاسة، جوج العلامات كيكونو عند نفس الميزان (قلّب كيوجدها هكا).
• السكان ديال الإتيكيتات: سكاني الإتيكيتات فشاشة الكوموند. ريڭل كيفاش كيبان الكود بار، بحال ف TS6X: كيبدا ب (20–29، العادي 28)، شحال من رقم ل PLU (4، 5 ولا 6) و من بعد الوزن بالغرام ولا الثمن بالسنتيم، زايد رقم التحقق (EAN-13). تحت الإعداد كاين مثال.
• أرقام PLU: ف الإعدادات ← المنتوجات، المنتوج اللي كيتوزن كياخد ثمن ديال الكيلو، و إلا بغيتي تارا، و رقم PLU (ما يتعاودش). رقم PLU كتختارو من لائحة (بلا PLU، اللي خاوي من بعد، رقم آخر…)؛ فاش كتعلّم على الثمن ديال الكيلو الرقم الخاوي اللي من بعد كيكون ديجا تما. خاص غير للإتيكيتات و PLU ديال TS6X: بلا TS6X يقدر يبقى بلا PLU.
• الإرسال نيشان كيخدم ف Windows و Linux؛ ف Android و macOS خدم بالملف ديال PLU. فأول تثبيت، قارن السميات ديال الخانات ديال الفيشي PLU و الكودات اللي ف aclas-plu.ps1 مع الدليل ديال SDK ديال الميزان اللي توصلتي بيه (بلاصة وحدة باش تبدّل: ACLAS_PLU_KOLOMMEN ف packages/shared/src/weegschaal.ts).

بوابة الإدارة: الميساج للبوابة فيه الخاصية الميزان (A&D، Aclas، Adam Equipment، Avery Berkel، Avery Weigh-Tronix، Balanzas Marques، Baxtran، Bizerba، Brecknell، CAS، Datalogic، Dibal، DIGI، Dini Argeo، Excell Precision، Gram، Ishida، Kern & Sohn، Mettler Toledo، Minebea Intec، Ohaus، Precia Molen، Precisa، Rice Lake، Rongta، Sartorius، Star Micronics، T-Scale، UWE، Wedderburn، Wintec، Zebra) مع شعّل/طفي والموازن حسب الموديل (مثلا TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo)؛ بلا عناوين IP، بورات COM ولا عناوين Bluetooth.

قانون المعايرة: الميزان اللي كتبيع بيه خاصو يكون معاير (الكلاس III، بحال OS6X). مع Toledo/بلا ما يحبس، الكاسة كتحسب بالوزن اللي كيعطي الميزان؛ مع Dialog 06، الميزان المعاير هو اللي كيحسب الثمن بوحدو.

الكود: packages/shared/src/weegschaal.ts (البروتوكولات، الإتيكيتات، فيشي PLU)، apps/pos-server/src/lib/weegschaal.ts و routes/weegschaal.ts؛ الشاشات WeegschaalInstellingen.tsx و WeegDialoog.tsx.

الربط مع المنصات ديال الكوموند أونلاين Thuisbezorgd.nl / Takeaway.com

الكوموندات ديال Thuisbezorgd.nl كيدخلو نيشان للكاسة، بلا وسيط (لا Deliverect، لا HubRise ولا شي حاجة بحالهم): Just Eat Takeaway JET Connect كيتواصل مع بوابة الإدارة ديال Pin Voordeel، والكاسة كتجيب الميساجات ديالها من تما.

فبلجيكا البلاتفورم سميتها Takeaway.com: نفس الشركة (Just Eat Takeaway) ونفس الربط. بالنسبة لمحل بلجيكي، فالشاشات، التنبيهات، تيكي الكوزينة وبوابة الإدارة كيبان Takeaway.com فكل بلاصة عوض Thuisbezorgd.nl. لتحت، Thuisbezorgd كتعني بجوج.

علاش عن طريق البوابة؟ الكاسة خصها غير PORTAAL_URL و PORTAAL_SLEUTEL (شوف بوابة الإدارة) وكتدير غير الطلبات اللي خارجة.

الضبط (الإعدادات → منصات التوصيل → Thuisbezorgd.nl / Takeaway.com، الحق ضبط المحل، الخلاص والطابعات؛ قبل كان هادشي ف الإعدادات → المحل):

1. شعّل خدّم Thuisbezorgd (كيخدم دغيا، بلا ما تحتاج تسجّل).
2. تسجّل ف Thuisbezorgd. من بعد المحل كيختار ف Thuisbezorgd (Partner Hub ولا الأكاونت مانجر) OptimumPOS / Pin Voordeel ككاسة. ساعتها JET كيبدا سيشن ديال onboarding؛ البوابة كتقلّب على الكاسة اللي تسجّلات (بالكود البريدي والسمية، وإلا Pin Voordeel كيربط السيشن باليد فالبوابة)، كتصيفط الإعدادات، وكتطلب من الكاسة المينيو. من بعد الربط كيولّي live.
3. علّم على المنتوجات اللي يمكن تكوموندا عن طريق Thuisbezorgd (بالمجموعة ولا بوحدها)، وإلا بغيتي مع وصف خاص ب Thuisbezorgd. المينيو (الثمن، الاختيارات ك modifiers، المواد المسببة للحساسية، TVA) كيمشي بوحدو؛ PLU = id ديال المنتوج/الاختيار. من بعد أي تبديل فالكتالوج، الكاسة كتحدّث المينيو فأقل من 30 ثانية؛ غير "سالا"/"رجع كاين" اللي كيمشي عن طريق API ديال التوفّر.
4. أوقات الحلان ف Thuisbezorgd: بوحدهم للتوصيل وللي ياخدها معاه (مثلا 16:00-22:00، بزاف ديال الفترات بفاصلة). كيتسجلو بالبوطونة سجّل أوقات الحلان اللي تحتهم وكيمشيو بحال service times لـ Thuisbezorgd ملي يكون الربط واجد.
5. مسدود مؤقتاً / رجع محلول (ف NL/BE كيرجع يتحلّ على الأكثر الصباح اللي من بعد مع 07:00).

الكوموندات. الكوموند كتولّي كوموند عادية بلا طابلة (bezorgen ولا afhalen، سمية المجموعة TB <ordernummer>) بالأثمنة اللي خلّص الكليان، زايد مصاريف التوصيل/السيرفيس فسطر بوحدو والتخفيض ديال Thuisbezorgd فسطر ديال التخفيض؛ إيلا المجموع باقي ما مطابقش، كيتزاد سطر "Verschil Thuisbezorgd" (الفرق). تيكي الكوزينة كيمشي دغيا للكوزينة/البار (تقدر تطفيه). الكاسة كتأكد فثواني للبوابة، والبوابة كتقول ل JET؛ إيلا ما نجحش هادشي ف 3 دقايق ولا الكاسة ماشي متصلة، JET كياخد "فشل" والمحل كيرجع للـ Orderpad.

البوطونة Thuisbezorgd فالبار اللي لفوق (مع عدد الكوموندات اللي خدّامين): اللائحة، الكليان والعنوان، وقت الوجدان/التوصيل والتسلسل الزمني (track & trace): توصلنا بيها، الليفرور جاي للمحل، الليفرور فالمحل، فالطريق للكليان، توصلات (من JET)، زايد مراحل ديالك (كتوجد، واجدة، فالطريق/توصلات إيلا كتوصّل براسك، تهزّات). JET Connect ما كيعطيش للكاسة خريطة live ديال الليفرور؛ الكليان كيشوفها فالتطبيق ديال Thuisbezorgd. الكوموند الجديدة، الإلغاء و"الليفرور فالمحل" كيعطيو بار ليموني وصوت. كمّل (تخلّص أونلاين) كيخلّص الحساب بطريقة الخلاص online؛ إيلا الكليان كيخلّص فالباب، خلّص الحساب عادي. الإلغاء من Thuisbezorgd كيلغي الكوموند وكيطبع تيكي ديال الكوزينة فيه "GEANNULEERD" (تلغات).

الكود: apps/pos-server/src/lib/thuisbezorgd.ts، routes/thuisbezorgd.ts؛ الشاشات ThuisbezorgdInstellingen.tsx و Thuisbezorgd.tsx. من جهة البوابة: horecapos-portaal/src/thuisbezorgd.mjs (شوف README ديال البوابة).

الحساب فبوابة الإدارة. عدد الكوموندات ديال Thuisbezorgd فكل نهار كيمشي مع التقرير لبوابة الإدارة (verkoopTelling ف lib/portaal.ts): اللي دخلو وما تلغاوش، فالنهار اللي دخلو فيه. الكوموند ديال Thuisbezorgd اللي كتخلّص فالكاسة (حتى ب كمّل (تخلّص أونلاين)) ما كتتحسبش مرة أخرى تما مع اللي ياخدها معاه/التوصيل. المعلومات ديال Thuisbezorgd كاينين فقاعدة البيانات ديال الكاسة، إذن كيمشيو عادي مع النسخ الاحتياطية (back-ups) ديال الكاسة.

المتجر ديال الأنترنيت والكوموند أونلاين

كل محل يقدر يكون عندو متجر ديال الأنترنيت ديالو: سيت ديال الكوموندات (وأبليكاسيون) بالستيل ديال المحل ل ياخدها معاه، التوصيل، الكوموند ف الطابلة ب QR-code والريزيرفاسيون، مع الخلاص أونلاين (MultiSafepay ولا Buckaroo) ولا الخلاص ملي ياخدها/ملي توصل. المتجر ديال الأنترنيت مشروع بوحدو، horecapos-webshop (Node.js، شوف README تمّا)، وخدّام ف نفس السيرفور ديال بوابة الإدارة.

التشعال والتوجاد كيكونو ف الإدارة ديال المتجر ديال الأنترنيت: البوطون سيّر المتجر ديال الأنترنيت ف بوابة الكليان (المول المحل) ولا عند التنصيب ف بوابة الإدارة (Pin Voordeel). تمّا كاين التشعال/التطفية، العنوان ديال الويب (<zaak>.<webshopdomein> ولا دومين ديالك)، الستيل (الألوان، اللوغو، التصويرة اللي لفوق، الخط)، أوقات الحلّان والكرينوات ل ياخدها معاه والتوصيل، منطقة التوصيل (أكواد بريدية، شعاع ولا منطقة على الخريطة، مع المصاريف والحد الأدنى)، الخلاص، أكواد التخفيض، النصوص، اللغات، QR-codes ديال الطوابل، الريزيرفاسيون والأبليكاسيون (كتنصّب ك PWA؛ أبليكاسيون Android عبر Trusted Web Activity)، والنوتيفيكاسيونات (اختيارية، طافية من الأول): الكليان كيشعل النوتيفيكاسيون ف الصفحة ديال الكوموند ديالو وكتوصلو نوتيفيكاسيون ملي الكوموند تكون واجدة ولا فالطريق؛ واللي بغا كيوصلو حتى شي عرض من وقت لوقت، كيصيفطو المحل من الإدارة ديال المتجر ديال الأنترنيت (الأونگلي النوتيفيكاسيونات). خدامة على Android والكمبيوترات (Chrome، Edge، Firefox، Samsung Internet)، ف الأبليكاسيون ديال Android، وعلى iPhone وiPad (iOS 16.4 ولا جديد) إلا الكليان زاد المتجر ديال الأنترنيت للشاشة الرئيسية. ما كيتصيفط لا SMS لا إيميل وما كتتحفظ لا سمية لا نمرة. التفاصيل ف README ديال المتجر ديال الأنترنيت.

المينو. الكاسة كتصيفط المينو بوحدها: كاع المنتوجات الخدّامين (ماشي بالكيلو)، حسب مجموعة المنتوجات، مع الثمن، الاختيارات، الحساسيات، سالا والتصويرة ديال المنتوج، زايد الطوابل والمعلومات ديال المحل، وأشمن قنوات ديال الماركوتينغ شاعلين (للعلامة "نتوصل بالعروض" ف الخلاص، شوف الماركوتينغ ب SMS والإيميل). هادشي كيوقع ملي كتبدا، ملي المتجر ديال الأنترنيت كيتشعل، ف 30 ثانية من بعد شي تبديل ف الكاتالوگ وف شي ثواني من بعد شي تبديل ف الإعدادات → المحل، بحال الماركوتينغ ولا كارط الفيدليتي (ولا ب صيفط المينو دابا). باش تخبّي شي منتوج من المتجر ديال الأنترنيت تقدر ف الإدارة ديال المتجر ديال الأنترنيت (خبّي)، ولا ف الداتاباز ب artikel.webshop = false.

الكوموندات. ياخدها معاه والتوصيل كيوليو كوموند عادية بلا طابلة (السمية ديال المجموعة WEB <bestelnummer>) بالأثمنة اللي شاف الكليان، زايد مصاريف التوصيل ومصاريف المعاملة كسطر بوحدو وكود التخفيض كسطر ديال التخفيض؛ إلا المجموع ما تطابقش، كيتزاد سطر "الفرق ديال المتجر ديال الأنترنيت". البوربوار ديال الكليان ما كيتحسبش ف المداخيل: كيدخل ف سالي (تخلّص أونلاين) كبوربوار ف الخلاص. الكوموند ف الطابلة (QR-code) كتمشي للحساب المحلول ديال داك الطابلة (تخلّص أونلاين: كمجموعة بوحدها ف داك الطابلة). تيكي الكوزينة كيمشي نيشان للكوزينة/البار (تقدر تطفيه ف الشرجم المتجر ديال الأنترنيت). الكاسة كتأكّد ف شي ثواني بنمرة التيكي؛ الكليان كيشوف "توصلنا بيها" وكيجيه إيميل. إلا كانت الكاسة أوفلاين، المتجر ديال الأنترنيت ما كياخدش الكوموندات (الكليان كيشوف هادشي دغيا) وكيصيفط إيميل للمحل إلا شي كوموند بقات بزاف بلا ما تتعالج. الريزيرفاسيون من المتجر ديال الأنترنيت كيدخلو ف الريزيرفاسيون (غير إلا كان الريزيرفاسيون شاعل ف الكاسة). إلا كان شي ماكسيموم فكل كرينو (التوصيل والكرينوات)، الكوموندات ديال المتجر ديال الأنترنيت اللي فيها وقت كتتحسب فيه.

بلجيكا (الصندوق الكحل). الكوموند ديال المتجر ديال الأنترنيت كتمشي دغيا بحال كوموند (signOrder) للصندوق الكحل، قبل بون الخدمة، بحال صيفط الكوموند فالكاسة. إلا ما نجحاتش، ما كتدخلش للكاسة والمتجر ديال الأنترنيت كيعاود يصيفطها من بعد. داكشي اللي مازال ما تجرّبش مع الصندوق الكحل كيكون مطفي فالمنيو ديال المتجر ديال الأنترنيت (بونات كادو، كودات الريميز، على الحساب، على الغرفة، المنيوات، الاختيارات بثمن زايد، happy hour والبوربوار) وكيترفض إلا شي متجر قديم صيفطو رغم ذلك. كمّل كيتأكد من البوربوار، على الحساب وعلى الغرفة بحال الكاسة.

على الغرفة (الربط مع الأوطيل، الإعدادات → الأوطيل → الخدمة الذاتية → فالمتجر ديال الأنترنيت): المنيو كياخد kamer: { maxBedrag }؛ المتجر ديال الأنترنيت كيصيفط betaling.wijze = "kamer" مع kamer و achternaam. الكاسة كتأكد من الضيف عند البرنامج ديال الأوطيل (ماشي فالطابلة، ماشي ببون كادو) وكتحفظو مع الكوموند؛ كمّل (على الغرفة) كيخلّص على الغرفة وكيسجّل التيكي على الحساب ديال الأوطيل. الفاتورة المجموعة فالخلاص على الحساب: التيكي كيبقى بحال بند مفتوح.

البوطون المتجر ديال الأنترنيت ف الشريط اللي لفوق (مع عدد الكوموندات اللي جارية): الليستة، الكليان والعنوان، الوقت المطلوب ولا "فأسرع وقت"، طريقة الخلاص والخط الزمني. الخطوات كتوجد، واجدة وف الطريق كيشوفهم الكليان مباشرة ف المتجر ديال الأنترنيت (وبالإيميل، إلا بغا المحل). تخلّصات ف الكاسة = سالات؛ لغي كيلغي غير السطور ديال داك الكوموند ديال المتجر ديال الأنترنيت، كيطبع تيكي ديال الكوزينة "ملغية"، والكوموند اللي تخلّصات أونلاين المتجر ديال الأنترنيت كيرجّع فلوسها. وصل، ما جاش ولا تلغى ف شي ريزيرفاسيون حتى هو كيرجع للمتجر ديال الأنترنيت. كوموند ولا ريزيرفاسيون جديدة كتعطي شريط ليموني وصوت.

الكود: apps/pos-server/src/lib/webshop.ts، routes/webshop.ts؛ الشاشة Webshop.tsx. جيهة البوابة: horecapos-portaal/src/webshop.mjs.

الكاسة والمتجر ديال الأنترنيت بحال بحال (كل جزء كيتشعل بوحدو، عادةً مطفي؛ المتجر القديم ما كيعطيش الاهتمام للخانات الجداد). اللي شاعل ف الكاسة خدام حتى ف المتجر:

• هابي آور: المتجر ديال الأنترنيت كيحسب نفس الثمن اللي كتحسبو الكاسة ف ديك الساعة (الثمن العادي مشطّب والسمية ديال الهابي آور)، حتى مع الموسم.
• الفترات ديال النهار وطريقة الطلب (إلا كانو شاعلين): المتجر ديال الأنترنيت كيبين غير اللي كيتباع دابا، وف ياخدها معاه والتوصيل الثمن والمنتوجات ديال داك الاختيار (ف الطابلة: فالمحل). المنيو كياخد لكل منتوج prijzen (afhalen، bezorgen) وnietBij، واللائحة dagdelen.
• المونيات: الكليان كيختار الماكلات (الثابتين واللي فيهم الاختيار، مع الأوبسيونات ديالهم)؛ ف الكاسة كيطلع كسطر ديال المونو والماكلات تحتو والثمن ديال المونو مقسوم (TVA ديال كل ماكلة مضبوطة). الماكلات اللي كاينين غير ف المونو كيمشيو ك menuArtikelen. متجر قديم بلا اختيارات: المونو كيطلع كمنتوج عادي ف التيكي، بحال قبل.
• السطوك سالا = سالا، حتى الأوبسيونات اللي فيهم مكوّن سالا.
• المواد اللي كتسبّب الحساسية: مطفيين ف الكاسة = ما كيبانوش ف المتجر ديال الأنترنيت.
• كارط الفيدليتي: الكليان يقدر فاش كيخلّص يجمع النقط (بنمرة التيليفون ولا الإيميل)؛ الكاسة كتربط الكليان بالكوموند، والنقط كيتزادو فاش كيتخلّص الحساب (التبديل كيكون ف المحل). المتجر ديال الأنترنيت كيبيّن الصولد.
• بونات كادو (الإعدادات → المحل → بونات كادو → بيع بونات كادو ف المتجر ديال الأنترنيت، غير بالصولد): الكليان كيشري بون وكيخلّص أونلاين؛ الكاسة كتصاوب البون اللي كيخدم ديريكت، والكود كيرجع عبر البوابة للمتجر (الحالة والإيميل). إلا كان حتى بون كادو كطريقة ديال الخلاص شاعل، الكليان يقدر فاش ياخدها معاه يختار "ب بون كادو ف المحل".
• أكواد التخفيض (الإعدادات → أكواد التخفيض، مع البوطون ديال التشعال ف المحل): لكل كود ف الكاسة و/ولا ف المتجر ديال الأنترنيت؛ الاستعمال كيتحسب للجوج مجموعين.
• الپوز والزحام: البوطون المتجر ديال الأنترنيت ف البارة اللي الفوق: دير پوز للمتجر ديال الأنترنيت (مع نص للكليان) والزحام (دقايق زايدين). كيوصل للمتجر ف شي ثواني.
• الريزيرفاسيون أونلاين بالقواعد ديال الكاسة (الإعدادات → المحل → الريزيرفاسيونات): ماكسيموم ديال الناس، النهارات من قبل، الكرينو، الحد الأدنى من قبل والأوقات ديال كل نهار ف السيمانة.
• التوصيل والكرينوات: شوف المتجر ديال الأنترنيت كيتبع الكاسة ف التوصيل والكرينوات.
• All-you-can-eat على الطابلة (الإعدادات → المحل → All-you-can-eat → حتى ملي كيكوماندي على الطابلة بالـ QR-code): إلا كان شي عرض خدام على الطابلة، الكليان كيشوف الأطباق ديالو بحال داخلين ب € 0، مع الدورات، الماكسيموم لكل واحد، وقت الانتظار والحد ديال الوقت. الباقي كيخلّصو عادي؛ كلشي كيمشي للحساب ديال الطابلة. إلا الحال ديال الطابلة تبدّل دابا، الكاسة كترفض الكوموند والكليان كيعاود يكوماندي.
• على الحساب (الإعدادات ← الفواتير ← الخلاص على الحساب ← حتى ف المتجر ديال الأنترنيت): شوف ف المتجر ديال الأنترنيت عند الخلاص على الحساب.
• لائحة الانتظار أونلاين (الإعدادات → المحل → لائحة الانتظار): شوف لائحة الانتظار أونلاين عند لائحة الانتظار ل walk-ins.
• البيع الإضافي: "بغيتي شي حاجة خرا؟" (اختياري، عادةً مطفي؛ الإعدادات → المحل → خلّص الحساب → البيع الإضافي فالمتجر ديال الأنترنيت): ختار المجموعات ديال المنتوجات (مثلا المشروبات، الصلصات، الحلويات) وشحال من اقتراح. فالمتجر ديال الأنترنيت، عند الباني وفاش تخلّص الحساب كيبانو منتوجات من هاد المجموعات اللي مازال ما كايناش فالباني (غير اللي كيتباع دابا، ما ساليش وبلا اختيارات ضرورية)؛ الضيف كيزيدهم بضغطة وحدة. ما ختارتي حتى مجموعة = مطفي، بحال قبل. الكيوسك عندو البيع الإضافي ديالو (شوف كيوسك الخدمة الذاتية).

على هادشي المنيو ديال المتجر ديال الأنترنيت عندو versie: 2 مع الخانات menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst وupsell. والتأكيد اللي كيمشي للبوابة فيه زايد cadeaubonnen (الأكواد)، klant (النقط) وplek (لائحة الانتظار).

الحساب ف بوابة الإدارة. ياخدها معاه والتوصيل عبر المتجر ديال الأنترنيت كيتحسبو بوحدهم (webshop، webshopGeannuleerd ف verkoopTelling)، فالنهار اللي دخلو فيه، وما كيتعاودوش يتحسبو مع ياخدها معاه/التوصيل. الكوموند ف الطابلة كتتحسب عادي مع الطابلة.

الخلاص بلكارط والتيرمينالات

الإعدادات → الخلاص (غير المسؤول):

• التيرمينالات: لكل تيرمينال سمية، الـ ID ديال التيرمينال ومفتاح API ديالو من PinPortal (Klant → Bewerk klant → Overige → API Keys). من بعد ما تسجّل، غير الآخر ديال المفتاح اللي كيبان؛ عمرو ما كيرجع للبراوزر. ب جرّب الاتصال كتشيكي المفتاح والتيرمينال.
• مود التجربة: كيمثّل تيرمينال (كينجح من بعد ±7 s؛ المبلغ اللي كيسالي ب 13 سنتيم كيترفض). مزيان باش تجرّب بلا ماكينة ديال لكارط.

إيلا كان على الأقل تيرمينال واحد عندو مفتاح API (ولا مود التجربة شاعل)، خلّص الحساب → لكارط / Bancontact كيبدا الخلاص بوحدو فالتيرمينال، بالمبلغ اللي كيحسبو السيرفور.

ما دام الربط شاعل، السيرفور كيقبل "لكارط" غير مع خلاص ناجح فالتيرمينال لنفس الكوموند ونفس المبلغ بالضبط. الطلبات كتمشي بحال فالـ PHP-SDK الرسمي كفورمولير عادي، مع الـ API الاحتياطي (api-backup.pinvandaag.com) إيلا الـ API الرئيسي ما جاوبش. كل جواب من الـ API كيبان مع [pin] فشرجم السيرفور، مزيان ملّي كاين شي مشكل. الخلاص الناجح اللي باقي ما تعالجش (بحال التابليت طفات) كيتلقى ملّي تعاود تخلّص داك الكوموند.

البوربوار (لكارط، كاش وبون كادو)

فشاشة الخلاص كاين لكل طريقة خلاص سطر ديال بوطونات البوربوار: والو، 5%، 10%، 15% (مقرّب لفوق ل 10 سنتيم)، قرّب (للأورو الكامل اللي جاي) ومبلغ آخر. بلكارط الكليان كيخلّص المبلغ + البوربوار مرة وحدة فالتيرمينال؛ بالكاش البوربوار كيتحسب فالصرف وفالتيروار ديال الكاسة. فالتيكي كيبان المبلغ اللي تخلّص بلكارط و"منهم بوربوار" تحتو؛ المجموع (TOTAAL) و TVA كيبقاو بحال بحال، حيت البوربوار ماشي مدخول. ف الرابور X/Z كيبان البوربوار لكل طريقة خلاص وك"مجموع البوربوار".

المسؤول كيضبط بوطونات البوربوار ف الإعدادات → المحل → البوربوار: شاعل/طافي، أشمن نسب (ماشي كثر من 4، بحال "5, 10, 15")، واش البوطونة "قرّب" كاينة وفأشمن طرق الخلاص (لكارط، كاش، بون كادو) يمكن البوربوار. "والو" و"مبلغ آخر" ديما كاينين.

"ديرها …" ديما كاينة، فكل طريقة خلاص، حتى إيلا بوطونات البوربوار طافيين (بلا إعداد): الكليان كيقرّب الحساب براسو لفوق والفرق هو البوربوار. كاينين بوطونات بالأورو الكامل اللي جاي والمبالغ المدوّرة اللي جايين (بحال € 28,00 → 29، 30، 40؛ € 44,00 → 45، 50، 60) ومجموع آخر باش تكتب المجموع براسك. تضغط مرة أخرى على نفس البوطونة = بلا تقريب. ماشي كثر من € 500 بوربوار (نفس الحد ديال سيرفور الكاسة).

ما كاينش الأنترنيت

الكاسة كتخدم فالريزو المحلي وما محتاجاش الأنترنيت؛ غير الخلاص بلكارط عن طريق الربط اللي محتاجو. إيلا المحل ما فيهش الأنترنيت، فالبار اللي لفوق كيبان ما كاينش الأنترنيت · لكارط باليد (كيتشيكا كل دقيقة). ساعتها فشاشة الخلاص، وحتى من بعد ما يفشل البدو فالتيرمينال، كتبان البوطونة خلّص ديجا فالتيرمينال: دخّل المبلغ فالتيرمينال براسو وسجّلو بهاد الطريقة.

التصاميم والطابلات

الإعدادات → بلانات الصالة (غير المسؤول):

• زيد بلانات الصالة (بحال الصالة، التيراس، الفيرندا)، بدّل السمية، مسح وبدّل الترتيب ب ◀ ▶.
• زيد الطوابل بالبوطونات اللي فوق الشبكة (مدوّرة، مربّعة، طويلة، طابلة ديال الوقوف) وجرّهم لبلاصتهم بالفارة ولا بصبعك. الركنة الزرقا ديال الطابلة المختارة كتكبّرها ولا كتصغّرها.
• لكل طابلة ضبط السمية/النمرة، عدد الناس (الكراسي اللي دايرين بالطابلة كيتحسبو) والشكل؛ نسخها ولا مسحها.
• بالكلافيي: الفليشات كيحرّكو (Shift = خطوة كبيرة)، و Delete كيمسح.
• التغييرات ما كيتطبقو غير من بعد سجّل؛ "رجّع اللي درتي" كيرجّع كلشي كيف كان.
• الطابلة ولا البلان اللي فيه كوموند محلولة ما يمكنش يتمسح. الطابلات اللي تمسحو كيبقاو محفوظين فالكوموندات القدام.

نقل الإعدادات لمحل ثاني

الإعدادات → الاستيراد/التصدير (غير المسؤول). إلا وجّدتي محل واحد كامل، صدّر الإعدادات لفيشي .json واستوردو فالكاسة ديال المحل التاني. تقدر تختار كل جزء بوحدو:

• المنتوجات: المجموعات، المنتوجات، الأثمنة (حتى حسب طريقة الطلب)، TVA، الاختيارات، المونيات، الهابي آور (مع الموسم)، الفترات ديال النهار، الحساسيات، المكونات/الوصفات، كارطات الطوابع، العروض ديال all-you-can-eat والتصاور ديال المنتوجات.
• البلانات: القاعات والطابلات.
• إعدادات أخرى: كاع الخيارات ديال المحل، الطابعات (بلا عنوان IP)، الحقوق حسب الدور والمحاسبة.

عمرهم ما كيمشيو: السمية، العنوان، الكود البريدي، المدينة، التيليفون، الإيميل، الرقم ديال TVA والسطر ديال الختام ديال التيكي ديال المحل، الإيميل ديال رابور Z، الترمينالات ديال لكارط والساروتات ديالهم، الخدّامة والكودات PIN ديالهم، وكاع المبيعات، التيكيات، الكليان والأعداد ديال السطوك.

الاستيراد محمي بزاف: تنبيه كبير حمر، علامة "فهمت..."، عاود دخّل الكود PIN ديالو ديال المسؤول، حتى كوموند ما تكون محلولة، نفس البلاد (النسب ديال TVA) وقبل كلشي نسخة احتياطية أوتوماتيكية. الاستيراد كيوقع فترانزاكسيون وحدة: إلا وقع شي مشكل، حتى حاجة ما كتبدّل. المنتوجات، المجموعات، المكونات والطابلات اللي كاينين ما كيتمسحوش ولكن كيتحيدو من الكاسة (بحال مسح)، باش التيكيات والرابورات القدام يبقاو صحاح.

الاستيراد من كاسة أخرى

بدّل الكاسة بلا ما تعاود تكتب كلشي. ديما كاين (بلا زر تشعيل): فـ الإعدادات ← استيراد/تصدير (غير المسؤول) كاين القسم استورد من كاسة أخرى.

• شنو: المنتوجات (السمية، الثمن مع TVA، TVA، المجموعة، الكود/PLU، السطوك) ولا الكليان ديال كارط الفيدليتي (السمية، التيليفون، الإيميل، النقط، العنوان، الكود البريدي، المدينة؛ السمية والكنية كيتجمعو).
• الملف: تصدير من الكاسة القديمة ديالك (Dobizzz/DoPos، Lightspeed، MplusKASSA، unTill، Tebi ...) ولا لائحة ديالك: CSV (; , tab ولا |؛ UTF-8 ولا Excel الهولندي) ولا Excel (.xlsx)، الورقة الأولى، بالسميات ديال الأعمدة فالسطر الأول. ملف .xls قديم سجّلو الأول ك .xlsx ولا CSV.
• المعاينة: الكاسة كتعرف الأعمدة من السمية ديالهم (Omschrijving، Verkoopprijs incl. BTW، BTW %، Omzetgroep، Artikelnummer، GSM، Spaarpunten ...) وكتبيّن أول 10 سطر. إيلا شي عمود ما صحيحش، ختارو بيدك. ما كيتبدّل والو حتى استورد.
• المنتوجات: الأثمنة بحال 3,50 ولا € 3,50 ولا 1.234,50؛ TVA بحال 21 ولا 9% ولا 0,09 ولا عالية ولا منخفضة (ما معروفاش ولا خاوية: النسبة اللي كتختار، بشكل افتراضي الأعلى). مجموعات المنتوجات اللي مازال ما كايناش كتصاوب (بلا مجموعة: "مستورد").
• السطوك (العمود Voorraad، Stock، Aantal ...): إلا كان تتبّع السطوك شاعل (الإعدادات → المحل)، المنتوج كيتبّع السطوك والسطوك كيولّي هاد العدد (حساب فتاريخ السطوك، السبب "مستورد"). خاوي: السطوك كيبقى بحال ما هو.
• فيشي نموذج (CSV): ليستة تعمّرها براسك (Naam;Productgroep;Prijs;Btw;Voorraad;Code)، بحال ف Excel.
• الكليان: النقط كيتزادو كتصحيح "مستورد من كاسة أخرى" (كيبان فالتاريخ). الموافقة ديال SMS ولا الإيميل ما كتدوزش (GDPR): خاصك تطلبها عاوتاني. شعل كارط الفيدليتي الأول.
• المنتوجات اللي كاينين (نفس الكود، ولا بلا كود نفس السمية) والكليان (نفس التيليفون ولا الإيميل) كيتدوّزو، ولا كيتحدّثو إيلا علّمتي على هادشي (فالمنتوجات: السمية، الثمن، TVA، المجموعة والسطوك). السطور المعاودة فالملف كتاخد مرة وحدة.
• فالآخر: شحال جديد، تحدّث وتدوّز، مع شنو ما كانش صحيح فكل سطر (بحال ما كاينش الثمن). على الأكثر 5000 سطر فالمرة. فالسجل كيبان ب "الإعدادات تستوردو".

اللغات (42، منهم التركية، العربية، الدارجة، الأمازيغية، البولونية، البلغارية، الهنغارية، الروسية، الصربية، الألبانية، الفارسية، التيغرينية، الأمهرية، الصومالية، البابيامينتو، السرانان تونغو، الهندية، الأردية، الإندونيسية، الفيتنامية، السريانية الآرامية، الصينية والأوكرانية)

حدا البوطونة © اللي لتحت على اليمين، فكل شاشة كاينة بوطونة صغيرة فيها اللغة (مثلا NL والدرابو). كليكي عليها باش تحل القائمة ديال الاختيار: اللغات مرتبين بالترتيب الأبجدي، مع السمية باللغة ديالها قبل الدرابو: Bahasa Indonesia (الإندونيسية)، Čeština (التشيكية)، Darija (الدارجة المغربية بالحروف اللاتينية)، Deutsch، English، Español، Français، Hrvatski (الكرواتية)، Italiano، Kurdî (الكرمانجية)، Latviešu (اللاتفية)، Lietuvių (الليتوانية)، Magyar (الهنغارية)، Nederlands، Papiamentu (البابيامينتو)، Polski، Português، Română، Shqip (الألبانية)، Slovenčina (السلوفاكية)، Soomaali (الصومالية)، Sranantongo، Srpski (الصربية، بالحروف اللاتينية)، Tarifit (الريفية)، Tiếng Việt (الفيتنامية)، Türkçe، من بعد بالحروف السيريلية Български (البلغارية)، Русский (الروسية) و Українська (الأوكرانية)، ومن بعد اللغات اللي كيتكتبو بالحروف العربية: اردو (الأردية)، الدارجة (الدارجة)، العربية (العربية)، دری (الدارية)، فارسی (الفارسية، فارسي)، پښتو (البشتو) و کوردی (سۆرانی) (الكردية السورانية)، من بعد بالحروف السريانية ܣܘܪܝܝܐ (الآرامية السريانية، السوريويو)، بالديفاناغاري हिन्दी (الهندية)، بالحروف الجعزية ትግርኛ (التيغرينية) و አማርኛ (الأمهرية)، بتيفيناغ ⵜⴰⵎⴰⵣⵉⵖⵜ (الأمازيغية)، وفاللخر 中文（简体）(الصينية، الكتابة المبسطة). كاع الشاشات، البوطونات، التنبيهات والميساجات ديال الغلطات ديال السيرفور ديال الكاسة كيتترجمو.

• لكل خدّام: اللغة اللي تختارت كتتحفظ عند الخدّام اللي داخل (gebruiker.taal). إلا دخل شي واحد بلغة أخرى، الكاسة كتبدّل نيشان. فالجهاز براسو كتتحفظ آخر لغة تستعملات، باش حتى الشاشة ديال الكود PIN تكون ديجا بهاديك اللغة. إلا ختاريتي لغة (فالشاشة ديال الكود PIN ولا وانت داخل) ودخلتي (عاوتاني) فأقل من 10 دقايق، داك الاختيار هو اللي كيتحسب وكيولي هو اللغة ديال داك الخدّام. التبديل كيعاود يشارجي الشاشة؛ كتبقى داخل والحساب المحلول كيبقى محلول.
• أول مرة فجهاز: إلا ما كانت حتى لغة فالتابليط ولا البيسي، الكاسة كتبدا باللغة اللي تختارت فالتثبيت. إلا ما تختارت حتى لغة، كتاخد اللغة ديال الجهاز براسو (النافيكاتور ولا النظام، حتى فالتطبيق ديال Android)، وإلا ما كانتش فاللائحة، بالهولندية. من بعد كل جهاز كيتفكر الاختيار ديالو.
• أوروبا الشرقية: البولونية، التشيكية، السلوفاكية، الهنغارية، الرومانية، البلغارية، الكرواتية (حتى للبوسنية)، الليتوانية، اللاتفية، الأوكرانية والروسية: اللغات اللي كيهضرو بيهم أغلب الخدّامة المهاجرين من أوروبا الوسطى والشرقية فهولندا وبلجيكا.
• البلقان: الصربية (بالحروف اللاتينية، كيف كيكتبوها أغلب الصرب اللي فهولندا وبلجيكا؛ حتى للمونتينيغرية) والألبانية (ألبانيا، كوسوفو ومقدونيا الشمالية).
• القرن الإفريقي: التيغرينية (إريتريا) والأمهرية (إثيوبيا)، بجوج بالحروف الجعزية، والصومالية (بالحروف اللاتينية).
• إيران: الفارسية (فارسي). الجهاز اللي خدام بالفارسية ديال أفغانستان (fa-AF) كياخد الدارية، والباقي كياخد الفارسية.
• هولندا الكاريبية وسورينام: البابيامينتو (Papiamentu، الكتابة ديال كوراساو وبونير؛ حتى لأروبا) والسرانان تونغو.
• آسيا: الهندية (بالديفاناغاري؛ حتى للسرنامي الهندوستاني)، الأردية (من اليمين لليسار)، الإندونيسية والفيتنامية (بالحروف اللاتينية، حتى فالتيكي).
• المغربية: الدارجة (العربية المغربية، لغة الهضرة) بالحروف العربية وحتى بالحروف اللاتينية (بحال ما كيكتبو بزاف ديال المغاربة فهولندا فالواتساب)، حدا العربية الفصحى. الأمازيغية: تاريفيت (الريفية، بالحروف اللاتينية؛ أغلب المغاربة فهولندا جاو من الريف) والأمازيغية المعيارية المغربية بحروف تيفيناغ.
• من اليمين لليسار: العربية (الفصحى)، الأردية، الدارجة بالحروف العربية، الدارية والبشتو (أفغانستان)، الفارسية (فارسي، إيران)، الكردية السورانية (العراق/إيران) والآرامية السريانية (السوريويو، بالحروف السريانية). المبالغ، الكودات والبوطونات ديال الأرقام كيبقاو من اليسار لليمين. الكردية الكرمانجية (تركيا/سوريا) كتتكتب بالحروف اللاتينية.
• تيكي ديال الكوزينة (الكوزينة/البار): بشكل افتراضي باللغة ديال الخدّام اللي صيفط الكوموند. لكل طابعة تقدر تحدد ف الإعدادات → الطابعات → اللغة ديال تيكي الكوزينة حتى لغة ثابتة (مثلا ديال الكوزينيي)، بالحروف اللاتينية: Nederlands، Čeština، Darija، Deutsch، English، Español، Français، Hrvatski، Italiano، Kurdî، Latviešu، Lietuvių، Magyar، Papiamentu، Polski، Português، Română، Shqip، Slovenčina، Soomaali، Sranantongo، Srpski، Tarifit، Tiếng Việt، Bahasa Indonesia ولا Türkçe. البلغارية، الروسية والأوكرانية كيخرجو فتيكي ديال الكوزينة بالحروف اللاتينية (الطابعة ديال التيكيات ما كتعرفش الحروف السيريلية). الحروف العربية، السريانية، الديفاناغاري، الجعزية وتيفيناغ والصينية ما يمكنش يتطبعو فالطابعة ديال التيكيات: داك الساعة الدارجة كتطلع بالحروف اللاتينية، الأمازيغية كتاريفيت والباقي بالهولندية. النصوص الثابتة (الطابلة، الطبق، تسنى حتى يتعيّط عليه، عيّط على الطبق، تطبع من بعد، ياخدها معاه، الكونطوار) كيتترجمو؛ السميات ديال المنتوجات والملاحظات كيبقاو كيف تدخلو. الطابعات اللي كانو على الهولندية، كيتبعو الخدّام.
• التيكي ديال الكاسة (لكاع الكليان): بشكل افتراضي بالهولندية، بعيد على اللغة ديال الشاشات. لغة أخرى كتختارها ف الإعدادات → المحل → اللغة ديال التيكي ديال الكاسة (تحت النص اللي لتحت ديال التيكي نيشان)، غير اللغات اللي بالحروف اللاتينية. هادشي كيتطبق حتى على pro forma، تيكي الريتور، النسخة، بون كادو والتيكي بالإيميل. المبالغ، الكودات ديال TVA، الرقم ديال TVA ديال المحل والقواعد الجبائية (بلجيكا) كيبقاو كيف هوما؛ النص الخاص اللي لتحت ديال التيكي كيبقى كيف كتبو المحل.
• المنتوجات، المجموعات والاختيارات سميتهم كيف دخلهم المحل؛ هادو ما كيتترجموش.
• اللغة لكل خدّام تقدر تحددها حتى ف الإعدادات → الخدّامة.
• التقديم والدليل كاينين حتى هوما بكاع هاد اللغات. من البوطونة © كيتحلو باللغة ديال الكاسة؛ الفوق كتختار بالدرابوات لغة أخرى (هادشي ما كيبدّل والو فالكاسة).

للمطورين: كل نص كيبان كاين فالكود ك vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts)؛ النص بالهولندية هو الساروت. الترجمات كاينين ف apps/pos-web/lib/vertalingen/<taal>.ts. إلا كانت شي ترجمة ناقصة، الكاسة كتبيّن الهولندية؛ التيست i18n (pos-web) كيتأكد بلي كل نص مترجم لكل لغة وبلي البلايص ديال {0} صحاح. الميساجات ديال السيرفور ديال الكاسة كيبقاو بالهولندية وكيتترجمو فالنافيكاتور (حتى مع {0}، مثلا سمية ديال منتوج فالميساج).

إعداد الطابعات

الكاسة الجديدة ما فيها حتى طابعة. دخل كمسؤول (ديمو: 1111) وختار الإعدادات فالبار اللي الفوق.

• الطابعات: زيد شحال ما عند المحل ديال الطابعات (مثلا الكاسة، الكوزينة، البار، البيتزا)، كل وحدة بالربط ديالها (غالبا الريزو: عنوان IP والبور 9100) والعرض ديال الورق. ب تيكي ديال التجربة كتشوف واش خدامة. الفوق كتختار أشمن طابعة كتطبع التيكي ديال الكاسة و pro forma (وكتحل التيروار ديال الكاسة). لكل طابعة كتختار حتى اللغة ديال تيكي الكوزينة (شوف اللغات)؛ التيكي ديال الكاسة كيبقى بالهولندية.
• الربط لكل طابعة:
  • الريزو (عنوان IP): عنوان IP والبور (غالبا 9100). هكا كان ديما كيخدم، وهكا غادي يبقى: الطابعات اللي كاينين كيبقاو بوحدهم على الريزو.
  • USB: ف Linux الجهاز، مثلاً /dev/usb/lp0. ف Android طابعة USB المربوطة مع الجهاز (كابل OTG؛ خاوي = أول طابعة USB). ف Windows و macOS ختار طابعة السيستيم.
  • سيري (COM / ttyUSB): بور COM (Windows)، /dev/ttyUSB0 ولا /dev/ttyS0 (Linux، Android) ولا /dev/cu.… (macOS)، مع السرعة (غالبا 9600، 19200 ولا 38400 baud). حتى لطابعة Bluetooth اللي Windows ولا Linux كيربطها كبور COM ولا /dev/rfcomm0.
  • Bluetooth: فالتطبيق ديال HorecaPOS ف Android، بالعنوان ديال Bluetooth ديال الطابعة المقرونة (مثلاً طابعة تيكي محمولة). ربط الطابعة الأول فالإعدادات ديال Bluetooth ف Android.
  • طابعة السيستيم (Windows / CUPS): الطابعة كيفما كيعرفها Windows ولا CUPS (Linux، macOS)، بالدرايفر ديالها ولا ك Generic / Text Only. التيكي كيمشي للطابعة خام (RAW)، بلا تنسيق من الدرايفر.
  • مدمجة (Sunmi, iMin ...): الطابعة اللي داخل كاسة Android براسها.
  • قلّب كيبيّن الطابعات والبورات اللي كتشوف الكاسة. ختار وحدة والعنوان كيتعمّر بوحدو.
• البروتوكول: ESC/POS (تقريبا كاع طابعات التيكي، حتى طابعات Star فالمود ESC/POS) ولا Star (Star Line Mode). مع Star الكاسة كتحوّل التيكي بوحدها؛ التيكي كيبان بحال بحال.
• شاشة السيرفيس اللي عندها طابعة ديالها: شاشة السيرفيس ديال Android فيها التطبيق ديال HorecaPOS (مثلاً جهاز اليد مع طابعة محمولة ديال Bluetooth، ولا Sunmi كشاشة السيرفيس) تقدر تطبع بوحدها. سجّلها فالجهاز براسو (الإعدادات → الطابعات → شاشات السيرفيس اللي عندها طابعة ديالها) وختار فالطابعة مربوطة مع. شاشة السيرفيس كتجيب التيكيات ديالها من الكاسة؛ خلّي التطبيق محلول تمّا. إلا ما نجحش (التطبيق مسدود، برا الويفي)، تيكي الكوزينة كيدخل للائحة الانتظار ديال الطبع، بحال شي طابعة ديال الريزو طافية. لغي التسجيل ديال الجهاز كيرجّع الطابعات للكاسة براسها.
• الطابعة حسب المجموعة / المنتوج: لكل مجموعة ديال المنتوجات كتختار فأشمن طابعة كيطلع تيكي الكوزينة. لكل منتوج تقدر تبدّل هادشي بطابعة خاصة ولا "بلا تيكي ديال الكوزينة".

المنتوجات اللي بحال بحال كيتجمعو ملي كيتطبعو: جوج مرات 1x Cola كيوليو 2x Cola، فتيكي الكوزينة وفالتيكي ديال الكاسة. غير المنتوجات اللي عندهم نفس الاختيارات ونفس الملاحظة كيتجمعو.

المثبّت ديال Linux كيزيد المستعمل ديال الكاسة للمجموعات lp و dialout، باش الكاسة تقدر تستعمل طابعات USB والطابعات السيري.

محتاج المساعدة؟

Optimum POS · 085 560 00 60 · support@optimumpos.nl · من الاثنين للجمعة 9:00–20:00، السبت والحد 14:00–20:00