دليل تكامل Lemonsoft لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط Lemonsoft ERP بـ SkyPlanner APS. يتكامل SkyPlanner مع Lemonsoft في الاتجاهين عبر REST API الخاص بـ Lemonsoft:
- يستقبل SkyPlanner أرقام أوامر العمل (työnumero)، ومراحل العمل (työvaihe)، والآلات، وهياكل المنتجات، والمواد، والورديات المخططة.
- تُعاد أوقات البدء والانتهاء المخططة والآلة المختارة إلى مراحل العمل في Lemonsoft.
- تُرسل تأكيدات المشغّلين إلى Lemonsoft على شكل قيود إنجاز.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
تستخدم Kaskea Group نظام SkyPlanner مع تكامل ثنائي الاتجاه مع Lemonsoft. يضبط فريق SkyPlanner التكامل ليتوافق مع إعدادات Lemonsoft لديكم خلال التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. ويمكن للشركاء والمطورين أيضًا بناء حلول باستخدام REST API الموثّق الخاص بـ SkyPlanner (مرجع API).
REST API الخاص بـ Lemonsoft
واجهة API للتكامل في Lemonsoft هي LemonRest، وهي موثّقة بصيغة Swagger 2.0، بالإصدار v1. يتضمن البناء “LemonRest 2026.10 release-2026.10.2” عددًا قدره 422 مسارًا. (Swagger)
- عنوان URL الأساسي يختلف باختلاف البيئة. تجدونه في إدارة المستخدمين، ضمن إدارة البيئات وعناوين الخدمات، في حقل Rest API. وعلى منصة Azure الخاصة بـ Lemonsoft، يكون العنوان الأساسي
https://rest.lemon.fi. - التوافر. تكون واجهات REST API مثبّتة مسبقًا لدى عملاء خدمة منصة Lemonsoft (Alustapalvelu)، ولا يلزم سوى منح صلاحيات المستخدم. (المصدر)
- بيئة الاختبار. يطلبها العميل النهائي من Lemonsoft Service Desk.
لا تحتاج الجدولة إلى واجهة API المنفصلة لتتبع الوقت في Kellokortti.
المصادقة
يعتمد LemonRest على جلسة:
- يُرجع الطلب
POST /api/auth/loginمع UserName وPassword وDatabase وApiKey معرّفًا هوsession_id. - أرسلوا هذا المعرّف في ترويسة
Session-Idمع كل استدعاء. - جدّدوا الجلسة باستخدام
POST /api/auth/renew. وللتحقق من سلامتها، استخدمواGET /api/auth/alive.
يقبل POST /api/auth/login/token الحقل Token بدلًا من اسم المستخدم وكلمة المرور. أنشئوا مستخدمًا مخصصًا للتكامل بمفتاح API، وامنحوه الصلاحيات التي يحتاجها التكامل فقط. (المصدر)
أما في SkyPlanner، فتستخدم واجهة REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة بصيغة Swagger/OpenAPI. يشرح دليل التكامل التعليمي كيفية إجراء الاستدعاءات الأولى.
اكتشاف التغييرات: الاستعلام عن التغييرات منذ آخر تشغيل
لا يوفر LemonRest نقاط نهاية لإشعارات الويب أو الاشتراكات. تُجلب التغييرات باستعلام يقتصر على ما تغيّر منذ آخر تشغيل:
- يُرجع
GET /api/production/main_ws/changed?updated_after=...مهام الإنتاج التي تغيّرت منذ آخر تشغيل. - أضيفوا
optimization=true. أُضيف هذا الخيار في الإصدار 2026.6.3 لإلغاء الاعتماد على السجل وتسريع الاستعلام. (ملاحظات الإصدار) - يرصد
GET /api/log/deletion_eventsمهام الإنتاج المحذوفة، فتُزال الأعمال الملغاة من الجدول.
استعلموا عن التغييرات كل بضع دقائق. يرسل SkyPlanner إشعارات ويب عند تغيّر الحالة أو الجدول، لذا تعتمد إعادة الكتابة إلى Lemonsoft على الأحداث.
مطابقة البيانات
| كائن Lemonsoft (نقطة النهاية) | كائن SkyPlanner | الاتجاه | وتيرة المزامنة |
|---|---|---|---|
Tuote، product_code (/api/products) | المنتجات والمواد | Lemonsoft → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
Tuoterakenne مع صفوف Työvaiheet (/api/products/structure، all_levels) | هيكل المنتج، والمنتجات الفرعية، وخطوات العملية مع أوقات التجهيز | Lemonsoft → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
Kone، Koneryhmä (/api/production/machines، /api/settings/machine_groups) | محطات العمل ومجموعاتها | Lemonsoft → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
Työnumero بوصفه ProductMainWorkStage (/api/production/workstage، main_ws/changed) | الأوامر مع مواعيد استحقاقها وأولوياتها | Lemonsoft → SkyPlanner | استعلام عن التغييرات كل بضع دقائق |
Työvaihe بوصفه ProductSubWorkStage (main_ws/sub_ws): machine، setting_time، duration، work_amount_left | مهام الإنتاج (خطوات العملية) لكل محطة عمل | Lemonsoft → SkyPlanner | استعلام عن التغييرات كل بضع دقائق |
احتياجات المكوّنات (main_ws/{worknumber}/materials) | احتياجات المواد لكل مهمة إنتاج | Lemonsoft → SkyPlanner | مع كل مهمة إنتاج |
الورديات المخططة (/api/persons/plannedshifts) | الورديات والعاملون | Lemonsoft → SkyPlanner | يوميًا، أو تُدار الورديات في SkyPlanner |
أمر البيع المرتبط برقم أمر العمل (/api/orders/work/{work_number}) | معلومات العميل والأولوية | Lemonsoft → SkyPlanner | مع كل مهمة إنتاج |
حقول Työvaihe: start_time، end_time، machine_id (PUT /api/production/workstage) | وقتَا البدء والانتهاء المخططان ومحطة العمل | SkyPlanner → Lemonsoft | عند تغيّر الجدول، عبر إشعار ويب من SkyPlanner |
قيد الإنجاز (POST main_ws/sub_ws/completion_entry) | التأكيدات: الكمية المنجزة والمرفوضة، والساعات، والشخص | SkyPlanner → Lemonsoft | مع كل تأكيد |
| قواعد الجدولة المضبوطة في SkyPlanner | محطات العمل المسموح بها لكل مهمة إنتاج، ومصفوفة أوقات التجهيز، والأدوات | تُدار في SkyPlanner | تُضبط خلال التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اجلبوا الآلات ومجموعاتها، وهياكل المنتجات بمراحل العمل المرتبطة بها، ومراحل العمل القياسية. اربطوا كل آلة فعلية بمحطة عمل في SkyPlanner. استخدموا الآلات الأم (Isäkone) للتجميع فقط، لأنها تجمع طاقات الآلات التابعة لها.
2. مزامنة أرقام أوامر العمل. اجلبوا أرقام أوامر العمل المفتوحة ومراحلها من /api/production/workstage أو main_ws/sub_ws، مع التصفية حسب الحالة وتقسيم النتائج إلى صفحات. ثم حافظوا على تحديثها باستخدام main_ws/changed. استخدموا work_amount_left في المطابقة، وليس work_amount، لأن Lemonsoft يجدول العمل بناءً على الكمية المتبقية. تغذّي أوامر الشراء جدولة SkyPlanner القائمة على توافر المواد، فتنتظر المرحلة موعد تسليم أمر الشراء.
3. إعادة كتابة الجدول إلى Lemonsoft. لكل مرحلة وضعها المحرك في الجدول أو غيّر موقعها فيه، يرسل SkyPlanner الطلب PUT /api/production/workstage متضمنًا مهمة الإنتاج وsub_workstages التابعة لها. تتضمن كل مرحلة start_time وend_time، وكذلك machine_id عند نقلها إلى آلة بديلة.
4. تأكيدات العمل في المصنع. يؤكد المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer. يُرسل كل تأكيد إلى completion_entry مع sub_workstage_id وperson_number وdone_amount وhours وfailed_amount وjob_done. أرسلوا معه material_consumptions عندما تستهلك المرحلة مواد، وسيسجّل Lemonsoft قيد إنجاز عاديًا (valmistuskirjaus).
5. قواعد ملكية البيانات ومعالجة التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| المنتجات، والهياكل، ومراحل العمل، والكميات، وحالة مهمة الإنتاج | Lemonsoft |
| تسلسل المراحل، وأوقات البدء والانتهاء، واختيار الآلة | SkyPlanner |
| محطات العمل المسموح بها لكل مهمة إنتاج، ومصفوفة أوقات التجهيز، والأدوات | SkyPlanner |
| الورديات وحالات الغياب | نظام واحد يُختار أثناء تحديد النطاق |
| قيود الإنجاز والمخزون | Lemonsoft، وتُسجَّل القيود انطلاقًا من تأكيدات SkyPlanner |
المصدر الرئيسي للتعارض هو الجدولة التلقائية في Lemonsoft وإجراء التحديث؛ فكلاهما يعيد وضع المراحل غير المقفلة في الجدول. أبقوا AUTOTIMING عند 0 ما دام SkyPlanner مسؤولًا عن الجدول. وإذا أبقيتموه مفعّلًا، ففعّلوا قفل الجدولة لكل رقم أمر عمل تُعاد كتابته؛ فهذا يثبّت جميع مراحل ذلك الرقم. لا يكفي Koneiden kapasiteetin lukitus وحده، لأن الجدولة التلقائية تنقل المهام غير المقفلة خارج اليوم المقفل. (المصدر)
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تعمل التجربة المجانية لمدة 30 يومًا على بياناتكم، باستخدام ملف Excel مُصدَّر يتضمن أرقام أوامر العمل والمراحل والآلات.
- تحديد النطاق. اعتمدوا جدول مطابقة البيانات وقواعد ملكيتها والفاصل الزمني للاستعلام الدوري.
- الوصول. يطلب العميل النهائي بيئة اختبار من Lemonsoft Service Desk، وينشئ مستخدم التكامل ومفتاح API.
- التحميل الأولي. الآلات والمجموعات وهياكل المنتجات ومراحل العمل.
- مزامنة أرقام أوامر العمل. الاستعلام الدوري عن التغييرات، وأحداث الحذف، وتجديد الجلسة.
- إعداد القيود في SkyPlanner. محطات العمل المسموح بها لكل مهمة، ومصفوفة أوقات الإعداد، والأدوات.
- إعادة الكتابة إلى النظام. اختبار أوقات المراحل وسجلات الإنجاز في بيئة الاختبار.
- التشغيل المتوازي وبدء التشغيل الفعلي. قارن النتائج بمخطط Gantt الحالي، وصحّح البيانات الرئيسية، ثم فعّل إعادة الكتابة في بيئة الإنتاج.
ما يجب مراعاته عند التخطيط للتكامل مع Lemonsoft
- آلة واحدة لكل مرحلة. ترتبط كل مرحلة في Lemonsoft بآلة واحدة. وأثناء التهيئة، تُحدَّد الآلات المؤهلة لكل منتج من قائمة أو من خصائص المنتج، ثم يختار SkyPlanner من بين البدائل.
- الطاقة الاستيعابية اليومية. تُحدَّد الطاقة الاستيعابية الثابتة بكمية يومية، ولا ترتبط الاستثناءات بوقت محدد من اليوم. مثّل الورديات الفعلية في SkyPlanner أو اقرأ الورديات المخططة.
- الكمية المتبقية. اربط الحقل
work_amount_leftبالحقل المقابل. يؤثر الإعدادان STARTJOB_AUTOTIMENOW وJOBDONE_AUTOTIMENOW أيضًا في توزيع الحمل داخل Lemonsoft نفسه. - انتهاء صلاحية الجلسات. جدّد الجلسة قبل عمليات المزامنة الطويلة، وعالج الحالات التي تتطلب إعادة تسجيل الدخول.
- قواعد التأكيد. تحقّق من توافق كل تأكيد مع حالة المرحلة قبل إرساله، ونظّم معدل الاستدعاءات عند إرسالها على دفعات متتالية.
- تطبيقان للاتصال بالنظام. يشترك LemonOnline وإصدار Windows في قاعدة بيانات واحدة، لذا يخدم التكامل كليهما.
- هياكل المنتجات الكبيرة. استخدم
/api/async/product/structureمع/api/async/status/{jobId}لعمليات الاستيراد الكبيرة.
التكامل مع Lemonsoft: من يتولى إعداده ودعمه؟
يشمل العمل مواءمة البيانات مع آلاتك ومراحل العمل وإعدادات Lemonsoft لديك. ويشمل أيضًا قواعد الجدولة التي تحتفظ بها في SkyPlanner: محطات العمل المسموح بها لكل مهمة، ومصفوفة أوقات الإعداد، والأدوات.
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. تختلف طريقة استخدام Lemonsoft من مصنع إلى آخر، وتُوظَّف هذه الخبرة في إعداد التكامل.
- يمكن لشريك Lemonsoft الذي تتعامل معه المشاركة. فهو يعرف إعداداتك، ويمكنه تولّي حساب مستخدم API والصلاحيات وبيئة الاختبار. ويوفّر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وإشعارات الويب.
- يمكن لمطوّريك أيضًا بناء حلول باستخدام واجهة REST API الموثّقة نفسها ورمز API. يكفي رمز API للبدء، ويساعدك فريق SkyPlanner عند الحاجة.
بعد الربط، ينفّذ محرك Arcturus الجدولة استنادًا إلى أرقام العمل المحدَّثة في Lemonsoft، وتُسجَّل الأوقات المخططة في مراحل العمل. يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل مع فوترة شهرية. ويُقدَّم لك مسبقًا عرض سعر للتكامل يناسب إجراءاتك واحتياجاتك، إلى جانب خطة اشتراكك، لتعرف التكلفة الكاملة قبل البدء.
للمقارنة مع إمكانات التخطيط في Lemonsoft نفسه، اطّلع على تخطيط الإنتاج في Lemonsoft ضمن الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة في صفحة Lemonsoft، وأنظمة أخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
Lemonsoftتكامل ثنائي الاتجاه مع SkyPlanner
Kaskea Group
التصنيع التعاقدي: التشغيل باستخدام CNC، والهياكل الفولاذية، والتجميع
يُخطَّط الإنتاج في SkyPlanner، مع تكامل ثنائي الاتجاه مع Lemonsoft.
توقفات أقلبسبب نقص المواد
“تكمن قيمة SkyPlanner بالنسبة إلينا في أنه أداة فعّالة في الاستخدام اليومي، خاصةً عند تحديد مواعيد التسليم.”
Tommi Männistö، مدير تخطيط الإنتاج
Eskomatic · التشغيل الميكانيكي للغير
تتيح الجدولة التلقائية للأحمال تحديد مواعيد تسليم أدق، وقد انخفضت توقفات الإنتاج الناجمة عن نقص المواد انخفاضًا حادًا.
2 ساعةتُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع الكهربائية ومعدات الفصل والتوصيل
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة عمل جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
الأسئلة الشائعة
هل يوفّر Lemonsoft واجهة API لبيانات الإنتاج؟
نعم. يتيح LemonRest الوصول إلى مهام الإنتاج ومراحل العمل والآلات وهياكل المنتجات والمواد والورديات، كما يتيح تسجيل الإنجاز. وهو مثبّت مسبقًا لدى عملاء Alustapalvelu، ويتطلب مفتاح API وصلاحيات مستخدم.
هل يدعم Lemonsoft خطافات الويب؟
لا تُدرَج أي نقاط نهاية لخطافات الويب في LemonRest. تُقرأ التغييرات باستخدام استعلام التغييرات main_ws/changed وأحداث الحذف، مع الاستقصاء كل بضع دقائق. أما خطافات الويب الخاصة بـSkyPlanner فتُرسل تغييرات الجدول فور حدوثها.
كيف تُرسَل الأوقات المخططة إلى Lemonsoft لتحديثها فيه؟
باستخدام PUT /api/production/workstage، الذي يحدّث المهمة ومراحل عملها بوقت البدء ووقت الانتهاء والآلة. أبقِ الجدولة التلقائية في Lemonsoft معطّلة ما دام SkyPlanner يتولى إدارة الجدول، أو فعّل قفل الجدول لكل رقم عمل تُكتب بياناته، حتى تبقى الأوقات كما حدّدها SkyPlanner.
هل يمكن إرسال تأكيدات المشغّلين من SkyPlanner إلى Lemonsoft؟
نعم. يُرسَل كل تأكيد كسجل إنجاز يتضمن الكمية المنجزة والكمية المرفوضة والساعات والشخص المعني. وتُستخدم هذه الآلية يوميًا في مشاريع العملاء.
من يتولى بناء التكامل مع Lemonsoft؟
يتولى فريق SkyPlanner إعداد التكامل ثنائي الاتجاه بما يناسب إعدادات Lemonsoft لديك أثناء التهيئة، ويدعمه بعد بدء التشغيل الفعلي. ويمكن لشريك Lemonsoft الذي تتعامل معه أو لمطوّريك أيضًا إنشاء التكامل باستخدام واجهة REST API الموثّقة من SkyPlanner، ويكفي رمز API للبدء.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Lemonsoft عبر ملفات Excel أو CSV، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
