عمليات التكامل / ERP / ProShop ERP
دليل تكامل ProShop ERP مع SkyPlanner APS لجدولة الإنتاج
يوضح دليل تكامل ProShop هذا للمسؤولين والاستشاريين وفرق تقنية المعلومات كيفية ربط ProShop ERP بـ SkyPlanner APS. يتكامل SkyPlanner مع ProShop في الاتجاهين عبر API الخاصة بـ ProShop:
- يستورد SkyPlanner بيانات Work Orders مع عملياتها، وParts، وسجلات Work Order BOM، وWork Cells، وUsers، وTools، وFixtures، وPurchase Orders.
- تُعاد كتابة تواريخ البدء والانتهاء المخططة في أوامر الإنتاج.
- يمكن إرسال أوقات عمل المشغّلين إلى ProShop Time Tracking إذا اخترتم ذلك.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يتوافق مع إعدادات ProShop لديكم خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطوّرين الراغبين في المشاركة أو تطوير حلول بأنفسهم باستخدام REST API الموثّقة لدى SkyPlanner (مرجع API).
واجهات التكامل في ProShop
يتيح ProShop لنظام الجدولة الخارجي مسارين، موثّقين في مستندات المطوّرين الخاصة بـ ProShop API:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (يوفّر ProShop واجهة GraphQL API متاحة عبر HTTP(S).) توجد نقطة نهاية واحدة: يُرسَل كل استدعاء كطلب HTTP POST إلى
<proshop root>/api/graphql، معqueryوvariablesوoperationNameفي جسم الطلب بتنسيق JSON. لكل وحدة استعلام بصيغة المفرد لجلب سجل واحد، واستعلام بصيغة الجمع لجلب القوائم. تُقسَّم القوائم إلى صفحات باستخدامpageSize(وقيمته الافتراضية 20) وpageStart، وتُرجعrecordsوtotalRecords. كما تقبل وسيطَيfilterوqueryالمطابقين لوظيفة Advanced Search في كل وحدة. ويمكن فحص المخطط باستخدام الاستبطان. (مقدمة إلى ProShop API) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (تتيح واجهة REST بسيطة للتكاملات الخارجية طلب معلومات بين نقطتين زمنيتين تختارونهما.) استدعوا
<proshop root>/recentlyupdatedrecordsمعstart(بتنسيق ISO 8601)، ويمكن إضافةendوfilterbyاختياريًا، مثلworkorders,workcells,purchaseorders,timetracking,deletions. يُفعّل فريق ProShop الفهرس أولًا. (واجهة Recently Updated Records API)
تتم الكتابة عبر mutations في GraphQL. والمثال الموثّق هو Time Tracking Login، وتُمنح صلاحية الكتابة لكل وحدة على حدة من خلال نطاقات الصلاحيات.
المصادقة ونطاقات الصلاحيات
- رمز وصول مع كل استدعاء. أرسلوه بصيغة
Authorization: Bearer <token>أو كمعامل استعلام باسمtoken. - OAuth 2.0 Client Credentials (في ProShop 5.2.3 والإصدارات الأحدث). يفتح مسؤول نظام ProShop المسار System Config > Manage Authorizations، وينشئ Authorization مع تحديد Name وMaximum Scope، ثم يحدّد الخيارين Direct Login وActive. تُستخدم قيمتا Unique ID وShared Secret بوصفهما
client_idوclient_secret. يرسل التطبيقgrant_type=client_credentialsبطلب POST إلى<proshop root>/home/member/oauth/accesstoken، ويحصل على رمز Bearer معexpires_in. لا يوجد رمز تحديث، لذا اطلبوا رمزًا جديدًا عند انتهاء صلاحيته. (تدفق بيانات اعتماد العميل) - OAuth 2.0 Authorization Flow للاستدعاءات التي تتطلب سياق مستخدم، مثل Time Tracking Login.
- نطاقات الصلاحيات. تُكتب بالصيغة
SCOPE_NAME:[{r|w|d|p}]للقراءة والكتابة والحذف والتفضيلات، على الترتيب. يطلب نظام الجدولة عادةًworkorders:rw parts:r purchaseorders:r users:r tools:r، إضافةً إلى Time Tracking إذا كانت الأوقات ستُرسَل إلى ProShop. ومنذ ProShop 5.1.9، “a scope grant request is now required on all connections to the API.” (أصبح طلب منح نطاق صلاحيات إلزاميًا لجميع الاتصالات بواجهة API.) (نطاقات صلاحيات التفويض) - سجل التدقيق. تُظهر الاستدعاءات التي تستخدم بيانات اعتماد العميل اسم التطبيق، لا اسم مستخدم.
من جانب SkyPlanner، تستخدم REST API رمز API للمصادقة في ترويسة Authorization-Token (SkyPlanner Settings > API)، وهي موثّقة باستخدام Swagger/OpenAPI. ويشرح الدرس التعليمي للتكامل كيفية إجراء الاستدعاءات الأولى.
الأحداث والاستطلاع الدوري
لا تذكر مستندات المطوّرين لدى ProShop أي webhooks صادرة أو اشتراكات GraphQL. تُجلَب التحديثات من ProShop بالاستقصاء الدوري، وتخفّف Recently Updated Records API عبء هذه العملية: اطلبوا كل ما أُنشئ أو عُدّل أو حُذف منذ التشغيل السابق، مع تصفية النتائج بحسب أنواع السجلات التي تحتاجها الجدولة. ثم اجلبوا أوامر الإنتاج التي تغيّرت باستخدام أرقامها عبر GraphQL؛ ويشير ProShop إلى أن ذلك أسرع من الاستعلام باستخدام lastModifiedTime.
من الخيارات المعتادة الاستقصاء كل خمس دقائق لأوامر الإنتاج وتتبع الوقت، وكل ساعة للقطع وأوامر الشراء. ويرسل SkyPlanner إشعارات webhooks عند تغيّر الحالة أو الجدول، لذا تعتمد إعادة الكتابة على الأحداث.
مطابقة البيانات
| كائن ProShop (API) | الكائن في SkyPlanner | الاتجاه | وتيرة التحديث |
|---|---|---|---|
Parts، وCOTS (نطاق parts في GraphQL) | المنتجات والمواد | ProShop → SkyPlanner | تحميل أولي، ثم عند التغيير |
| سجلات Work Order BOM | بنية المنتج والمواد الخاصة بكل أمر | ProShop → SkyPlanner | مع كل أمر إنتاج |
| عمليات أمر الإنتاج: خلية العمل، ووقتا الإعداد والدورة المقدّران (الأوقات المستهدفة) | خطوات التصنيع مع مددها وأوقات الإعداد والتفكيك | ProShop → SkyPlanner | مع كل أمر إنتاج |
| Work Cells (آلة، أو منضدة عمل، أو معدات) | محطات العمل ومجموعاتها ومعدلات كفاءتها | ProShop → SkyPlanner | التحميل الأولي، ثم نادرًا بعد ذلك |
| Work Cells المخصّصة للأفراد، وUsers | العاملون وتعيينات المشغّلين | ProShop → SkyPlanner | التحميل الأولي، ثم عند التغيير |
| جداول خلايا العمل (الساعات المتاحة والورديات) | الورديات وأيام العطلة | ProShop → SkyPlanner | يوميًا، أو إدارة الورديات في SkyPlanner |
| Work Orders (الكمية، وموعد التسليم، والحالة) | الأوامر والمهام مع مواعيد تسليمها وأولوياتها | ProShop → SkyPlanner | استقصاء كل بضع دقائق |
| Tools، وToolpots، وFixtures، وRTAs | الأدوات بوصفها موارد مشتركة محدودة | ProShop → SkyPlanner | التحميل الأولي، ثم عند التغيير |
| Purchase Orders مع مواعيد تسليمها | أوامر الشراء والمواد الواردة بحسب تاريخ التسليم | ProShop → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
موعدا البدء والانتهاء المخططان لأمر الإنتاج (عملية mutation في GraphQL، workorders:w) | موعدا البدء والانتهاء المخططان لكل مهمة | SkyPlanner → ProShop | عند تغيّر الجدول، عبر webhook من SkyPlanner |
| Time Tracking: وقتا الإعداد والتشغيل والقطع المنجزة لكل عملية في أمر الإنتاج | سجلات الوقت وتأكيدات المشغّلين | SkyPlanner → ProShop | مع كل تأكيد أو كل وردية، إذا اخترتم ذلك |
| غير موجود في ProShop | مصفوفة أوقات الإعداد، والمهام التي تتطلب عدة مشغّلين، والآلات والعاملون البدلاء | تُدار في SkyPlanner | تُضبط خلال مرحلة التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اجلبوا صفحات Parts وWork Cells وUsers وTools وFixtures باستخدام استعلامات بصيغة الجمع في GraphQL. اضبطوا pageSize على قيمة مرتفعة للتحميل الأول، وكرّروا الجلب استنادًا إلى totalRecords. حدّدوا كيفية مطابقة خلايا العمل: تُطابَق خلايا العمل التي تمثّل آلات مع محطات العمل، وتلك التي تمثّل أشخاصًا مع العاملين، بحيث يمكن للعملية نفسها حجز الآلة ومشغّلها معًا.
2. مزامنة أوامر الإنتاج. اقرأوا أوامر الإنتاج النشطة مع عملياتها وأوقاتها المستهدفة وسجلات BOM، إضافةً إلى أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عندما تُضبط حالة أمر الشراء على Delivered. تُرصد التغييرات عبر Recently Updated Records باستخدام filterby=workorders,purchaseorders,deletions.
3. إعادة كتابة الجدول في ProShop. عندما يُدرج المحرّك مهمة في الجدول أو ينقلها، يُطلِق webhook من SkyPlanner عملية mutation في GraphQL لضبط التواريخ المخططة لأمر الإنتاج، باستخدام Authorization يتضمن workorders:w. عندها تعتمد توقعات ProShop للإنجاز في الموعد وتواريخ الاحتياج للمشتريات على تواريخ SkyPlanner.
4. تأكيدات العمل في المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتحافظ سجلات الوقت على تحديث الجدول. تختارون ما إذا كانت الأوقات الفعلية ستُرسَل إلى ProShop Time Tracking وتُربط بعملية أمر الإنتاج. وإذا لم تختاروا ذلك، يواصل المشغّلون تسجيل الوقت في ProShop كما في السابق، ويقرأه SkyPlanner عبر timetracking.
5. قواعد ملكية البيانات وحل التعارضات. دوّنها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| Parts، والعمليات، والأوقات المستهدفة، والكميات، وحالة أمر الإنتاج | ProShop |
| تسلسل العمليات، وأوقات البدء والانتهاء، وتعيين الآلات والمشغّلين | SkyPlanner |
| مصفوفة أوقات التجهيز والانتقال بين المهام، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| الورديات وأيام العطلات | نظام واحد يُختار خلال تحديد النطاق |
| Time Tracking، والمخزون، والمشتريات، وحساب تكاليف المهام | ProShop؛ تُدخَل البيانات فيه أو تُرسَل إليه من سجلات الوقت في SkyPlanner |
حدّدوا نظامًا واحدًا لكتابة تواريخ أوامر الإنتاج. بمجرد أن يتولى SkyPlanner جدولة خلية عمل، يتوقف المخطّطون عن إعادة ترتيب قائمة تلك الخلية في ProShop، حتى لا تتعارض الخطتان مطلقًا.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة التهيئة. وقبل ذلك، تحقّقوا من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام خلايا العمل والعمليات وأوامر الإنتاج المفتوحة المصدَّرة من ProShop بتنسيق CSV أو Excel.
- ربط البيانات. اعتمدوا جدول الربط، وقواعد مسؤولية إدارة البيانات، ودورية المزامنة، وما إذا كانت الأوقات ستُرسَل إلى ProShop.
- الوصول إلى ProShop. ينشئ المسؤول Authorization بقيمة Maximum Scope المتفق عليها، ويطلب من فريق ProShop تفعيل Recently Updated Records.
- التحميل الأولي. تحميل Parts وWork Cells وUsers وTools وFixtures وجداول خلايا العمل.
- مزامنة أوامر الإنتاج وأوامر الشراء. استقصاء التغييرات مع تقسيم النتائج إلى صفحات وإعادة المحاولة.
- ضبط القيود في SkyPlanner. مصفوفة أوقات الإعداد، والأدوات، وعدد المشغّلين لكل عملية، والآلات أو العاملون البدلاء.
- إعادة كتابة الجدول في ProShop. تنفيذ عمليات mutations استجابةً لإشعارات webhooks من SkyPlanner، وإضافة Time Tracking إذا اخترتم ذلك.
- الاختبار بالتوازي. شغّل SkyPlanner إلى جانب جدول ProShop الحالي، وقارن المواعيد وصحّح الأزمنة المستهدفة.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة بمجرد تطابق البيانات.
ما ينبغي مراعاته عند التخطيط للتكامل مع ProShop
- الأزمنة المستهدفة تحسم كل شيء. يحسب ProShop المدة بناءً على أزمنة الإعداد والدورة المقدّرة. اجلب الأزمنة المستهدفة الحالية، لا التقدير الأصلي، وافصل وقت الإعداد عن وقت التشغيل حتى تتمكن مصفوفة أوقات الإعداد من الحلول محل قيمة الإعداد الواحدة.
- خلايا العمل التي تمثّل أفرادًا. قد تمثّل خلية العمل شخصًا. اربط هذه الخلايا بالعاملين في SkyPlanner، لا بالآلات، وإلا فسيُعامل كل مشغّل كآلة تعمل بالتوازي.
- يتطلب Time Tracking مستخدمًا. منذ أبريل 2026، ينطبق على عملية Time Tracking Login الشرط “requires user context” (تتطلب سياق مستخدم)، ولا يُسمح بتنفيذها باستخدام Client Credentials. أرسل وقت المشغّل عبر OAuth 2.0 Authorization Flow، أو واصل تسجيل الوقت في ProShop واقرأه منه.
- فعّل فهرس التغييرات. لا تعمل Recently Updated Records إلا بعد أن يفعّلها فريق ProShop. اطلب تفعيلها في الأسبوع الأول.
- سجلات ITAR. يرشّح ProShop السجلات الخاضعة لقيود ITAR بحسب كل اتصال، ويحدد خيار في Developer System Config ما إذا كانت ستُعاد بقيم null أم ستُستبعد من النتائج. اتفق على أوامر الإنتاج التي يمكن للتكامل الاطلاع عليها، وتعامل مع قيم null في كل عملية قراءة.
- التشغيل لدى جهات خارجية. تُحتسب العمليات لدى المورّدين كمدد زمنية، ولا تستهلك طاقتك الإنتاجية. مثّلها بخطوات تعتمد على الوقت فقط.
من يتولى إعداد التكامل مع ProShop ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة ويدعمه بعد بدء التشغيل الفعلي، ويشمل ذلك استعلامات GraphQL وعمليات التعديل والاستقصاء الدوري عن التغييرات المتفق عليها. لكل مصنع طريقته في استخدام ProShop، وفي هذه المرحلة تُوظَّف الخبرة بهذه الاختلافات.
- يشارك مسؤول ProShop أو الاستشاري الذي تتعامل معه. فهو ينشئ Authorization ويحدد نطاقات الصلاحيات ويطلب تفعيل فهرس التغييرات، وهو على دراية بإعداد خلايا العمل لديك.
- يمكن لمطوّريك البناء على هذا التكامل باستخدام REST API الخاصة بـ SkyPlanner ورمز API. يكفي رمز API للبدء، ويساعد فريق SkyPlanner عند الحاجة. تتوفر الوثائق في وثائق التكامل مع SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا وفقًا لعمليتك واحتياجاتك، إلى جانب باقتك. اطّلع على الأسعار، وتخطيط الإنتاج مع ProShop ضمن الطاقة الفعلية للآلات والعاملين، وصفحة ProShop ERP، وميزات SkyPlanner، ودليل التكامل مع أنظمة ERP.
آراء المصنّعين في SkyPlanner
2 ستُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة التوريد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
98%نسبة الالتزام بمواعيد التسليم، بعد أن كانت نحو 50%
“يؤدي SkyPlanner دورًا حاسمًا في الحفاظ على التزامنا بمواعيد التسليم.”
Hannu Lahtinen، المدير العام
KJH-Comp · تصنيع الأجزاء الميكانيكية من الصفائح المعدنية والتصنيع التعاقدي
ارتفعت نسبة الالتزام بمواعيد التسليم من نحو 50% إلى ما يصل إلى 98%، وأصبحت الجدولة تحتاج إلى مشرف واحد بدلًا من مشرفَين.
1,000 وما فوقمن أوامر الإنتاج تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، ووصل فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
Hannu Ryynänen، الرئيس التنفيذي
Mamec · خلاطات صناعية ومضخات وتصنيع تعاقدي عالي التقنية
تُجدول آلاف أوامر الإنتاج تلقائيًا، مع إتاحة رؤية آنية للإنتاج على مستوى المؤسسة بأكملها.
الأسئلة الشائعة
هل يوفر ProShop واجهة API؟
نعم. يوفر ProShop واجهة GraphQL API على <proshop root>/api/graphql، مع OAuth 2.0 أو Basic Authentication ونطاقات صلاحيات للوحدات. وتُعيد نقطة نهاية REST المسماة Recently Updated Records السجلات التي أُنشئت أو عُدّلت أو حُذفت خلال فترة زمنية محددة.
هل يدعم ProShop إشعارات webhooks؟
لا تصف وثائق المطوّرين الخاصة بـ ProShop أي إشعارات webhooks صادرة. يستقصي التكامل واجهة Recently Updated Records API دوريًا وفق جدول يُحدَّد لكل مصنع. أما إشعارات webhooks الخاصة بـ SkyPlanner فترسل تغييرات الجدول فور حدوثها.
كيف تُرسل المواعيد المخططة إلى ProShop لتسجيلها فيه؟
من خلال عملية تعديل GraphQL على أمر الإنتاج، باستخدام Authorization يتضمن صلاحية الكتابة على workorders. ويشغّلها SkyPlanner عبر إشعار webhook كلما تغيّر الجدول.
من ينشئ بيانات اعتماد ProShop API؟
ينشئها مسؤول نظام ProShop من System Config > Manage Authorizations. يتيح Direct Login استخدام مسار Client Credentials، ويحدد Maximum Scope ما يمكن للتكامل قراءته وكتابته.
هل ينبغي لاستشاري ProShop أن يقترح جدولة ProShop أم SkyPlanner؟
SkyPlanner، عندما يكون تسلسل الإنتاج لدى العميل هو ما يحسم التسليم. يعرض جدول ProShop الأولويات وتوقعات التسليم في الموعد لكل خلية عمل، ويتولى المخططون تعديل الأولويات. يتصل SkyPlanner عبر GraphQL API، ويحسّن الخطة بأكملها تلقائيًا، ويشمل تخطيطه تبديل إعدادات الإنتاج، إلى جانب المشغّلين والأدوات والمواد، ويتيح عددًا غير محدود من المستخدمين، بسعر يبدأ من 199 € شهريًا.
هل يمكننا اختبار SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد ملفات CSV أو Excel من ProShop، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
