دليل تكامل Fulcrum لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل التكامل هذا للمستشارين وفرق تقنية المعلومات كيفية ربط Fulcrum (Fulcrum Pro) بنظام SkyPlanner APS. يتكامل SkyPlanner مع Fulcrum في كلا الاتجاهين عبر Fulcrum Public API:
- يستورد SkyPlanner مهام الإنتاج بما تتضمنه من أصناف مطلوب تصنيعها وعمليات، إلى جانب مسارات إنتاج الأصناف ومراكز العمل والمعدات وورديات الأقسام وفترات التوقف والمخزون وأوامر الشراء.
- تُكتب البداية المخططة والنهاية المخططة ومحطة العمل في حقول مخصصة لكل عملية ضمن مهمة الإنتاج.
- تُرسل أوقات عمل المشغّلين والكميات المنجزة إلى Fulcrum في صورة مؤقتات وتحديثات للكميات.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل ليتوافق مع إعدادات Fulcrum لديكم خلال التهيئة الأولية، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للمستشارين والمطوّرين الراغبين في المشاركة، أو في تطوير حلول بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهة Fulcrum Public API
Fulcrum منتج سحابي واحد متعدد المستأجرين، لذا يستخدم جميع العملاء واجهة API نفسها. ويصفها مركز المطوّرين بأنها واجهة API عامة تتيح “REST API calls directly into your Fulcrum site.” (إجراء استدعاءات REST API مباشرة إلى موقعكم في Fulcrum).
- المواصفات. تتوفر مواصفات OpenAPI باسم “Fulcrum PublicAPI” بالإصدار v1 للتنزيل من
https://api.fulcrumpro.com/swagger/v1/swagger.json. تقترح Fulcrum استخدامها لتوليد عميل ذي أنواع بيانات محددة. وتسرد صفحة History جميع التغييرات مع تواريخها. - الخوادم المضيفة. تستخدم المواقع القياسية
https://api.fulcrumpro.com. أما مواقع ITAR فتستخدمapi.fulcrumpro.us، وتتلقى الرموز الخاصة بها استجابة 401 عند استخدامها مع المضيف .com. - أسلوب الاستخدام. تُجلب القوائم بطلبات
POST .../listمع معايير التصفية في جسم الطلب، ويُستخدمSkipوTakeلتقسيم النتائج إلى صفحات، وSort.Field/Sort.Dirلترتيبها. تقبل كائنات عديدة طلبات PUT، وتقبل المهام أيضًا JSON Patch.
نقاط النهاية التي يستخدمها تكامل الجدولة:
| المجال | نقاط النهاية |
|---|---|
| الأصناف ومسارات الإنتاج | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| إعداد صالة الإنتاج | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| مهام الإنتاج | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| المواد | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| صالة الإنتاج | /api/job-tracking-timers/start و/stop، /api/timers، .../operations/{operationId}/add-quantity-completed، .../complete |
توضح صفحة التكاملات لدى Fulcrum طبيعة العمل بصراحة: “Every system is a little bit different and requires some configuration.” (لكل نظام اختلافاته ويحتاج إلى بعض الضبط). وهذا الضبط تحديدًا هو ما يتولاه فريق SkyPlanner خلال التهيئة الأولية.
المصادقة
يستخدم Fulcrum رمز Bearer في ترويسة Authorization. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.” (يمكن إنشاء رمز API عام داخل موقعكم في Fulcrum عبر Business Setup -> System Data -> Public Api). لكل رمز اسم ووصف وتاريخ انتهاء صلاحية. يمكنكم إنشاء ما تحتاجون إليه من رموز، وإلغاء أي رمز بحذفه. خصّصوا رمزًا مستقلًا لتكامل SkyPlanner، واضبطوا تذكيرًا قبل انتهاء صلاحيته.
أما في SkyPlanner، فتستخدم REST API رمز API في ترويسة Authorization-Token للمصادقة (SkyPlanner Settings > API)، وهي موثّقة بصيغة Swagger/OpenAPI. يشرح الدرس التطبيقي للتكامل كيفية إجراء الاستدعاءات الأولى.
الأحداث والاستقصاء الدوري
يدعم Fulcrum إشعارات webhook التي يضبطها مسؤول النظام. منذ سبتمبر 2026، تُعلّق إشعارات webhook التي تفشل ويُعاد اختبارها يوميًا، بدلًا من إعادة المحاولة بلا نهاية. ويسرد سجل تغييرات API أحداثًا مثل PurchaseOrderUpdated وItemUpdated.
يقرأ التكامل بيانات Fulcrum على النحو التالي:
- تُستقصى المهام المفتوحة كل بضع دقائق، مع تصفيتها حسب الحالتين
scheduledوinProgressوتطبيقhasIncompleteOperations: true. وهذه هي معايير التصفية التي توصي بها Fulcrum نفسها لمطابقة صفحة الجدولة لديها. - تُقرأ أوامر الشراء والمخزون قبل كل تشغيل للجدولة، أو عند ورود إشعار webhook من نوع
PurchaseOrderUpdatedإذا كان قد جرى إعداده. - تُقرأ الأصناف ومسارات الإنتاج والمعدات والورديات عند حدوث تغيير، أو كل ليلة.
في الاتجاه الآخر، ترسل إشعارات webhook الخاصة بـ SkyPlanner تغييرات الجدول فور حدوثها، لذا يعتمد إرسال البيانات إلى Fulcrum على الأحداث.
مطابقة البيانات
| كائن Fulcrum (نقطة النهاية) | كائن SkyPlanner | الاتجاه | وتيرة المزامنة |
|---|---|---|---|
Item، Materials (/api/items، /api/materials) | المنتجات والمواد | Fulcrum → SkyPlanner | تحميل أولي، ثم كل ليلة |
الأصناف والمواد الداخلة في مسار الإنتاج (/routing/input-items، /input-materials) | بنية المنتج، المنتجات الفرعية، مواد كل منتج | Fulcrum → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
عمليات مسار الإنتاج (/routing/operations): setupTime، laborTime، machineTime (ثابت أو لكل وحدة)، selectedEquipmentIds | خطوات التصنيع، أوقات الإعداد، المدد، محطات العمل المسموح بها | Fulcrum → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
Work Center (/api/work-centers) | مجموعة محطات عمل | Fulcrum → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
Equipment (/api/equipment): unlimitedCapacity، canRunUnattended، status | محطات العمل، مهام الدُفعات، التشغيل دون مراقبة | Fulcrum → SkyPlanner | تحميل أولي، وتحديث يومي للحالة |
Department Shifts (/api/department-shifts)، Equipment Downtimes | الورديات وفترات الغياب | Fulcrum → SkyPlanner | تحميل أولي، ثم يوميًا |
Job وعملياته (/api/jobs، .../items-to-make/{id}/operations): priority، productionDueDate، earliestStartDate، التقديرات | الطلبات ومهام الإنتاج | Fulcrum → SkyPlanner | استقصاء كل بضع دقائق |
| Inventory، Purchase Orders مع تواريخ Expected Receive | المخزون والمواد الواردة | Fulcrum → SkyPlanner | قبل كل تشغيل للجدولة |
حقل customFields لعملية ضمن المهمة (POST .../operations/{operationId}) | البداية المخططة، النهاية المخططة، محطة العمل | SkyPlanner → Fulcrum | عند تغيّر الجدول، عبر إشعار webhook من SkyPlanner |
حقل customFields للمهمة (PUT /api/jobs/{jobId}/custom-fields) | موعد انتهاء المهمة المخطط | SkyPlanner → Fulcrum | عند تغيّر الجدول |
مؤقتات تتبّع المهام، /api/timers، add-quantity-completed، complete | سجلات الوقت، الكميات المنجزة وكميات الهالك | SkyPlanner → Fulcrum | أثناء تسجيل المشغّلين للعمل |
| غير موجودة في Fulcrum | المشغّلون بأسمائهم، مصفوفة أوقات الإعداد، الأدوات ذات العدد المحدود، محطات العمل البديلة | تُدار في SkyPlanner | تُعدّ خلال التهيئة الأولية |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. تُجلب الأصناف والمواد ومسارات الإنتاج ومراكز العمل والمعدات، ثم ورديات الأقسام وفترات التوقف. يُحوَّل كل مركز عمل في Fulcrum إلى مجموعة محطات عمل في SkyPlanner تضم معداته، وتُعتمد المعدات المحددة لكل عملية في مسار الإنتاج بوصفها محطات العمل المسموح بها لتلك العملية. أما المعدات ذات إعداد Unlimited Capacity، مثل الأفران وكبائن الطلاء، فتُمثَّل بمهام دُفعات.
2. مزامنة الطلبات. تُقرأ المهام المفتوحة بما تتضمنه من أصناف مطلوب تصنيعها وعمليات، إلى جانب أوامر الشراء المفتوحة والمخزون. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عندما تُضبط حالة أمر الشراء على Delivered. وتتحقق الجدولة من المخزون والمشتريات الواردة عند كل إعادة تخطيط.
3. إرسال بيانات الجدول إلى Fulcrum. يحسب Fulcrum بنفسه قيم scheduledStartUtc وscheduledEndUtc وscheduledEquipmentId ويُرجعها للقراءة فقط. ويقبل تحديث العملية الحقل customFields. يكتب SkyPlanner البداية المخططة والنهاية المخططة ومحطة العمل في حقول مخصصة لكل عملية ضمن المهمة، ويكتب موعد الانتهاء المخطط في حقل مخصص للمهمة. وبذلك يرى فريقا المبيعات والمشتريات تواريخ SkyPlanner ضمن المهمة في Fulcrum.
4. تأكيدات صالة الإنتاج. يسجّل المشغّلون العمل في SkyPlanner باستخدام Mobile Confirmations أو Production Timer أو Quick Log Mode. ويرسل SkyPlanner الوقت إلى Fulcrum عبر /api/job-tracking-timers/start و/stop، أو كفترة عمل مكتملة عبر /api/timers. وتُرسل الكميات عبر add-quantity-completed، والكمية النهائية بما فيها الهالك عبر complete. وهكذا تبقى تكلفة المهام في Fulcrum محدّثة لحظة بلحظة.
5. قواعد المسؤولية وتعارض البيانات. أداة الجدولة في Fulcrum “dictates the order of operations in Job Tracking.” (تحدّد ترتيب العمليات في Job Tracking). لذا اختر قناة واحدة لإسناد العمل لكل عملية: قائمة انتظار المشغّل في SkyPlanner أو Fulcrum Job Tracking. دوّن القواعد قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، ومسارات الإنتاج، والتقديرات، والمخزون، والمشتريات، وحساب التكاليف | Fulcrum |
| تسلسل العمليات، وأوقات البدء والانتهاء، وتعيين محطات العمل | SkyPlanner |
| المشغّلون، ومصفوفة أوقات التهيئة، والأدوات، والموارد البديلة | SkyPlanner |
| الورديات وفترات التوقف | نظام واحد يُختار أثناء تحديد النطاق |
| الوقت المسجّل والكميات المنجزة | SkyPlanner، مع إرسال البيانات إلى Fulcrum |
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك في التجربة المجانية لمدة 30 يومًا. صدّر الأصناف ومسارات الإنتاج والمهام المفتوحة من جداول Fulcrum إلى CSV، ثم استوردها وتحقّق من صحة الجدول.
يشمل المشروع نفسه ما يلي:
- الرمز والنطاق. أنشئ رمزًا لـ Public API واتفق على الحقول المخصّصة لإرسال البيانات إلى Fulcrum.
- مطابقة البيانات. اعتمد جدول المطابقة وقواعد المسؤولية وقناة إسناد العمل.
- التحميل الأولي. الأصناف، والمواد، ومسارات الإنتاج، ومراكز العمل، والمعدات، والورديات، وفترات التوقف.
- مزامنة الطلبات وأوامر الشراء. استقصاء تغييرات المهام بشكل تزايدي، إلى جانب أوامر الشراء والمخزون.
- إعداد القيود في SkyPlanner. المشغّلون ووردياتهم، ومصفوفة أوقات التهيئة، والأدوات، ومحطات العمل البديلة.
- إرسال البيانات إلى Fulcrum. الحقول المخصّصة في عمليات المهام وفي المهام نفسها.
- إرسال بيانات صالة الإنتاج. إرسال بيانات المؤقّتات والكميات إلى Fulcrum.
- الاختبار بالتوازي وبدء التشغيل الفعلي. شغّل SkyPlanner بالتوازي مع جدول Fulcrum، وقارن المواعيد، وصحّح البيانات الرئيسية، ثم حوّل إسناد العمل إلى القناة الجديدة.
ما يجب مراعاته عند التخطيط للتكامل مع Fulcrum
- تُمثَّل العمالة بأعداد العاملين في الورديات. إعداد Max Equipment لكل وردية في Fulcrum “is usually determined by how many people you have working in a certain area at that time.” (يتحدّد عادةً بحسب عدد العاملين في منطقة معيّنة في ذلك الوقت). ويُعدّ المشغّلون بأسمائهم ووردياتهم في SkyPlanner. ويمكن الحصول على الأسماء من بيانات المستخدمين في
/api/users. - تُسند الأعمال إلى المعدات عند الجدولة. مراكز العمل في Fulcrum هي مجموعات من المعدات التي يمكن أن يحلّ بعضها محلّ بعض. احرص على دقة اختيار المعدات في مسار الإنتاج، لأنها تصبح البدائل التي يختار المحرّك من بينها.
- أوامر الإنتاج تجمع المهام. يجمع أمر الإنتاج عمليات من عدة مهام، مثل عمليات مخطّط تعشيق. وعند تشغيل مؤقّت لعملية ضمن مجموعة، يبدأ مؤقّت أمر الإنتاج بدلًا منه، ويشمل كل عمليات المهام في المجموعة.
- قيود المؤقّتات. الفترات المسجّلة بأثر رجعي عبر
/api/timers“may not be in the future, older than 30 days, or longer than 7 days.” (لا يجوز أن تقع في المستقبل أو تتجاوز الحدّين المذكورين لعمر السجل ومدته). أرسل الوقت فور تسجيل المشغّلين له. - تختلف صيغ الوقت. تستخدم الورديات قيم HHmm بالتوقيت المحلي، بينما تستخدم فترات التوقف والمواعيد المجدولة توقيت UTC، وتَرِد المدد التقديرية للعمليات بالثواني.
- تحديث المعدات يستبدل السجل بالكامل. يمسح طلب PUT الخاص بالمعدات أي حقل لا يتضمّنه. ويقرأ SkyPlanner بيانات المعدات ولا يكتبها مطلقًا.
- المواقع الخاضعة لـ ITAR. استخدم المضيف
.usورمز ITAR.
التكامل مع Fulcrum: من يتولّى الإعداد والدعم؟
يشمل العمل مطابقة أقسامك ومراكز العمل والمعدات ومسارات الإنتاج بين النظامين، إلى جانب إعداد القيود التي لا يحتفظ بها Fulcrum: المشغّلون بأسمائهم، ومصفوفة أوقات التهيئة، والأدوات، والموارد البديلة.
- يتولّى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. لكل مصنع طريقته في استخدام Fulcrum، وهذه هي المرحلة التي تُوظَّف فيها الخبرة بتلك الطريقة.
- يمكن لمستشارك في Fulcrum أو شريك التكامل بناء هذا التكامل. يوفّر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وخطّافات الويب.
- يمكن لمطوّريك أيضًا البناء عليه. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفّر وثائق المنتج، بما فيها أوامر الشراء وواجهة API للمنتجات والمواد، في وثائق SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مسبقًا وفقًا لعملياتك واحتياجاتك، مع باقة اشتراكك، لتعرف التكلفة الكاملة قبل البدء. اطّلع على الأسعار والميزات، وقارن بأداة الجدولة المدمجة في Fulcrum في صفحة تخطيط الإنتاج في Fulcrum ضمن الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة في صفحة Fulcrum، وأنظمة ERP الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةمن الوقت الموفّر أسبوعيًا
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج ساعتين (2) من وقت العمل أسبوعيًا، وتصل قائمة العمل الجديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · صناعة الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
99.2%نسبة الالتزام بمواعيد التسليم
“أتاح لنا SkyPlanner رؤية واضحة لتحديد الاختناقات، وجعل إدارة الإنتاج أكثر وضوحًا.”
Toni Tuori، مدير الإنتاج
Piristeel · أنظمة السلامة على الأسطح وتصريف مياه الأمطار
بلغت نسبة الالتزام بمواعيد التسليم 99.2% هذا العام، وتوفّر الجدولة ما يصل إلى أربع ساعات من وقت العمل يوميًا.
98%نسبة الالتزام بمواعيد التسليم، ارتفاعًا من نحو 50%
“يؤدي SkyPlanner دورًا حاسمًا في الحفاظ على التزامنا بمواعيد التسليم.”
Hannu Lahtinen، المدير العام
KJH-Comp · تصنيع مكوّنات الصفائح المعدنية والتصنيع التعاقدي
ارتفعت نسبة الالتزام بمواعيد التسليم من نحو 50% لتصل إلى 98%، وأصبحت الجدولة تحتاج إلى مشرف واحد بدلًا من مشرفين اثنين.
الأسئلة الشائعة
هل يوفّر Fulcrum واجهة API؟
نعم. Fulcrum Public API هي واجهة REST API بمواصفة OpenAPI v1. وتستخدم للمصادقة رمز Bearer يُنشأ من Business Setup > System Data > Public Api. أما المواقع الخاضعة لـ ITAR فتستخدم مضيفًا منفصلًا على .us.
هل يستطيع SkyPlanner تسجيل الجدول في Fulcrum؟
نعم. يحتفظ Fulcrum بمواعيده المجدولة للقراءة فقط، لذا يكتب SkyPlanner موعدَي البدء والانتهاء المخطّط لهما ومحطة العمل في حقول مخصّصة لكل عملية ضمن المهمة، ويكتب موعد الانتهاء المخطّط له في المهمة نفسها. ويُعاد إرسال وقت المشغّلين والكميات المنجزة في صورة بيانات مؤقّتات وتحديثات للكميات.
هل يرسل Fulcrum التغييرات فور حدوثها؟
يوفّر Fulcrum خطّافات ويب يضبطها المسؤول، مع أحداث مثل PurchaseOrderUpdated. ويجري استقصاء المهام المفتوحة كل بضع دقائق باستخدام عامل التصفية نفسه الذي يستخدمه Fulcrum لصفحة الجدولة. أما خطّافات الويب الخاصة بـ SkyPlanner فترسل تغييرات الجدول فور حدوثها.
من يبني التكامل مع Fulcrum؟
يتولّى فريق SkyPlanner إعداد التكامل ثنائي الاتجاه أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لمستشارك في Fulcrum أو شريك تكامل أو مطوّريك بناء التكامل باستخدام واجهة REST API الموثّقة من SkyPlanner.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد ملفات CSV من Fulcrum، ولا تحتاج إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
