دليل تكامل Monitor ERP لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط Monitor ERP (Monitor G5) بـ SkyPlanner APS. يتكامل SkyPlanner مع Monitor ERP في الاتجاهين عبر Monitor ERP API:
- تُستورد أوامر التصنيع والعمليات ومراكز العمل ومسارات الإنتاج والمواد إلى SkyPlanner.
- تُعاد كتابة موعدَي البدء والانتهاء المخططين ومركز العمل لكل عملية في Monitor.
- تحافظ الأوقات والكميات المسجّلة على تزامن النظامين.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يناسب إعداد Monitor G5 لديكم أثناء التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطورين الراغبين في المشاركة أو بناء حلول بأنفسهم باستخدام REST API الموثّقة لدى SkyPlanner (مرجع API).
واجهة Monitor ERP API
واجهة التكامل الموثّقة في Monitor G5 هي Monitor ERP API v1. تجمع بين CQRS وREST وتستخدم JSON عبر HTTPS. (Monitor ERP API)
- تقرأ الاستعلامات البيانات باستخدام GET. وتقبل خيارات على نمط OData:
$filterو$selectو$expandو$orderbyو$topو$skip. - تكتب الأوامر البيانات باستخدام POST، مثل
Manufacturing/ManufacturingOrderOperations/Update. - ينفّذ Batch عدة أوامر ضمن معاملة واحدة تُنفّذ بالكامل أو لا تُنفّذ، عبر
POST /api/v1/Batch. أضيفوا/Simulateأو/Validateلاختبار الدفعة والتراجع عن تغييراتها. هذه هي الطريقة الآمنة لكتابة جدول كامل. (Batch)
عنوان URL الأساسي هو https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. يجمع رقم الشركة بين رقم قاعدة البيانات ومعرّف الشركة، مثل 004.1.
تقول Monitor بشأن الترخيص: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (يمكن لجميع عملائنا الاستعلام واستخراج المعلومات من API مجانًا. لكن استخدام الأوامر وكتابة البيانات في نظام ERP يتطلبان شراء Monitor ERP API.) أدرجوا ترخيص الكتابة في خطة المشروع منذ اليوم الأول. (api.monitor.se)
المصادقة
- تسجيل الدخول للجلسة. يُرجع طلب
POST /{languageCode}/{companyNumber}/loginباستخدام اسم مستخدم Monitor وكلمة مروره ترويسةX-Monitor-SessionIdلاستخدامها في الاستدعاءات اللاحقة. ويتوفر مسار مصادقة باستخدام رمز MFA. - OIDC. بدءًا من Monitor 25.8، يمكن أيضًا تسجيل الدخول عبر Microsoft Entra ID باستخدام Authorization Code وPKCE. (المصادقة)
- مستخدم مخصّص لواجهة API. أنشئوا مستخدمًا واحدًا للتكامل. وتسري عليه صلاحيات Monitor، مثل Show manufacturing orders وReplan existing manufacturing order.
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. يشرح دليل التكامل التعليمي خطوات إجراء الاستدعاءات الأولى.
اكتشاف التغييرات والاستقصاء الدوري
لا يوثّق مرجع Monitor ERP API أي webhooks أو اشتراكات في الأحداث. تُرصد التغييرات بالاستقصاء الدوري:
- يُرجع
Common/EntityChangeLogs(بدءًا من 2.33) الحقولChangeType(Update، Create، Delete) وEntityTypeIdوEntityIdوModifiedTimestamp. استعلموا منه كل بضع دقائق واجلبوا السجلات التي تغيّرت فقط. (EntityChangeLog) - صفّوا استعلامات أوامر التصنيع لتقتصر على الأوامر المفتوحة، وقسّموا النتائج إلى صفحات باستخدام
$topو$skip.
يرسل SkyPlanner إشعارات عبر webhooks عند تغيّر الحالة أو الجدول، لذا تُكتب البيانات مجددًا إلى Monitor استجابةً للأحداث.
ربط البيانات
| كائن Monitor ERP (API) | كائن SkyPlanner | الاتجاه | دورية النقل |
|---|---|---|---|
Part (Inventory/Parts) | المنتجات والمواد | Monitor → SkyPlanner | تحميل أولي، ثم عبر سجل التغييرات |
قائمة المواد (BOM) ومسار الإنتاج: Manufacturing/MaterialRows، Manufacturing/OperationRows | هيكل المنتج؛ خطوات التصنيع مع أزمنة الإعداد وإنتاج الوحدة | Monitor → SkyPlanner | تحميل أولي، ثم عند التغيير |
Manufacturing/AlternativeOperationRows | محطات عمل بديلة لكل خطوة | Monitor → SkyPlanner | تحميل أولي، ثم عند التغيير |
Work center (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | محطات العمل ومجموعاتها ومعدلات الكفاءة | Monitor → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | الورديات والغياب | Monitor → SkyPlanner | يوميًا، أو تُدار الورديات بشكل مستقل في SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | الأوامر مع مواعيد استحقاقها وحالتها | Monitor → SkyPlanner | استقصاء سجل التغييرات كل بضع دقائق |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | المهام مع مددها والكميات المتبقية | Monitor → SkyPlanner | استقصاء سجل التغييرات كل بضع دقائق |
Manufacturing/ManufacturingOrderMaterials | احتياجات المواد لكل أمر | Monitor → SkyPlanner | استقصاء سجل التغييرات |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | المخزون؛ المواد الواردة في موعد تسليمها | Monitor → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | موعدا البدء والانتهاء المخططان لكل عملية | SkyPlanner → Monitor | عند تغيّر الجدول، عبر webhook من SkyPlanner |
ManufacturingOrderOperations/SetWorkCenter | محطة العمل التي يختارها المحرّك | SkyPlanner → Monitor | عند تغيّر الجدول |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | سجلات الوقت والكميات | قناة واحدة تُختار أثناء تحديد النطاق | مع كل تأكيد أو كل وردية |
| غير موجودة في Monitor | مصفوفة أزمنة الإعداد، والأدوات بوصفها موارد محدودة السعة، والمهام التي تتطلب عدة مشغّلين | تُدار في SkyPlanner | تُضبط أثناء التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأوا مراكز العمل وصفوف العمليات وصفوف العمليات البديلة وصفوف المواد والأصناف والجداول. حدّدوا بعناية محطة العمل المقابلة في SkyPlanner لكل مركز عمل. يتحوّل مركز العمل من نوع Pool إلى مجموعة محطات عمل، وتتحوّل مراكز العمل المدرجة فيه إلى محطات عمل يختار المحرّك من بينها.
2. مزامنة الأوامر. اقرأوا أوامر التصنيع المفتوحة مع عُقدها وعملياتها وموادها، إلى جانب المخزون وأوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ التسليم المحدّد في أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered. بعد التحميل الأول، تُستمد التحديثات التفاضلية من Common/EntityChangeLogs.
3. إعادة كتابة الجدول. لكل عملية أدرجها المحرّك في الجدول أو نقلها، يرسل SkyPlanner الأمر ManufacturingOrderOperations/Update مع PlannedStartDate وPlannedFinishDate. وعندما ينقل المحرّك عملية إلى آلة أخرى ضمن مجموعة، يُنفّذ SetWorkCenter أولًا. تُجمع أوامر كل أمر تصنيع في Batch واحد، ليقبلها Monitor كلها أو يرفضها كلها. شغّلوا الدفعة عبر /Validate أثناء الاختبار.
في إصدارات Monitor السابقة لـ 24.5، لا يمكن كتابة التواريخ المخططة عبر Update. استخدموا بدلًا منه ManufacturingOrders/ReplanOperation (المتاح بدءًا من 2.40) مع StartDate وFinishDate، واضبطوا RestrictToOrderBounds وفقًا لقواعدكم.
4. تأكيدات التنفيذ في أرض المصنع. اعتمدوا قناة واحدة لتسجيل التنفيذ:
- يبقى Monitor قناة التسجيل. يسجّل المشغّلون التنفيذ عبر Recording terminal أو من خلال تكامل الآلات كما يفعلون حاليًا. ويقرأ SkyPlanner بيانات
ManufacturingOrderOperationReportingsلمتابعة التقدّم وإعادة التخطيط. - يصبح SkyPlanner قناة التسجيل. يسجّل المشغّلون العمل باستخدام Mobile Confirmations أو Production Timer، ويرسل SkyPlanner الأمر
ReportManufacturingOrderOperationإلى Monitor.
يؤدي التسجيل من كلا النظامين إلى تكرار الأوقات والكميات.
5. قواعد ملكية البيانات ومعالجة التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف وقائمة المواد (BOM) ومسار الإنتاج والكميات وحالة الأمر | Monitor |
| تسلسل العمليات وموعدا البدء والانتهاء المخططان ومركز العمل ضمن المجموعة | SkyPlanner |
| مصفوفة أوقات التجهيز، والأدوات، وأعداد المشغّلين، والموارد البديلة | SkyPlanner |
| ورديات العمل والغياب | نظام واحد يُختار أثناء تحديد النطاق |
| تسجيل بيانات تنفيذ العمليات | قناة واحدة تُختار أثناء تحديد النطاق |
ينشأ التعارض أساسًا عندما يواصل المخططون تعديل خطة الأولويات. فاستخدام Rescheduling according to New finish وسحب الصفوف في Priority planning يستبدلان التواريخ التي كتبها SkyPlanner. وبمجرد أن يصبح SkyPlanner مسؤولًا عن ترتيب العمليات، تُستخدم Priority planning للعرض فقط. ومع Autopilot، يعيد SkyPlanner الجدولة تلقائيًا عند حدوث تغييرات في الإنتاج.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تتيح لك التجربة المجانية لمدة 30 يومًا استخدام بياناتك الفعلية. صدّر عمليات أوامر التصنيع المفتوحة ومراكز العمل من Monitor إلى Excel، ثم استوردها وتحقق من صحة الجدول قبل البدء بأي أعمال تكامل.
يشمل المشروع نفسه ما يلي:
- تحديد النطاق. حدّد جدول مطابقة البيانات، وقواعد المسؤولية عنها، وفترات الاستقصاء الدوري، وقناة تسجيل بيانات التنفيذ، وإصدار Monitor.
- الوصول. أنشئ مستخدم API، واشترِ ترخيص الكتابة عبر Monitor ERP API، وافتح الوصول عبر الشبكة إلى المنفذ 8001.
- التحميل الأولي. الأصناف، ومراكز العمل، وصفوف العمليات، والبدائل، والمواد، والجداول.
- مزامنة الأوامر وأوامر الشراء بالاعتماد على سجل التغييرات.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التجهيز، والأدوات، وأعداد المشغّلين، والبدائل من الآلات أو العاملين.
- إعادة كتابة الجدول إلى النظام على دفعات، مع اختبارها باستخدام
/Validate. - الاختبار المتوازي. شغّل SkyPlanner بالتوازي مع خطة الأولويات، وقارن التواريخ وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة إلى النظام بعد تطابق البيانات.
ما ينبغي مراعاته عند التخطيط للتكامل مع Monitor ERP
- معامل الإتاحة. يستخدم Monitor معامل الإتاحة لتحويل الطاقة الإجمالية إلى طاقة صافية، وتبلغ قيمته الافتراضية في مركز العمل الجديد 80 %. طبّقه مرة واحدة فقط: إما ضمن إعداد الكفاءة في SkyPlanner أو بتقصير الورديات، وليس بكلا الأسلوبين.
- الدقة الزمنية. تُحدَّد طاقة مراكز العمل التي تستخدم Day planning كوقت أساسي يومي، من دون أوقات للورديات. اضبط الورديات الفعلية في SkyPlanner استنادًا إلى جداول الإنتاج، لتُجدول المهام ضمن ساعات العمل.
- وقت الانتظار والتداخل. تتضمن صفوف العمليات وقت الانتظار ونسبة التداخل بوحدة %. حدّد أثناء تحديد النطاق كيفية تمثيل كل منهما في SkyPlanner، وإلا ستتغير المدد اللازمة للإنتاج بعد بدء التشغيل الفعلي.
- مجموعات مراكز العمل. تُخطَّط مراكز العمل المجمّعة في Pool planning، وليس في Priority planning. اقرأ بيانات مراكز العمل المنضوية في المجموعة، لا صف المجموعة وحده.
- متطلبات الإصدار. تتطلب كتابة التواريخ المخططة عبر Update الإصدار 24.5. وتتطلب حقول طاقة مراكز العمل في API الإصدار 24.3، بينما يتطلب OIDC الإصدار 25.8. تحقّق من نسخة البرنامج قبل تحديد النطاق.
- الشبكة والشهادة. يتيح Monitor المثبّت محليًا واجهة API عبر المنفذ 8001 بشهادة موقّعة ذاتيًا. ويعمل SkyPlanner في السحابة، لذا خطّط لإعداد قاعدة في جدار الحماية أو وسيط اتصال، وأضف الشهادة صراحةً إلى الشهادات الموثوقة.
- التراخيص. يحتاج كل تطبيق خارجي يكتب البيانات إلى مستخدمي API مرخّصين خاصين به. ويأتي كل نظام مع مستخدم API واحد للقراءة فقط.
التكامل مع Monitor ERP: من يتولى إعداده ودعمه؟
يشمل العمل مطابقة البيانات مع مراكز العمل وصفوف العمليات وتدفق الأوامر لديك، إلى جانب إعداد القيود التي لا يحتفظ بها Monitor: مصفوفة أوقات التجهيز، والأدوات، وأعداد المشغّلين، والموارد البديلة.
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي، ويشمل ذلك جانب SkyPlanner واستدعاءات Monitor ERP API المتفق عليها. فلكل مصنع طريقته في استخدام Monitor G5، وهنا تأتي أهمية الخبرة بهذه التفاصيل.
- يمكن لشريك Monitor لديك المشاركة. فهو يعرف إعداداتك وإصدارك وصلاحياتك، ويمكنه تجهيز مستخدم API والترخيص والوصول عبر الشبكة. ويوفّر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وخطافات الويب.
- يمكن لمطوّريك أيضًا البناء على التكامل باستخدام واجهة REST API الموثّقة نفسها ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفر الوثائق العامة في وثائق SkyPlanner.
بعد إتمام الربط، يُجري محرك Arcturus الجدولة بالاعتماد على أوامر Monitor المحدَّثة، وتُكتب التواريخ المخططة في عمليات أوامر التصنيع. يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم لك مسبقًا عرض سعر للتكامل يناسب إجراءاتك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء. اطّلع على الأسعار، وقارن إمكانات التخطيط المدمجة في Monitor في صفحة تخطيط الإنتاج في Monitor ERP ضمن الطاقة الفعلية للآلات والعاملين، واقرأ النظرة العامة في صفحة Monitor ERP، وتعرّف على أنظمة ERP الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةتُوفَّر كل أسبوع
«نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.»
كالي كاليومّاكي، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة المهام الجديدة إلى خط الإنتاج خلال ثوانٍ.
+90%في كفاءة الإنتاج
«ارتفعت كفاءة الإنتاج بنسبة 90%.»
عبدول روسيينغا، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، وأصبح إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل يستغرق أقل من 30 دقيقة.
آلاف (1,000) من أوامر العمل تُجدول تلقائيًا
«أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وارتقى فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.»
هانو رينانن، الرئيس التنفيذي
Mamec · خلاطات ومضخات صناعية وتصنيع تعاقدي بتقنيات متقدمة
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية للإنتاج في الوقت الفعلي لجميع أقسام المؤسسة.
6 أشهريرى فريق المبيعات الطاقة الشاغرة خلالها مسبقًا
«يوفّر SkyPlanner الأساس والموثوقية لكل أعمال تخطيط الإنتاج.»
آنو يارفينن، مديرة الإنتاج
Fredman Operations · أوراق تغليف آمنة لملامسة الأغذية
يطّلع فريق المبيعات على الطاقة الشاغرة للأشهر الستة المقبلة، ويجري الرد على طلبات تغيير الجدول خلال ثوانٍ بعدما كان الرد يستغرق ساعة أو أكثر.
الأسئلة الشائعة
هل يوفّر Monitor ERP واجهة API لأوامر التصنيع؟
نعم. تتيح Monitor ERP API الاستعلام عن Manufacturing/ManufacturingOrders وManufacturingOrderNodes وManufacturingOrderOperations وManufacturingOrderMaterials. وتُعيد أوامر مثل ManufacturingOrderOperations/Update وReplanOperation كتابة التواريخ المخططة إلى النظام.
هل تتطلب الكتابة إلى Monitor عبر API ترخيصًا إضافيًا؟
نعم. القراءة عبر API مجانية لجميع عملاء Monitor. أما أوامر كتابة البيانات فتتطلب Monitor ERP API التي تبيعها Monitor. ويقدّم شريك Monitor لديك أو فريق مبيعات Monitor عرض السعر.
هل تدعم Monitor ERP API خطافات الويب؟
لا توجد خطافات ويب موثّقة. يستقصي التكامل Common/EntityChangeLogs كل بضع دقائق، ويجلب السجلات التي تغيّرت فقط. وفي الاتجاه الآخر، تُرسل خطافات الويب الخاصة بـ SkyPlanner تغييرات الجدول فور حدوثها.
ما إصدار Monitor الذي نحتاج إليه؟
تتطلب كتابة تاريخَي البدء والانتهاء المخططين عبر ManufacturingOrderOperations/Update الإصدار Monitor 24.5 أو أحدث. وتستخدم نسخ G5 الأقدم بدءًا من 2.40 الأمر ReplanOperation. نؤكد الطريقة المناسبة لنسختك أثناء تحديد النطاق.
من يتولى بناء التكامل مع Monitor ERP؟
يضبط فريق SkyPlanner التكامل ثنائي الاتجاه ليتوافق مع إعدادات Monitor G5 لديك أثناء التهيئة، ويدعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لشريك Monitor لديك أو لمطوّريك تطوير التكامل باستخدام واجهة REST API الموثّقة من SkyPlanner، ويكفي رمز API للبدء.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Monitor بصيغة Excel أو CSV، ومن دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
