التكاملات / ERP / Comarch ERP XL
دليل تكامل Comarch ERP XL لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط Comarch ERP XL بـSkyPlanner APS. يتكامل SkyPlanner مع Comarch ERP XL في الاتجاهين باستخدام واجهات Comarch نفسها:
- تُستورد أوامر الإنتاج (zlecenia produkcyjne) بما تتضمنه من مراحل وعمليات، إلى جانب تقنيات التصنيع ومراكز العمل والموارد والأصناف والمخزون وأوامر الشراء.
- تُعاد أوقات البدء والانتهاء المخططة إلى كل عملية في أمر الإنتاج عبر XL API.
- تُعاد سجلات أوقات المشغّلين لتسجيل تنفيذ العمليات، إذا اخترتم ذلك.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يلائم إعدادات Comarch ERP XL لديكم خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه إلى الشركاء والمطورين الراغبين في المشاركة أو تطوير التكامل بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهات التكامل في Comarch ERP XL
تذكر Comarch ثلاث طرق للاتصال بـERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM، والاتصال المباشر بقاعدة البيانات عبر SQL Client، وREST API) (Comarch، مترجم). يعتمد نظام الجدولة على اثنتين منها:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (تُجمع هذه الدوال في مكتبة CDN_API.DLL التي تُثبّت مع نظام Comarch ERP XL بالكامل.) (مساعدة Comarch، مترجمة) يسجّل البرنامج الخارجي الدخول باستخدام XLLogin، ويستدعي الدوال التي تشترك في الجلسة نفسها، ثم يسجّل الخروج باستخدام XLLogout. تحتوي كل بنية على حقل Wersja لتحديد إصدار مجموعة المعلمات المناسب لإصدار ERP XL لديكم.
- ERP XL Web REST API. يتيح Comarch ERP XL Web 2026.0 خدمات مصغّرة عبر REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (تتيح كل خدمة مصغّرة من RestAPI وثائقها التفاعلية الخاصة عند نقطة النهاية /swagger.) (مساعدة Comarch، مترجمة)
يتيح الاتصال المباشر عبر SQL Client قراءة البيانات الرئيسية والأوامر من قاعدة بيانات ERP XL، وفق ما يُتفق عليه مع فريق تقنية المعلومات وشريك Comarch لديكم.
دوال الإنتاج في XL API
توثّق Comarch دوال الإنتاج التالية (XL128):
| المجال | الدالة | ما تؤديه |
|---|---|---|
| تقنيات التصنيع | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | إنشاء تقنية تصنيع أو عملية، أو إضافة مركز عمل أو مادة أو منتج إلى عملية |
| أوامر الإنتاج | XLNoweZlecenieProd | إنشاء أمر إنتاج |
| أوامر الإنتاج | XLZamknijZlecenieProd | تخطيط أمر إنتاج أو إعادة تخطيطه أو تسويته أو إغلاقه، وفق رمز الإجراء المحدد |
| العمليات | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | إضافة عملية أو مورد إلى مسار إنتاج |
| الجدول الزمني | XLDodajTerminDoProcesuProd | إضافة فترة زمنية إلى عملية: IdCzynnosci, TerminOd, TerminDo |
| التنفيذ | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | إضافة سجل تنفيذ عملية إلى الأمر وتغيير الكمية المنفّذة |
| المستندات | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | إنشاء مستندات RW وPW لكائنات الإنتاج |
المصادقة والوصول
- XL API. يسجّل التكامل الدخول إلى قاعدة البيانات بحساب مستخدم ERP XL عبر XLLogin، ويحصل على جلسة للاستدعاءات اللاحقة. تعمل مكتبة DLL على جهاز Windows مثبّت عليه ERP XL، لذا تعمل خدمة إعادة الكتابة داخل شبكتكم إلى جانب ERP XL.
- REST API. يُضبط الوصول لكل تثبيت من ERP XL Web على حدة، وتوثّق صفحة Swagger الخاصة بكل خدمة مصغّرة استدعاءاتها.
- القراءة عبر SQL. حساب دخول إلى قاعدة البيانات بصلاحية القراءة فقط، بموافقة فريق تقنية المعلومات لديكم.
من جانب SkyPlanner، تستخدم REST API رمز API للمصادقة ضمن ترويسة Authorization-Token (SkyPlanner Settings > API)، وتتوفر وثائقها في Swagger/OpenAPI. يشرح دليل التكامل التطبيقي كيفية إجراء الاستدعاءات الأولى.
الأحداث والاستقصاء الدوري
لا تتضمن الوثائق التي جرت مراجعتها أي إشارات إلى webhooks صادرة من Comarch ERP XL. ويسحب نظام APS الخاص بـComarch البيانات عندما يضغط المخطِّط على “Aktualizuj dane z ERP” (تحديث البيانات من ERP) (مساعدة Comarch APS).
لذلك تُجلب البيانات من ERP XL بالاستقصاء الدوري. وتُكتشف الأعمال الجديدة عبر حصر القراءة في أوامر الإنتاج المفتوحة والتغييرات الحديثة. تُحدَّد وتيرة الاستقصاء لكل مصنع، من مرة كل بضع دقائق لأوامر الإنتاج إلى مرة كل ساعة للمخزون.
يرسل SkyPlanner إشعارات webhooks عند تغيّر الحالة أو الجدول الزمني، لذا تعتمد إعادة الكتابة على الأحداث.
مطابقة البيانات
| كائن Comarch ERP XL (الواجهة) | كائن SkyPlanner | الاتجاه | الوتيرة |
|---|---|---|---|
| Karty towarów، وحدات القياس (REST أو القراءة عبر SQL) | المنتجات والمواد | ERP XL → SkyPlanner | تحميل أولي، ثم استقصاء دوري |
| Technologia: العمليات والمواد والمنتجات نصف المصنّعة والمنتجات لكل عملية | بنية المنتج والمنتجات الفرعية والمواد لكل خطوة إنتاج | ERP XL → SkyPlanner | تحميل أولي، ثم عند التغيير |
| عمليات Technologia: مراكز العمل والموارد والأوقات | خطوات الإنتاج مع مددها وأوقات التهيئة والفك | ERP XL → SkyPlanner | تحميل أولي، ثم عند التغيير |
| Gniazda robocze وzasoby (الآلات والأدوات والموظفون) | محطات العمل ومجموعاتها والأدوات والعاملون | ERP XL → SkyPlanner | تحميل أولي، ثم تحديثات نادرة |
| Kalendarze i okresy, przestoje i awarie | الورديات وأوقات عدم العمل والتوقف | ERP XL → SkyPlanner | يوميًا، أو تُدار الورديات بشكل مستقل في SkyPlanner |
| Zlecenia produkcyjne (ZP) مع المراحل والعمليات والمواد وموعد الاستحقاق والأولوية | الأوامر والمهام مع مواعيد الاستحقاق واحتياجات المواد | ERP XL → SkyPlanner | استقصاء كل بضع دقائق |
| المخزون حسب المستودع | أرصدة المخزون | ERP XL → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
| Zamówienia zakupu (ZZ) مع مواعيد التسليم | أوامر الشراء والمواد الواردة حسب موعد التسليم | ERP XL → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
| مواعيد العملية: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | وقت البدء والانتهاء المخطط لكل مهمة | SkyPlanner → ERP XL | عند تغيّر الجدول الزمني، عبر webhook من SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | سجلات الأوقات وتأكيدات المشغّلين | SkyPlanner → ERP XL | مع كل تأكيد أو لكل وردية، إذا اخترتم ذلك |
| غير موجود في ERP XL | مصفوفة أوقات التجهيز، والأدوات كموارد محدودة، والمهام التي تتطلب عدة مشغّلين، والآلات والعاملون البدلاء | تُدار في SkyPlanner | تُضبط خلال مرحلة التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. تُقرأ الأصناف وتقنيات التصنيع ومراكز العمل والموارد والتقاويم. حدّدوا بعناية كيفية تمثيل مراكز العمل في SkyPlanner: فمركز العمل الذي يضم أربع آلات يصبح مجموعة واحدة من محطات العمل أو أربع محطات عمل. وتُمثَّل الأدوات المسجّلة ضمن موارد ERP XL كأدوات محدودة التوافر في SkyPlanner، ويُمثَّل الموظفون كعاملين لهم ورديات.
2. مزامنة الأوامر. تُقرأ أوامر الإنتاج بعملياتها وموادها، إلى جانب أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في موعد تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered.
3. إعادة كتابة الجدول في النظام. عندما يحدد المحرك موعدًا لعملية أو يغيّر موعدها، يُفعّل webhook من SkyPlanner خدمة إعادة الكتابة. تستدعي الخدمة XLDodajTerminDoProcesuProd باستخدام قيمتَي TerminOd وTerminDo للعملية، فتتضمن كل عملية ZP وقتَي البدء والانتهاء اللذين خطط لهما SkyPlanner.
4. تأكيدات التنفيذ في أرض المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الوقت الجدول محدّثًا. وتختارون ما إذا كانت الأوقات الفعلية تُرسل إلى النظام. إذا اخترتم ذلك، تضيف الخدمة سجلات التنفيذ باستخدام XLDodajRealizacjeOperacjiProd، وتخضع مستندات RW وPW لقواعدكم في ERP XL. وإذا كنتم تستخدمون Comarch MES في بعض المحطات، فاعتمدوا مصدرًا واحدًا للإبلاغ عن كل عملية.
5. قواعد ملكية البيانات ومعالجة التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، وطرق التصنيع، والكميات، وحالة ZP، وحساب التكاليف | Comarch ERP XL |
| تسلسل العمليات، وأوقات البدء والانتهاء، وتخصيص الموارد | SkyPlanner |
| مصفوفة أوقات التهيئة والانتقال، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| الورديات، وتقاويم العمل، وفترات التوقف | نظام واحد يُختار أثناء تحديد النطاق |
| سجلات التنفيذ ومستندات RW وPW | Comarch ERP XL، مع إدخالها فيه مباشرة أو إرسالها من سجلات الوقت في SkyPlanner |
اعتمدوا نظامًا واحدًا لكتابة مواعيد العمليات. إذا كانت إعادة التخطيط التلقائية في ERP XL أو Comarch APS لا تزال تكتب المواعيد في أوامر الإنتاج نفسها، فعطّلوا ذلك للأوامر التي يجدولها SkyPlanner.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تحقّقوا من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام مراكز العمل وطرق التصنيع وأوامر الإنتاج المفتوحة المصدّرة من ERP XL بصيغة CSV أو Excel.
- ربط البيانات. اعتمدوا جدول ربط البيانات، وقواعد ملكيتها، ومعدلات تكرار المزامنة، وقرار إعادة إرسال سجلات التنفيذ إلى النظام.
- الوصول إلى ERP XL. أنشئوا حساب مشغّل التكامل، وأعدّوا اتصال القراءة، وثبّتوا خدمة إعادة الكتابة على جهاز مضيف مثبّت عليه ERP XL. اختبروا أولًا على نسخة من قاعدة البيانات.
- التحميل الأولي. الأصناف، وطرق التصنيع، ومراكز العمل، والموارد، وتقاويم العمل.
- مزامنة أوامر الإنتاج وأوامر الشراء. استقصاء دوري مع عوامل تصفية وإعادة المحاولة.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التهيئة والانتقال، والأدوات، وعدد المشغّلين لكل مهمة، والآلات أو العاملون البدلاء.
- إعادة كتابة الجدول في النظام. استدعاءات XLDodajTerminDoProcesuProd التي تُفعّلها webhooks في SkyPlanner، مع سجلات التنفيذ إذا اخترتم إرسالها.
- الاختبار المتوازي. شغّلوا SkyPlanner بالتوازي مع الخطة الحالية، وقارنوا المواعيد، وصحّحوا البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّلوا إعادة الكتابة بعد التأكد من تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Comarch ERP XL
- الطاقة المُدخلة يدويًا. تُحدَّد طاقة مركز العمل في ERP XL برقم يدخله المستخدم، مع نسبة مئوية للتحميل المسموح به. أما SkyPlanner فيستمد الطاقة من الورديات والموارد الفعلية، لذا أعدّوا الورديات بعناية واستغنوا عن تلك النسبة.
- الموارد غير المحدودة. لا يتحقق ERP XL من إشغال الموارد المصنّفة على أنها ذات طاقة غير محدودة. حدّدوا لكل مورد ما إذا كان سيتحول إلى محطة عمل ذات طاقة محدودة في SkyPlanner.
- الأوامر المُطلقة للإنتاج. يستثني ERP XL العمليات المُطلقة للإنتاج من إعادة التخطيط، ما لم يُفعَّل الخيار “Przesuń na zwolnionych”. اتفقوا على كيفية تطبيق مواعيد SkyPlanner على الأوامر المُطلقة للإنتاج، واستخدموا Running Time Lock لتثبيت جدول ساعات العمل القادمة.
- إصدارات بُنى البيانات. تتضمن بُنى بيانات XL API حقل Wersja. اضبطوه ليتوافق مع إصدار ERP XL لديكم، وأعيدوا الاختبار بعد كل ترقية سنوية.
- الوحدات والأوقات البولندية. يجب تحويل أوقات العمليات ووحدات التقويم بدقة عند الاستيراد، وإلا ستكون جميع المدد غير صحيحة.
من يُعدّ التكامل مع Comarch ERP XL ويدعمه؟
- يتولى فريق SkyPlanner إعداده أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي، ضمن عمليات القراءة واستدعاءات XL API المتفق عليها. يستخدم كل مصنع Comarch ERP XL بطريقته الخاصة، وهنا تُوظَّف الخبرة بهذه التفاصيل.
- يمكن لشريك Comarch الذي تتعاملون معه المشاركة. فهو يعرف إعداداتكم وتراخيصكم وXL API، ويمكنه إعداد حساب المشغّل واتصال القراءة والجهاز المضيف لخدمة إعادة الكتابة بالتعاون مع فريق SkyPlanner.
- يمكن لمطوّريكم البناء على هذا التكامل باستخدام REST API الخاص بـSkyPlanner ورمز API. يكفي رمز API للبدء، ويساعدكم فريق SkyPlanner عند الحاجة. تجدون توثيق التكامل في وثائق تكامل SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مسبقًا وفقًا لإجراءاتكم واحتياجاتكم، إلى جانب باقتكم. اطّلعوا على الأسعار، وتخطيط الإنتاج مع Comarch ERP XL ضمن الطاقة الفعلية للآلات والعاملين، وصفحة Comarch ERP XL، ومركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ستُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
كالي كاليومَكي، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج أسبوعيًا 2 من ساعات العمل، وتصل قائمة مهام جديدة إلى خط الإنتاج خلال ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة مُحسَّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
6 أشهرمن الطاقة المتاحة أمام فريق المبيعات
“يوفّر SkyPlanner أساسًا موثوقًا لكل أعمال تخطيط الإنتاج.”
آنو يارفينن، مديرة الإنتاج
Fredman Operations · أوراق تغليف آمنة لملامسة الأغذية
يرى فريق المبيعات الطاقة المتاحة لستة أشهر مقبلة، وتُجاب طلبات تعديل الجدول خلال ثوانٍ بعدما كانت تستغرق ساعة أو أكثر.
100%الالتزام بمواعيد التسليم منذ 2021
“يمنحنا SkyPlanner رؤية واضحة للطاقة الإنتاجية ويجعل نتائج التخطيط قابلة للتوقع.”
دان بيرغلوند، مدير العمليات والمدير المالي (COO/CFO)
Opes Corporation · تصنيع المواد الكيميائية والأغذية
بلغ الالتزام بمواعيد التسليم 100% طوال فترة استخدام SkyPlanner، منذ 2021.
الأسئلة الشائعة
هل يوفّر Comarch ERP XL واجهة API لأوامر الإنتاج؟
نعم. تتيح XL API (CDN_API.DLL) إنشاء أوامر الإنتاج وتخطيطها وإعادة تخطيطها باستخدام XLZamknijZlecenieProd، وإضافة مواعيد العمليات باستخدام XLDodajTerminDoProcesuProd، وتسجيل التنفيذ باستخدام XLDodajRealizacjeOperacjiProd. ويضيف Comarch ERP XL Web خدمات REST مصغّرة موثّقة في Swagger.
كيف تُكتب المواعيد المخططة في Comarch ERP XL؟
باستخدام XLDodajTerminDoProcesuProd، الذي يضيف نطاقًا زمنيًا (TerminOd, TerminDo) إلى كل عملية في أمر الإنتاج. ويُفعّل webhook من SkyPlanner هذا الاستدعاء كلما تغيّر الجدول.
هل يدعم Comarch ERP XL إشعارات webhooks؟
لا توجد webhooks صادرة موثّقة، لذلك يستقصي التكامل بيانات ERP XL وفق جدول يُحدَّد لكل مصنع. أما webhooks الخاصة بـSkyPlanner فترسل تغييرات الجدول فور حدوثها.
هل ينبغي لشريك Comarch اقتراح Comarch APS أم SkyPlanner؟
SkyPlanner، عندما يريد العميل خلال أسابيع جدولًا يراعي الطاقة الفعلية للآلات والعاملين ويظل محدّثًا تلقائيًا. أما Comarch APS فهو تطبيق مستقل له قاعدة بيانات PostgreSQL وأداة تكامل ومفتاح ترخيص خاصة به. وتتم مزامنته عندما ينقر المخطّط، ويعتمد وقت تهيئة واحدًا ثابتًا لكل عملية (مساعدة Comarch APS). SkyPlanner برنامج سحابي يعيد التخطيط تلقائيًا ويخطط لعمليات التبديل والأدوات وفِرق العمل والمواد، بسعر يبدأ من 199 € شهريًا.
هل يمكننا اختبار SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد بيانات ERP XL بصيغة CSV أو Excel، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
