دليل تكامل Sage 200 لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Sage 200 هذا لشركاء الأعمال وفرق تقنية المعلومات كيفية ربط Sage 200 Professional وإضافة التصنيع الخاصة به مع SkyPlanner APS. يتكامل SkyPlanner مع Sage 200 في كلا الاتجاهين:
- تُستورد بيانات المنتجات وأرصدة المستودعات وأوامر الشراء وأوامر البيع عبر Sage 200 REST API.
- تُستورد أوامر الإنتاج والعمليات وموارد العمالة والآلات من إضافة التصنيع لديك.
- تُعاد مواعيد العمليات المخططة إلى أوامر الإنتاج.
- تُعاد سجلات أوقات المشغّلين لتسجيل الوقت على كل عملية.
يضبط فريق SkyPlanner التكامل ليتوافق مع إعدادات Sage 200 لديك خلال مرحلة التهيئة، ويقدم الدعم له بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطورين الراغبين في المشاركة أو في تطوير التكامل بأنفسهم بالاعتماد على REST API الموثّقة لدى SkyPlanner (مرجع API).
مصدران داخل نظام Sage 200 واحد
تتكون بيئة Sage 200 في المنشأة الصناعية من طبقتين، ويقرأ التكامل البيانات من كلتيهما.
1. Sage 200 REST API للبيانات التجارية وبيانات المخزون. تقول Sage إن الواجهة “lets your application read and modify data in a Sage 200 site” (تتيح لتطبيقك قراءة البيانات وتعديلها في بيئة النظام). ويشمل ذلك العملاء والموردين والمنتجات وأوامر البيع والشراء وحسابات الأستاذ العام. يصنّف مرجع Sage 200 Professional (2025.02) موارد الواجهة ضمن Cash Book وCommercials وFinancials وGeneral وNominal وPOP وPrice Book وPurchases وSales وSOP وStock. وفيما يلي الموارد المهمة للجدولة:
| المورد | البيانات التي يتضمنها |
|---|---|
products | الرمز، الاسم، وحدة المخزون، نوع الصنف في BOM، التكلفة المعيارية |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | أوامر الشراء المفتوحة، line_quantity، requested_delivery_dates |
sop_orders, sop_order_lines | طلب العملاء، requested_delivery_date، promised_delivery_date |
warehouses, units | المواقع ووحدات القياس |
2. إضافة التصنيع لأوامر الإنتاج. لا تتضمن Sage 200 API نقاط نهاية لأوامر الإنتاج أو العمليات أو الموارد. توجد أوامر الإنتاج في Sicon Works Order Processing أو Cim200 أو وحدة Sage 200 Manufacturing القديمة. يقرأ التكامل أوامر الإنتاج والعمليات والموارد بالطريقة التي تدعمها الإضافة، ويُتفق عليها معك ومع شريك Sage 200 لديك أثناء تحديد النطاق.
المصادقة والوصول
تنص وثائق Sage 200 API على أنها “uses OAuth 2.0 with OpenID Connect” (تستخدم بروتوكول OAuth مع OpenID Connect)، وذلك وفق تدفق منح رمز التفويض. ويتم تسجيل الدخول عبر Sage ID.
- انضم إلى Sage 200 API Developer Programme واطلب بيانات الاعتماد.
- اربط Sage ID بمستخدم Sage 200 لديه صلاحيات الوصول إلى الشركة والوظائف اللازمة لنقاط النهاية التي تستخدمها.
- اطلب نطاق الصلاحية
offline_access، وإلا فلن يُصدر رمز تحديث. - أرسل
Authorization: Bearer <access_token>وX-SiteوX-Companyمع كل طلب لقاعدة البيانات. تحصل على كلا المعرّفين من/sites.
عنوان URL الأساسي لـ Sage 200 Professional هو: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. تستخدم الطلبات GET وPOST وPUT وDELETE، وخيارات استعلام OData التالية: $filter و$select و$top و$skip و$orderby و$expand.
في Sage 200 Professional، يتولى مزوّد الدعم لدى العميل تفعيل API. ووفق قائمة التحقق لدى Sage، يؤكد المزوّد أن “the API is enabled” (تم تفعيل API) وأن “each required user has a Sage ID assigned.” (تم تعيين Sage ID لكل مستخدم معني). أما في Sage 200 Standard، فتكون API مفعّلة افتراضيًا.
تؤثر مدد صلاحية الرموز في تصميم التكامل. تبقى رموز الوصول صالحة لمدة 8 ساعات، وتتراوح صلاحية رموز التحديث بين 1 و90 يومًا. وتنص الوثائق على أن “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (تُحتسب فترة التحديث من تسجيل الدخول الأول للمستخدم، لا من آخر تحديث). وتذكر Sage أن إعادة المصادقة “is unavoidable” (لا مفر منها). لذا خطط لتنبيه يطلب تجديد الموافقة قبل انتهاء هذه الفترة.
أما لدى SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. يشرح الدليل التعليمي للتكامل كيفية إجراء الاستدعاءات الأولى.
رصد التغييرات
لا يتضمن مرجع Sage 200 API موردًا لإشعارات webhook أو الاشتراكات. تُرصد التغييرات بالاستعلام الدوري. تحتوي السجلات على date_time_created وdate_time_updated، لذا يستخدم كل استعلام $filter للتصفية حسب date_time_updated، ويقسّم النتائج إلى صفحات باستخدام $top و$skip.
استعلم عن أوامر الإنتاج كل بضع دقائق، وعن المخزون وبنود أوامر الشراء كل ساعة. يرسل SkyPlanner إشعارات webhook عند تغيّر الجدول، فتتم إعادة كتابة البيانات استجابةً لهذه الأحداث.
ربط البيانات
| كائن Sage 200 (المصدر) | كائن SkyPlanner | الاتجاه | التكرار |
|---|---|---|---|
products, units (API) | المنتجات والمواد | Sage 200 → SkyPlanner | تحميل البيانات، ثم الاستعلام الدوري |
| مكوّنات BOM (الإضافة أو وحدة BOM) | هيكل المنتج، المنتجات الفرعية، المواد لكل منتج | Sage 200 → SkyPlanner | عند التغيير |
| موارد العمالة والآلات ومجموعات الموارد (الإضافة) | محطات العمل، مجموعات محطات العمل، العاملون | Sage 200 → SkyPlanner | التحميل الأولي للبيانات |
| توافر الموارد: التوقف والصيانة والإجازات (الإضافة) | الورديات، حالات الغياب | Sage 200 → SkyPlanner | يوميًا |
| أوامر الإنتاج وعملياتها، والأزمنة لكل عملية (الإضافة) | الأوامر والمهام بمراحلها ومددها ومواعيد استحقاقها | Sage 200 → SkyPlanner | كل بضع دقائق |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | مواعيد التسليم للعملاء | Sage 200 → SkyPlanner | استعلام دوري |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | أرصدة المخزون | Sage 200 → SkyPlanner | كل ساعة |
pop_order_lines: line_quantity, requested_delivery_dates (API) | أوامر الشراء مع تاريخ التسليم المتوقع | Sage 200 → SkyPlanner | كل ساعة |
| موعدا بدء العملية وانتهائها المخططان في أمر الإنتاج، والمورد | البداية والنهاية المخططتان ومحطة العمل لكل عملية | SkyPlanner → Sage 200 | عند التغيير، عبر webhook |
| تسجيل وقت العملية (الإضافة) | سجلات الأوقات وتأكيدات المشغّلين | SkyPlanner → Sage 200 | عند كل تأكيد أو في كل وردية |
| بيانات القيود في SkyPlanner | مصفوفة أزمنة التجهيز، الأدوات كموارد محدودة السعة، الآلات والعاملون البدلاء | تُدار في SkyPlanner | خلال التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اجلب المنتجات والوحدات من API، ثم الموارد ومجموعات الموارد وعمليات BOM من الإضافة. يمكن تمثيل مجموعة موارد تضم ثلاث آلات متطابقة بمجموعة واحدة من محطات العمل أو بثلاث محطات عمل.
2. مزامنة الأوامر. اقرأ أوامر الإنتاج المفتوحة وعملياتها من الإضافة، إلى جانب بنود pop_order_lines المفتوحة وبيانات warehouse_holdings من API. تتحقق الجدولة من المخزون والمشتريات الواردة معًا. يواصل MRP اقتراح أوامر الإنتاج في Sage 200، ويتولى SkyPlanner جدولة الأوامر التي تنشئها.
3. إعادة كتابة بيانات الجدولة. لكل عملية أدرجها المحرك في الجدول أو غيّر موعدها، يعيد SkyPlanner إرسال البداية والنهاية المخططتين والمورد إلى أمر الإنتاج. وتحتفظ الإضافة بالكميات والتخصيصات وحسابات التكلفة الخاصة بها.
4. تأكيدات صالة الإنتاج. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الأوقات الجدول محدّثًا. يُعاد الوقت المسجّل ليُحتسب على عملية أمر الإنتاج، فتُستخدم الساعات الفعلية في حساب التكلفة داخل Sage 200.
إذا كان مصنعك يسجّل الوقت بالفعل في Sicon Shop Floor Data Capture أو Cim200 Shop Floor Data Capture، فاختر قناة واحدة لتسجيل الوقت.
5. قواعد ملكية البيانات والتعارضات. وثّق هذه القواعد قبل بدء التشغيل الفعلي:
| البيانات | الجهة المالكة |
|---|---|
| المنتجات، وقوائم المواد، وكميات أوامر الإنتاج، والتخصيصات، والتكاليف | Sage 200 والإضافة |
| تسلسل العمليات، وأوقات البدء والانتهاء، وتعيين محطة العمل | SkyPlanner |
| مصفوفة أزمنة التجهيز، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| تسجيل الوقت | Sage 200، استنادًا إلى سجلات الوقت من SkyPlanner |
مخطط الطاقة الإنتاجية هو المصدر الرئيسي للتعارض. فإذا واصل المخططون سحب أوامر الإنتاج أو العمليات في Sicon Rough Cut Capacity Planning أو Cim200 Graphical Scheduler، يصبح هناك نظامان يتحكمان في المواعيد. اجعل SkyPlanner المرجع المعتمد لمواعيد العمليات. وبفضل Autopilot، يعيد SkyPlanner الجدولة تلقائيًا عند حدوث تغييرات في الإنتاج.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تحقّق من صلاحية الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام بيانات أوامر الإنتاج المفتوحة المصدّرة بصيغة CSV أو Excel. ثم يسير المشروع وفق الخطوات التالية:
- تحديد النطاق. أكّد الإضافة وإصدارها، ومسار قراءة أوامر الإنتاج، ومسار إعادة كتابة البيانات، ودورية المزامنة، وقناة تسجيل الوقت.
- إتاحة الوصول إلى API. يفعّل مزوّد الدعم Sage 200 API، ويربط Sage ID بمستخدم في Sage 200، ويضبط صلاحيات الوصول إلى الشركات والميزات.
- التحميل الأولي. تحميل المنتجات والوحدات والموارد ومجموعات الموارد وعمليات قوائم المواد وبيانات التوافر.
- مزامنة الأوامر. مزامنة أوامر الإنتاج وبنود أوامر الشراء والمخزون بالاستعلام الدوري، مع تنبيه لطلب الموافقة مجددًا.
- إعداد القيود في SkyPlanner. إعداد مصفوفة أزمنة التجهيز، والأدوات، وعدد المشغّلين لكل مهمة، والآلات أو العاملين البدلاء.
- إعادة كتابة الجدول. إرسال مواعيد العمليات المخططة إلى أوامر الإنتاج، وإضافة تسجيل الوقت في هذه المرحلة.
- الاختبار بالتوازي وبدء التشغيل الفعلي. قارن المواعيد بالخطة الحالية، وصحّح البيانات الرئيسية، ثم فعّل إعادة كتابة البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Sage 200
- وحدة أُوقفت في الإصدار الجديد. لا يمكن استخدام الوحدة القديمة Sage 200 Manufacturing بدءًا من Sage 200 Professional 2025 R2. قبل البدء بأي ربط للبيانات، تأكّد من حل التصنيع الذي سيُستخدم عند بدء التشغيل الفعلي.
- أزمنة العمليات المستمدة من بيانات التكلفة. يقدّر Sicon MRP أزمنة العمالة والآلات استنادًا إلى بنود تكلفة قوائم المواد في Sage 200. تحقّق أولًا من مطابقتها لأزمنة التشغيل الفعلية.
- عدم تطابق عناوين التكلفة. تحذّر Sage من ضرورة تطابق Nominal وOverhead Nominal وOverhead Recovery % بين عمليات قوائم المواد وعناوين التكلفة، وإلا “there will be cost discrepancies.” (ستظهر فروق في التكاليف).
- مهلة التجديد. يُحتسب الحد الأقصى البالغ 90 يومًا من أول تسجيل دخول. وأي تكامل لا تُجدَّد فيه الموافقة يتوقف في اليوم نفسه من كل ربع سنة.
- المواقع التي تضم عدة شركات. يمكن أن يضم الموقع الواحد عدة شركات، لذا أرسل القيمة الصحيحة في
X-Companyمع كل طلب.
التكامل مع Sage 200: من يتولى الإعداد والدعم؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة، ويدعمه بعد بدء التشغيل الفعلي.
- يمكن لشريك أعمال Sage 200 الذي تتعامل معه المشاركة. فهو يعرف الإضافة التي تستخدمها، ويتولى تفعيل API في Sage 200 Professional.
- يمكن لمطوّريك تطوير حلول تعتمد على هذا التكامل باستخدام REST API الموثّقة نفسها ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة.
بمجرد إتمام الاتصال، يجري محرك Arcturus الجدولة استنادًا إلى أوامر الإنتاج المحدّثة في Sage 200، وتُسجَّل المواعيد المخططة في عمليات أوامر الإنتاج. يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. نقدّم لك مسبقًا عرض سعر للتكامل يناسب إجراءاتك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء. اطّلع على الأسعار والميزات، وقارن ذلك بإمكانات التخطيط المدمجة في Sage 200 في صفحة تخطيط الإنتاج في Sage 200 ضمن الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة في صفحة Sage 200، وتجد أنظمة ERP الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةتوفيرًا كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
كالي كاليوماكي، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة المهام الجديدة إلى خط الإنتاج خلال ثوانٍ.
1,000sمن أوامر الإنتاج تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وأصبح فهمنا للطاقة الإنتاجية على مستوى مختلف تمامًا.”
هانو رينانن، الرئيس التنفيذي
Mamec · خلاطات ومضخات صناعية وتصنيع تعاقدي عالي التقنية
تُجدول آلاف أوامر الإنتاج تلقائيًا، مع إتاحة رؤية آنية للإنتاج على مستوى المؤسسة بأكملها.
الأسئلة الشائعة
هل تشمل Sage 200 API أوامر الإنتاج؟
لا. تغطي Sage 200 Professional API المنتجات والمخزون وأوامر البيع والشراء والشؤون المالية وغيرها، لكنها لا تتيح موارد لأوامر الإنتاج أو العمليات. وتأتي أوامر الإنتاج من إضافة التصنيع التي تستخدمها، مثل Sicon Works Order Processing أو Cim200، عبر المسار المتفق عليه أثناء تحديد النطاق.
من ينفّذ التكامل مع Sage 200؟
يضبط فريق SkyPlanner التكامل ثنائي الاتجاه ليتوافق مع إعداد Sage 200 لديك خلال التهيئة، ويدعمه بعد بدء التشغيل الفعلي. ويتولى شريك أعمال Sage 200 الذي تتعامل معه تفعيل API، ويمكنه المشاركة في المشروع. كما يمكن لمطوّريك تطوير حلول باستخدام REST API الموثّقة من SkyPlanner، ويكفي رمز API للبدء.
هل يستطيع Sage 200 إرسال التغييرات فور حدوثها؟
لا تدعم Sage 200 API إشعارات الويب. يجري الاستعلام دوريًا عن بيانات المخزون وأوامر الشراء بالاعتماد على date_time_updated، وتُقرأ أوامر الإنتاج من الإضافة كل بضع دقائق. وفي الاتجاه المعاكس، ترسل إشعارات الويب الخاصة بـ SkyPlanner تغييرات الجدول فور حدوثها.
هل يمكننا تجربة SkyPlanner قبل تنفيذ التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد أوامر الإنتاج بصيغة CSV أو Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع فريق المبيعات لتحديد نطاق التكامل.
