دليل تكامل Visma L7 مع APS لجدولة الإنتاج
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط Visma L7 بـSkyPlanner APS. يتكامل SkyPlanner مع Visma L7 في كلا الاتجاهين عبر Visma L7 REST API:
- يستقبل SkyPlanner أرقام أوامر العمل (työnumero)، ومراحل العمل (työnvaihe)، والموارد، وهياكل المنتجات، والأجزاء، والمواد، وأرصدة المخزون، وبنود المبيعات والمشتريات.
- تُكتب بيانات المورد وتاريخ البدء والأولوية والشخص المعيّن وساعات العمل لكل يوم في كل بطاقة عمل في L7 باستخدام
PUT /manufphases/. - تُزامَن الطاقة المتاحة في تقويم الموارد باستخدام
POST /resourceupdates/. - تُقرأ أحداث الإنتاج المسجّلة في قوائم انتظار العمل في L7 باستخدام
GET /manufevents/. - يرسل SkyPlanner تغييرات الجدول فور حدوثها عبر webhooks.
يضبط فريق SkyPlanner التكامل بما يناسب إعدادات L7 لديكم خلال التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. ويمكن للشركاء والمطورين أيضًا بناء حلول باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهة REST API في Visma L7
اسم الواجهة هو Visma L7 – REST API، وهي موثّقة وفق OpenAPI 3.0.3 مع سجل للتغييرات (التوثيق). وتعمل على Visma LTR.
- المسار الأساسي هو
/ltrws/REST/L7على خادم LTR الخاص بكم، سواء داخل منشأتكم أو ضمن خدمة استضافة التطبيقات من Visma. - الترخيص. لكل نقطة نهاية ترخيص مستقل. تتطلب كتابة الجدول ترخيص L7RMFPP لاستخدام
PUT /manufphases/، وتتطلب تحديثات الطاقة المتاحة ترخيص L7RMCAP. ولنقاط نهاية القراءة تراخيصها الخاصة. - تقسيم النتائج إلى صفحات. تُقسَّم القوائم إلى صفحات باستخدام
pageSizeوrecAfter، وتُرشَّح باستخدامqueryKey1وqueryKey2وqueryString.
المصادقة
يُرسَل رمزان مع كل استدعاء إلى L7:
- يحدد hash قاعدة البيانات والشركة.
- يحدد token هوية مستخدم API.
ينشئ مسؤول LTR مستخدم API في Visma LTR، ويربطه بشركة L7، ويمنحه ملفات الصلاحيات، وينشئ رمز المستخدم (خطوات البدء). استخدموا حسابًا مخصصًا للتكامل لا يملك سوى الصلاحيات اللازمة له.
أما في SkyPlanner، فتتم المصادقة على REST API برمز API يُرسَل في ترويسة Authorization-Token. يمكنكم إنشاء الرمز من Settings > API. ويشرح الدليل التعليمي للتكامل خطوات الاستدعاءات الأولى.
رصد التغييرات: modifiedAfter
لا توفر L7 REST API إشعارات ويب. وتُقرأ التغييرات بالاستقصاء الدوري:
- فعّلوا تسجيل التغييرات (DBLOG) من صيانة الملفات في L7 (Tiedostohuolto) للجداول التي يقرؤها التكامل، مثل بطاقات العمل والأجزاء.
- استدعوا نقاط نهاية القراءة مع ضبط
modifiedAfterعلى وقت آخر تشغيل. تُعاد السجلات المحذوفة بعلامة تدل على حذفها، فتُزال الأعمال الملغاة من الجدول. - نفّذوا الاستقصاء كل بضع دقائق. يرسل SkyPlanner إشعارات ويب عند تغيّر الحالة أو الجدول، لذا تُكتب البيانات إلى L7 استجابةً للأحداث.
ربط البيانات
| كائن Visma L7 (نقطة النهاية) | كائن SkyPlanner | الاتجاه | دورية النقل |
|---|---|---|---|
Tuote (GET /products/) | المنتجات والمواد | L7 → SkyPlanner | التحميل الأولي، ثم عند حدوث تغيير |
الأجزاء المرتبطة برقم أمر العمل (GET /manufcomponents/) | المنتجات الفرعية | L7 → SkyPlanner | استقصاء دوري باستخدام modifiedAfter |
احتياجات المواد (GET /manufmaterials/) | متطلبات المواد لكل مهمة | L7 → SkyPlanner | استقصاء دوري باستخدام modifiedAfter |
شجرة الموارد (KRYH) مع عدد الآلات (GET /manufresources/) | محطات العمل ومجموعاتها | L7 → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
بطاقة عمل (TSUUNR) لكل مرحلة (GET /manufphases/) | المهام (خطوات العملية) لكل محطة عمل | L7 → SkyPlanner | استقصاء كل بضع دقائق |
أرصدة المخزون (GET /stockbalances/) | المخزون | L7 → SkyPlanner | استقصاء دوري |
بنود المشتريات (GET /purchaserows/) | أوامر الشراء مع تواريخ التسليم | L7 → SkyPlanner | استقصاء دوري |
أوامر المبيعات وبنودها (GET /salesorders/، GET /salesrows/) | تواريخ الاستحقاق وأولوية العميل | L7 → SkyPlanner | استقصاء دوري |
أحداث الإنتاج (GET /manufevents/) | تقدّم التنفيذ لكل مهمة | L7 → SkyPlanner | استقصاء دوري |
حقول بطاقة العمل resource وstartDate وpriority وperson وschedulingDays (PUT /manufphases/) | محطة العمل ووقت البدء والترتيب والساعات اليومية المخططة | SkyPlanner → L7 | عند تغيّر الجدول، عبر webhook من SkyPlanner |
الطاقة المتاحة في تقويم الموارد (POST /resourceupdates/) | الطاقة المتاحة للوردية | SkyPlanner → L7 | عند تغيّر الورديات |
| قواعد الجدولة المحددة في SkyPlanner | محطات العمل المسموح بها، ومصفوفة أوقات الإعداد، والأدوات، والأفراد | تُدار في SkyPlanner | تُضبط خلال التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرؤوا شجرة الموارد واربطوا كل آلة بمحطة عمل خاصة بها في SkyPlanner. إذا كان المورد الواحد في L7 يضم عدة آلات، فأنشئوا محطة عمل لكل آلة ومجموعة محطات عمل للمورد. اقرؤوا المنتجات وهياكلها مع مراحل العمل المرتبطة بها.
2. مزامنة أرقام أوامر العمل. اقرؤوا بطاقات العمل المفتوحة باستخدام GET /manufphases/، ثم حدّثوها باستمرار باستخدام modifiedAfter. اقرؤوا الأجزاء واحتياجات المواد لكل رقم أمر عمل، وكذلك أرصدة المخزون وبنود المشتريات، بحيث تنتظر كل مرحلة تاريخ التسليم المحدد في بند الشراء المرتبط بها.
3. كتابة الجدول إلى L7. يستدعي SkyPlanner PUT /manufphases/ لكل مرحلة جَدولها المحرك أو غيّر موضعها في الجدول. ويتضمن جسم الطلب إدخالًا واحدًا من نوع workSheet لكل بطاقة عمل، ويحتوي على:
numberلتحديد بطاقة العمل، وresourceلتحديد المورد المختارstartDateوpriority، لتعرض قوائم انتظار العمل في L7 الترتيب الذي حدده SkyPlannerperson، عند تعيين مشغّل محدد في الخطةschedulingDays، للساعات المخططة لكل تاريخ
يحتفظ L7 بالأولوية التي يحددها نظام خارجي دون تغيير (المصدر)، وبذلك يبقى الترتيب محفوظًا في قوائم انتظار العمل.
4. مزامنة الطاقة المتاحة. عند تغيّر الورديات أو العطلات أو العمل الإضافي في SkyPlanner، يكتب POST /resourceupdates/ الطاقة المتاحة الجديدة في تقويم موارد L7. وعندئذ تتطابق عروض الأحمال في L7 مع الخطة.
5. تقدّم التنفيذ في أرض المصنع. يواصل المشغّلون تسجيل التحديثات في قوائم انتظار العمل في L7 وفي Visma LTR، ويقرأ SkyPlanner الأحداث باستخدام GET /manufevents/. ويمكن للمشغّلين أيضًا تأكيد الأعمال في SkyPlanner Mobile Confirmations. يعيد Autopilot التخطيط استنادًا إلى أي من المصدرين، وتُكتب الأوقات الجديدة إلى L7 في عملية الكتابة التالية.
6. قواعد ملكية البيانات وحل التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | الجهة المسؤولة |
|---|---|
| المنتجات والهياكل ومراحل العمل والكميات وحالة أمر العمل | Visma L7 |
| تسلسل المراحل وتواريخ البدء والساعات اليومية واختيار المورد | SkyPlanner |
| محطات العمل المسموح بها، ومصفوفة أوقات الإعداد، والأدوات، والأفراد | SkyPlanner |
| الورديات والغياب | SkyPlanner، مع كتابة البيانات في تقويم موارد L7 |
| أحداث الإنتاج وحركات المخزون المسجّلة | قوائم انتظار العمل في Visma L7 وLTR |
المصدر الرئيسي للتعارض هو التخطيط الداخلي في L7. فقد تعيد عمليتا حساب الاحتياجات والتخطيط التفصيلي جدولة المراحل غير المقفلة. شغّلوهما للمواد والحجوزات فقط، ولا تعيدوا تخطيط المراحل التي يتولى SkyPlanner إدارتها.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تعمل التجربة المجانية لمدة 30 يومًا على بياناتكم الخاصة، انطلاقًا من ملف Excel تُصدَّر إليه أرقام أوامر العمل والمراحل والموارد.
- تحديد النطاق. اعتمدوا جدول ربط البيانات وقواعد ملكيتها والفاصل الزمني للاستقصاء.
- الوصول والتراخيص. احصلوا على تراخيص نقاط نهاية REST المشمولة في النطاق. ينشئ مسؤول LTR مستخدم API وhash وtoken، ويُفضّل أن يبدأ بشركة اختبار.
- تسجيل التغييرات. فعّلوا DBLOG للجداول التي تقرؤونها.
- التحميل الأولي. الموارد والمنتجات والهياكل ومراحل العمل.
- مزامنة أرقام أوامر العمل. الاستقصاء باستخدام modifiedAfter، ومعالجة الحذف، وتقسيم النتائج إلى صفحات.
- ضبط القيود في SkyPlanner. محطات العمل المسموح بها، ومصفوفة أوقات الإعداد، والأدوات، والأفراد.
- الكتابة إلى L7. اختبار
PUT /manufphases/وPOST /resourceupdates/في شركة الاختبار. - التشغيل المتوازي وبدء التشغيل الفعلي. قارنوا النتائج بالخطة الحالية، وصحّحوا البيانات الرئيسية، ثم فعّلوا الكتابة إلى L7 في بيئة الإنتاج.
ما يجب مراعاته عند التخطيط للتكامل مع Visma L7
- ترخيص كل نقطة نهاية. احصر جميع نقاط النهاية مبكرًا واحصل على تراخيصها قبل الاختبار.
- عدد الآلات. يوزّع L7 العمل على الآلات عندما يضم المورد عدة آلات (المصدر). قسّم هذا المورد إلى محطات عمل في SkyPlanner، وعند الكتابة إلى L7، استخدم المورد الذي يتوقعه.
- الساعات اليومية. يخزّن L7 الخطة على هيئة ساعات لكل تاريخ. ويرسل SkyPlanner بيانات
schedulingDaysبحيث يساوي مجموع ساعاتها مدة المرحلة. - تقويم المصنع. احرص على اكتماله، لأن الفجوات فيه تؤدي إلى جدولة المراحل في تواريخ ماضية (المصدر).
- أوامر الإنتاج للمخزون. تُستخدم
mainNumberوsubNumberوrowNumberوnewQuantityفقط لتغيير كمية أمر إنتاج للمخزون. لا تُدرجها في الأعمال الخاصة بالعملاء. - نظام ERP القادم. أوقفت Visma تطوير ميزات جديدة في L7، وينتهي استخدام المنتج بنهاية 2028 (إشعار Visma). احتفظ بقواعد الجدولة في SkyPlanner، لا في حقول L7، لتنتقل معك عند تغيير نظام ERP.
التكامل مع Visma L7: من يتولى إعداده ودعمه؟
يشمل العمل مواءمة البيانات مع مواردك ومراحل العمل وإعدادات L7 لديك. ويشمل أيضًا قواعد الجدولة التي تحتفظ بها في SkyPlanner: محطات العمل المسموح بها، ومصفوفة أوقات الإعداد، والأدوات، والعاملين.
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية ودعمه بعد بدء التشغيل الفعلي. يستخدم كل مصنع L7 بطريقته، وهنا تُوظَّف الخبرة بهذه التفاصيل.
- يمكن لشريك Visma الذي تتعامل معه المشاركة. فهو يعرف إعدادات L7 وLTR لديك، ويمكنه تولي حساب مستخدم API والتراخيص والشركة التجريبية. ويوفر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وإشعارات الويب.
- يمكن لمطوّريك تطوير حلول باستخدامه عبر واجهة REST API الموثّقة نفسها ورمز API. يكفي رمز API للبدء، ويقدم فريق SkyPlanner المساعدة عند الحاجة.
عند استبدال L7، يمكنك ربط SkyPlanner بنظام ERP الجديد بالإعدادات نفسها. راجع صفحات Business Central وVisma Net وLemonsoft وMonitor ERP وOdoo.
يبدأ سعر SkyPlanner من 199 € شهريًا ويشمل 5 محطات عمل، مع فوترة شهرية. وتتلقى مسبقًا عرض سعر للتكامل يلائم عملياتك واحتياجاتك، إلى جانب باقة اشتراكك، لتعرف التكلفة الكاملة قبل البدء.
للمقارنة مع إمكانات التخطيط في L7 نفسه، اقرأ هل يدعم Visma L7 تخطيط الإنتاج بما يراعي القدرة الفعلية للآلات والعاملين؟ ستجد نظرة عامة في صفحة Visma L7، ومعلومات عن الأنظمة الأخرى في مركز التكامل مع أنظمة ERP.
آراء المصنّعين في SkyPlanner
آلاف (1,000s)أوامر العمل تُجدول تلقائيًا
“أصبحت سيطرتنا على الإنتاج مختلفة، وارتقى فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
هانو رينانن، الرئيس التنفيذي
Mamec · خلاطات صناعية ومضخات وتصنيع تعاقدي عالي التقنية
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية آنية للإنتاج على مستوى المؤسسة بأكملها.
98%نسبة الالتزام بمواعيد التسليم، ارتفاعًا من نحو 50%
“يؤدي SkyPlanner دورًا حاسمًا في الحفاظ على التزامنا بمواعيد التسليم.”
هانو لاهتينن، المدير العام
KJH-Comp · أعمال ميكانيكية من الصفائح المعدنية وتصنيع تعاقدي
ارتفعت نسبة الالتزام بمواعيد التسليم من نحو 50% لتصل إلى 98%، وأصبحت الجدولة تحتاج إلى مشرف واحد بدلًا من مشرفَين.
ساعتان (2)تُوفَّران كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج لحظيًا.”
كاله كاليومكي، أخصائي سلسلة الإمداد
UTU · لوحات توزيع ومعدات فصل وتوصيل كهربائية
يوفّر تخطيط الإنتاج ساعتين (2) من وقت العمل كل أسبوع، وتصل قائمة عمل جديدة إلى خط الإنتاج خلال ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
عبدول روسيينغا، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
الأسئلة الشائعة
هل يوفر Visma L7 واجهة API لبيانات الإنتاج؟
نعم. تتيح واجهة REST API الخاصة بـ Visma L7 على Visma LTR الوصول إلى مراحل العمل والموارد والقطع والمواد وأحداث الإنتاج والمنتجات وأرصدة المخزون وبنود المبيعات وبنود المشتريات. وتحتاج كل نقطة نهاية إلى ترخيص مستقل، ويتولى مسؤول LTR إنشاء مستخدم API والرموز.
كيف يُعاد إرسال الجدول إلى Visma L7؟
باستخدام PUT /manufphases/، الذي يحدّث المورد وتاريخ البدء والأولوية والشخص والساعات المخططة لكل تاريخ في كل بطاقة عمل. وتُستخدم POST /resourceupdates/ لكتابة الطاقة المتاحة في تقويم الموارد. يحتفظ L7 بالأولوية الواردة من النظام الخارجي، لذا تتبع قوائم العمل الترتيب المحدد في SkyPlanner.
هل يدعم Visma L7 إشعارات الويب؟
لا توجد إشعارات ويب موثّقة. فعّل تسجيل التغييرات للجداول المشمولة في النطاق، واستعلم دوريًا باستخدام modifiedAfter. أما إشعارات الويب الخاصة بـ SkyPlanner فترسل تغييرات الجدول فور حدوثها.
ما برنامج الجدولة الذي يتكامل مع Visma L7؟
يتكامل SkyPlanner APS مع Visma L7 في الاتجاهين عبر واجهة REST API الخاصة بـ L7، وتُدرج Visma شركة Skycode مع SkyPlanner في صفحة تكاملات L7. ويتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية.
من ينفّذ التكامل مع Visma L7؟
يضبط فريق SkyPlanner التكامل ثنائي الاتجاه ليلائم إعدادات L7 لديك خلال التهيئة الأولية، ويدعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لشريك Visma الذي تتعامل معه أو لمطوّريك تطوير التكامل باستخدام واجهة REST API الموثّقة من SkyPlanner، ويكفي رمز API للبدء.
هل يمكننا تجربة SkyPlanner قبل تنفيذ التكامل؟
نعم. تتيح التجربة المجانية لمدة 30 يومًا استخدام ما يصل إلى 20 محطة عمل، مع استيراد البيانات من L7 بملفات Excel أو CSV، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
