دليل تكامل MRPeasy لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل MRPeasy هذا للمستشارين وفرق تقنية المعلومات كيفية ربط MRPeasy بـ SkyPlanner APS. يتكامل SkyPlanner مع MRPeasy في الاتجاهين عبر REST API الخاصة بـ MRPeasy:
- تُستورد أوامر التصنيع ومسارات الإنتاج وقوائم المواد (BOMs) ومجموعات محطات العمل ومحطات العمل والأصناف والمخزون وأوامر الشراء.
- تُكتب المواعيد المخططة وتقدم التنفيذ مجددًا في كل Manufacturing Order.
- ترسل خطافات الويب في SkyPlanner تغييرات الجدول فور حدوثها.
سبق ربط SkyPlanner بـ MRPeasy في مشاريع لعملاء. يضبط فريق SkyPlanner التكامل بما يتوافق مع إعدادات MRPeasy لديك خلال مرحلة التهيئة، ويقدم الدعم بعد بدء التشغيل الفعلي. هذا الدليل موجه للمستشارين والمطورين الراغبين في المشاركة، أو في تطوير حلول بأنفسهم باستخدام REST API الموثقة الخاصة بـ SkyPlanner (مرجع API).
REST API الخاصة بـ MRPeasy: الإصداران v1 وv2
MRPeasy منتج سحابي موحد، ولا تتوفر منه إصدارات للتثبيت المحلي، لذا يستخدم جميع العملاء API نفسها. ويتوفر إصداران:
- REST API v1 (OpenAPI 1.0، الخادم
https://api.mrpeasy.com/rest/v1) هي API المستخدمة في بيئة التشغيل الفعلي. وتشمل/itemsو/bomsو/routingsو/manufacturing-ordersو/work-centersو/work-center-typesو/customer-ordersو/purchase-ordersو/stock/inventoryو/lotsو/units، إضافة إلى تقارير الإنتاج مثل/report/production/operations. - REST API v2 (OpenAPI 2.0.0، الخادم
https://api.mrpeasy.com/rest/v2) لا تزال في مراحل التطوير المبكرة. وتضيف/workstation-groupsمعwork_hoursوholidays، و/workstationsمعproductivityوidle، و/inventoryو/stock-movement، وطريقة PATCH. وتبقى أوامر التصنيع على v1.
انتبه إلى اختلاف التسميات. تقابل Workstation group في واجهة MRPeasy التسمية work-center-types في v1 (type_id). وتقابل Workstation التسمية work-centers (center_id). وتشير عمليات مسار الإنتاج إلى مجموعة عبر type_id، لا إلى آلة.
تتوفر API ضمن باقة Unlimited من MRPeasy للحسابات المدفوعة. وتذكر MRPeasy أيضًا: “Our Support Department cannot help you using the API.” (لا يستطيع قسم الدعم لدينا مساعدتك في استخدام API). لذلك لا بد من جهة تتولى مسؤولية التكامل: SkyPlanner، أو مستشارك في MRPeasy، أو المطور لديك. وهذه هي المهمة التي يتولاها فريق SkyPlanner خلال مرحلة التهيئة.
المصادقة والحدود
يستخدم MRPeasy مصادقة HTTP Basic: Authorization: Basic base64(api-key:api-secret). يُنشأ المفتاح والمفتاح السري من Settings → Integration → API access. ويؤدي مسح المفتاح إلى تعطيل API.
تحدد الحدود التالية كيفية تصميم المزامنة:
- يُسمح لكل عميل بطلب واحد فقط في الوقت نفسه؛ وتُعالَج الطلبات بالتتابع.
- الحد الأقصى هو 100 طلب كل 10 ثوانٍ. عند تجاوزه، تُرجع API الرمز 429.
- تُرجع القوائم 100 سجل افتراضيًا، وما يصل إلى 1,000 سجل باستخدام ترويسة
Range. وتعرض ترويسةContent-Rangeفي الاستجابة العدد الإجمالي.
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثقة في Swagger/OpenAPI. ويشرح الدليل التطبيقي للتكامل خطوات إجراء الاستدعاءات الأولى.
الأحداث والاستطلاع الدوري
تدرج صفحة أسعار MRPeasy العبارة “API, webhooks (for paid accounts)” (API وخطافات الويب للحسابات المدفوعة)، لكن مواصفات v1 وv2 لا توثق أي أحداث لخطافات الويب تخص أوامر التصنيع. لذلك يستطلع التكامل MRPeasy دوريًا لجلب التغييرات فقط:
- أوامر التصنيع بعد تصفيتها حسب الحالات: Not scheduled (15)، وScheduled (20)، وIn progress (30)، وPaused (35).
- أوامر الشراء والمخزون وفق مواعيد محددة، أو قبل كل تشغيل للجدولة.
- البيانات الرئيسية عند تغييرها، أو كل ليلة.
يبقى الاستطلاع المتتابع مع تصفية النتائج أقل بكثير من حد 100 طلب كل 10 ثوانٍ. وفي الاتجاه المقابل، ترسل خطافات الويب الخاصة بـ SkyPlanner تغييرات الجدول فور حدوثها، فتتم إعادة الكتابة استجابةً للأحداث.
مواءمة البيانات
| كائن MRPeasy (نقطة النهاية) | كائن SkyPlanner | الاتجاه | التواتر |
|---|---|---|---|
Item، Unit of measurement (/items، /units) | المنتجات والمواد | MRPeasy → SkyPlanner | استيراد أولي، ثم كل ليلة |
قائمة المواد BOM بمكوناتها (/boms) | بنية المنتج، المنتجات الفرعية، مواد كل منتج | MRPeasy → SkyPlanner | استيراد أولي، ثم عند التغيير |
عمليات مسار الإنتاج (/routings): type_id، fixed_time، variable_time، variable_quantity | خطوات التصنيع مع مددها، وأوقات التهيئة، وحجم الدفعة | MRPeasy → SkyPlanner | استيراد أولي، ثم عند التغيير |
Workstation group (/work-center-types؛ وفي v2: /workstation-groups) | مجموعات محطات العمل، الورديات | MRPeasy → SkyPlanner | استيراد أولي، ثم نادرًا |
Workstation (/work-centers؛ وفي v2: /workstations: productivity، idle) | محطات العمل، معدلات الكفاءة، فترات عدم التوفر | MRPeasy → SkyPlanner | استيراد أولي، وتحديث يومي لفترات التوقف |
Manufacturing Order مع عملياته وdue_date (/manufacturing-orders) | الأوامر ومهام الإنتاج | MRPeasy → SkyPlanner | استطلاع كل بضع دقائق |
Inventory، Stock lots (/stock/inventory، /lots) | أرصدة المخزون | MRPeasy → SkyPlanner | كل ساعة أو مع كل تشغيل للجدولة |
Purchase Order (/purchase-orders) | المواد الواردة مع تاريخ التسليم المتوقع | MRPeasy → SkyPlanner | كل ساعة أو مع كل تشغيل للجدولة |
حقل due_date وحقول custom_<id> في Manufacturing Order (PUT /manufacturing-orders/{id}) | البداية المخططة، النهاية المخططة، تقدم التنفيذ | SkyPlanner → MRPeasy | عند تغير الجدول، عبر خطاف ويب من SkyPlanner |
| غير متوفر في MRPeasy | مصفوفة أوقات التهيئة، الأدوات بوصفها موارد محدودة، أعداد المشغلين، محطات العمل البديلة | تُدار في SkyPlanner | تُضبط خلال مرحلة التهيئة |
أنماط التكامل
1. الاستيراد الأولي للبيانات الرئيسية. اجلب الأصناف والوحدات وقوائم المواد (BOMs) ومسارات الإنتاج من v1، ومجموعات محطات العمل ومحطات العمل من v1 أو v2. اجلب تقاويم العمل من /workstation-groups في v2 (work_hours، holidays)، أو اضبط الورديات مباشرةً في SkyPlanner. اربط كل مجموعة من نوع Active processing بمجموعة محطات عمل في SkyPlanner، وأدرج محطاتها ضمن تلك المجموعة.
2. مزامنة الأوامر. اقرأ أوامر التصنيع المفتوحة مع عملياتها، إلى جانب أوامر الشراء المفتوحة والمخزون. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عندما تُضبط حالة أمر الشراء على Delivered. وتتحقق الجدولة من المخزون والمشتريات الواردة عند كل إعادة تخطيط.
3. إعادة كتابة بيانات الجدول. يدعم PUT /manufacturing-orders/{id} الحقول code وquantity وdue_date وassigned_id، إضافة إلى الحقول المخصصة بصيغة custom_<id>. يكتب SkyPlanner النهاية المخططة في due_date إذا كان ذلك متفقًا عليه، ويكتب البداية المخططة والنهاية المخططة وتقدم التنفيذ في حقول MRPeasy المخصصة. وبذلك يطّلع فريقا المبيعات والمشتريات في MRPeasy على الجدول الفعلي. ويحتفظ SkyPlanner بتسلسل العمليات التفصيلي ومحطة العمل لكل عملية، وهو الواجهة المستخدمة لتوزيع العمل في أرضية المصنع.
4. الأوامر المنشأة خارج MRPeasy. إذا أُنشئت أوامر عبر API، فإن POST /manufacturing-orders يقبل no_scheduling وno_bookings. استخدمهما حتى لا يحجز MRPeasy محطات العمل التي يتولى SkyPlanner جدولتها بالفعل.
5. تأكيدات التنفيذ في أرضية المصنع. يسجل المشغلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer أو Quick Log Mode، وتحافظ سجلات الوقت على تحديث الجدول. اختر قناة واحدة لتسجيل التنفيذ. فتشغيل Internet-kiosk من MRPeasy وSkyPlanner بالتوازي للعمليات نفسها ينتج سجلين مختلفين للواقع نفسه.
6. قواعد المسؤولية ومعالجة التعارضات. وثّقها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، قوائم المواد (BOMs)، مسارات الإنتاج، الكميات، المخزون، المشتريات | MRPeasy |
| تسلسل العمليات، أوقات البدء والانتهاء، تعيين محطات العمل | SkyPlanner |
| مصفوفة أوقات التهيئة، الأدوات، أعداد المشغلين، الموارد البديلة | SkyPlanner |
| الورديات وحالات الغياب | نظام واحد يُختار أثناء تحديد النطاق |
| تقدم تنفيذ الأوامر والعمل المسجل | SkyPlanner، مع عرض ملخص في Manufacturing Order |
سير عمل الهندسة حسب الطلب. في أحد مشاريع MRPeasy المنفّذة، يتحول كل مشروع عميل إلى منتج رئيسي ومن منتج واحد إلى ثلاثة منتجات نصف مصنّعة. ولكل منها قائمة مواد ومسار إنتاج خاصان به في MRPeasy، ويُسجَّل أمر التصنيع في كلا النظامين. احتفظ بمعرّف مشترك وثابت لكل أمر حتى لا تؤدي التحديثات إلى إنشاء أوامر مكررة.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك الخاصة في التجربة المجانية لمدة 30 يومًا، أيًا كانت باقة MRPeasy التي تستخدمها. صدّر الأصناف وقوائم المواد ومسارات الإنتاج ومحطات العمل وأوامر التصنيع المفتوحة من عروض القوائم في MRPeasy إلى ملفات CSV، ثم استوردها وتحقق من صحة الجدول.
يشمل المشروع نفسه ما يلي:
- التحقق من الباقة. تأكد من أن باقة MRPeasy تشمل API، وأنشئ مفتاح API والمفتاح السري.
- مطابقة البيانات. اعتمد جدول المطابقة وقواعد ملكية البيانات والحقول المخصصة لإعادة الكتابة وقناة الإبلاغ.
- التحميل الأولي. الأصناف والوحدات وقوائم المواد ومسارات الإنتاج ومجموعات محطات العمل ومحطات العمل والتقويمات.
- مزامنة الأوامر وأوامر الشراء. استقصاء التغييرات حسب الحالة، مع معالجة الاستجابة 429.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التهيئة والأدوات وأعداد المشغّلين ومحطات العمل البديلة.
- إعادة الكتابة. تواريخ الاستحقاق والحقول المخصصة في كل Manufacturing Order.
- الاختبار بالتوازي. شغّل SkyPlanner بالتوازي مع جدول الإنتاج الحالي، وقارن التواريخ وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة بعد تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع MRPeasy
- تختلف حقول الوقت بين الواجهات. تقابل حقول Setup time وCycle time وCapacity في واجهة المستخدم الحقول
fixed_timeوvariable_timeوvariable_quantityفي API، على الترتيب. إذا تجاوزت قيمة Capacity العدد 1، فهذا يعني المعالجة على دفعات، كما في الأفران. طابقها مع مهمة لمعالجة دفعة، لا مع دورة أطول. - مجموعات Passive processing. تعمل مجموعات التجفيف والتبريد على مدار 24/7 دون حدود للطاقة الاستيعابية. طابقها مع أوقات انتظار، لا مع محطات عمل ذات طاقة استيعابية محدودة.
- التقويمات غير متوفرة في v1. لا يُرجع
work-centersسوىcenter_idوtype_idوcodeوtitle. استخدم v2 أو أدِر الورديات في SkyPlanner. - وقت التوقف. تتضمن بيانات وقت توقف محطة العمل فترات الصيانة والتعطل. زامن هذه البيانات، وإلا فسيُسند SkyPlanner العمل إلى آلة متوقفة.
- تشير مسارات الإنتاج إلى مجموعات. يختار MRPeasy الآلة الأكثر توافرًا. وفي SkyPlanner، تصبح محطات العمل التابعة للمجموعة بدائل فعلية يختار المحرك من بينها.
التكامل مع MRPeasy: من يتولى الإعداد والدعم؟
يشمل العمل مطابقة مسارات الإنتاج ومجموعات محطات العمل وسير الأوامر، إلى جانب إعداد القيود التي لا يحتفظ بها MRPeasy: مصفوفة أوقات التهيئة والأدوات وأعداد المشغّلين والموارد البديلة.
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. تختلف طريقة استخدام MRPeasy من مصنع إلى آخر، وهنا يأتي دور هذه الخبرة. ولأن دعم MRPeasy لا يشمل العمل على API، فمن المهم أن يتولى فريق واحد مسؤولية التكامل.
- يمكن لمستشارك في MRPeasy أو شريك التكامل بناء التكامل. في أحد مشاريع MRPeasy المنفّذة، ربط شريك تكامل النظامين باستخدام REST API الخاص بكل منهما. ويوفر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وwebhooks.
- يمكن لمطوّريك تطوير التكامل باستخدام رمز API. يكفي رمز API للبدء، ويقدم فريق SkyPlanner المساعدة عند الحاجة. تتوفر وثائق المنتج، بما فيها أوامر الشراء وواجهة API للمنتجات والمواد، في وثائق SkyPlanner.
تبدأ أسعار SkyPlanner من 199 € شهريًا، وتشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مسبقًا وفقًا لعملياتك واحتياجاتك، إلى جانب سعر الباقة، لتعرف التكلفة الكاملة قبل البدء. اطّلع على الأسعار والميزات، وقارن أداة الجدولة الخاصة بـ MRPeasy في صفحة تخطيط الإنتاج في MRPeasy ضمن الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة في صفحة MRPeasy، وأنظمة ERP الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ستُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
6 أشهريرى فريق المبيعات الطاقة المتاحة خلالها مسبقًا
“يوفّر SkyPlanner أساسًا موثوقًا لتخطيط الإنتاج كله.”
Anu Järvinen، مديرة الإنتاج
Fredman Operations · أوراق تغليف آمنة لملامسة الأغذية
يستطيع فريق المبيعات الاطّلاع على الطاقة المتاحة للأشهر الستة المقبلة، وتُجاب طلبات تغيير الجدول في ثوانٍ بعدما كانت تستغرق ساعة أو أكثر.
الأسئلة الشائعة
هل يوفر MRPeasy واجهة API، وما الباقة التي أحتاج إليها؟
نعم. يوفر MRPeasy واجهة REST API للحسابات المدفوعة على باقة Unlimited؛ الإصدار v1 قيد الاستخدام الفعلي، والإصدار v2 قيد التطوير. تتم المصادقة عبر HTTP Basic باستخدام مفتاح API ومفتاح سري من Settings → Integration → API access.
هل يستطيع SkyPlanner تحديث الجدول في MRPeasy؟
نعم. يُحدّث SkyPlanner كل Manufacturing Order عبر PUT /manufacturing-orders/{id}، ويكتب تاريخ الاستحقاق والحقول المخصصة للبداية المخططة والنهاية المخططة والتقدم. ويبقى تسلسل العمليات التفصيلي في SkyPlanner، حيث يعمل المشغّلون وفق قوائم المهام الخاصة بهم.
هل يرسل MRPeasy التغييرات فور حدوثها؟
لا تذكر مواصفات API أي أحداث webhook تخص أوامر التصنيع، لذا يستقصي SkyPlanner الأوامر المفتوحة حسب الحالة كل بضع دقائق. أما webhooks الخاصة بـ SkyPlanner فترسل تغييرات الجدول فور حدوثها.
من يبني التكامل مع MRPeasy؟
يتولى فريق SkyPlanner إعداد التكامل ثنائي الاتجاه أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لمستشارك في MRPeasy أو شريك تكامل أو مطوّريك بناء التكامل باستخدام واجهة REST API الموثّقة من SkyPlanner.
هل يمكننا اختبار SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد ملفات CSV من MRPeasy، أيًا كانت باقة MRPeasy، ودون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع فريق المبيعات لتحديد نطاق التكامل.
