دليل تكامل Senior ERP لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط Senior ERP من Senior Sistemas (Gestão Empresarial | ERP XT مع Senior X) بنظام SkyPlanner APS. يتكامل SkyPlanner مع Senior ERP في الاتجاهين عبر واجهات Senior نفسها:
- تُستورد أوامر الإنتاج (OPs) بمراحلها، ومسارات العمليات (roteiros)، والموارد ومراكز الموارد، ووحدات حفظ المخزون (SKUs)، وهياكل المنتجات، والمخزون، وأوامر الشراء.
- تُعاد إلى أمر الإنتاج OP مواعيد البداية والنهاية المخططة لكل مرحلة، والمورد المختار لها.
- تُرسل سجلات أوقات المشغّلين إلى Senior في صورة apontamentos de produção، إذا اخترتم ذلك.
- يُبلغ Senior X Events Hub نظام SkyPlanner عند تغيّر حالة مرحلة في أمر الإنتاج OP، وتُرسل إشعارات الويب من SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يناسب إعدادات Senior ERP لديكم خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه إلى الشركاء والمطوّرين الراغبين في المشاركة أو البناء بأنفسهم على REST API الموثّقة لدى SkyPlanner (مرجع API).
واجهات التكامل في Senior ERP
ERP XT نظام هجين. تذكر وثائق Senior أن Gestão Empresarial XT ”becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (يصبح نظامًا هجينًا: نظامًا محليًا يتكامل مع حلول سحابية) (وثائق Senior، مترجمة). يستخدم نظام الجدولة ثلاث واجهات من Senior:
- خدمات الويب G5 (SOAP). تعمل هذه الخدمات على خادم Senior لديكم، وتُسمّى بحسب الوحدة البرمجية (com.senior.g5.co.<module>…). تُنشر كل خدمة بثلاث صيغ WSDL: sapiens_Sync وsapiens_Async وsapiens_Scheduled. تشمل خدمات الإنتاج com.senior.g5.co.mpr.pcp.ordemproducao، التي “calls the same production order generation routine” (تستدعي إجراء إنشاء أوامر الإنتاج نفسه) المستخدم في شاشة ERP (وثائق Senior، مترجمة)، إلى جانب خدمات المنتجات (com.senior.g5.co.ger.cad.produto) وتسجيل بيانات الإنتاج.
- واجهات REST API لمنصة Senior X Platform على api.senior.com.br، للوصول إلى مجالات ERP التي تتيحها Senior عبر Senior X، مثل المنتجات وأوامر البيع (وثائق Senior).
- إشعارات الويب في Events Hub. تُنشأ في Senior X ضمن Tecnologia > Customização > Events Hub > Webhooks. تنشر وحدة التصنيع الحدث erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus عند تغيّر حالة مرحلة في أمر الإنتاج OP (وثائق Senior).
المصادقة والوصول
- Senior X Platform. يسجّل التكامل الدخول بإرسال طلب POST إلى platform.senior.com.br على المسار /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login، باسم مستخدم بصيغة user@tenant. تتضمن الاستجابة رمز وصول من نوع Bearer ورمز تحديث. ويمكن تسجيل الدخول بمفاتيح التطبيق عبر loginWithKey باستخدام مفتاح الوصول والسر والمستأجر. تتضمن استدعاءات REST ترويسة authorization وترويسة client_id التي تعرّف التطبيق المتصل، المسجّل في بوابة Senior API والمرتبط بدور في ERP.
- خدمات الويب G5. تتضمن الاستدعاءات معاملات اسم المستخدم وكلمة المرور والتشفير. عند استخدام رمز Senior X، يحل الرمز محل كلمة المرور (وثائق Senior).
- الصلاحيات. أنشئوا مستخدمًا مخصصًا للتكامل في Senior، مع صلاحية الوصول إلى بيانات PCP والهندسة والمخزون والمشتريات التي يقرأها التكامل ويكتبها.
في SkyPlanner، تستخدم REST API رمز API للمصادقة في الترويسة Authorization-Token (SkyPlanner Settings > API)، وهي موثّقة بصيغة Swagger/OpenAPI. يشرح الدليل التعليمي للتكامل كيفية إجراء الاستدعاءات الأولى خطوة بخطوة.
الأحداث والاستقصاء الدوري
يغطي Events Hub أحداث أرضية المصنع: عند تغيّر حالة مرحلة في أمر الإنتاج OP، يصل إشعار الويب إلى SkyPlanner ويُحدَّث الجدول. أما البيانات الأخرى فتُجلب بالاستعلام الدوري. وتُلتقط الأعمال الجديدة بقراءة البيانات مع تصفيتها لتشمل أوامر الإنتاج المؤكدة والمُفرَج عنها والتغييرات الأخيرة. يُحدَّد تواتر الاستعلام لكل مصنع، من مرة كل بضع دقائق لأوامر الإنتاج إلى مرة كل ساعة للمخزون.
يرسل SkyPlanner إشعارات webhook عند تغيّر الحالة أو الجدول، لذا تُعاد البيانات إلى Senior استجابةً لهذه الأحداث.
مطابقة البيانات
| كائن Senior ERP (الواجهة) | الكائن في SkyPlanner | الاتجاه | التكرار |
|---|---|---|---|
| SKU: produto وderivação، ووحدات القياس (خدمات الويب G5 أو كيانات Senior X) | المنتجات والمواد | Senior → SkyPlanner | تحميل أولي، ثم استقصاء دوري |
| هيكل المنتج (engenharia do SKU) | هيكل المنتج، والمنتجات الفرعية، والمواد لكل منتج | Senior → SkyPlanner | تحميل أولي، ثم عند التغيير |
| Roteiro بمراحله estágios: التسلسل والاعتماد على المرحلة السابقة | خطوات العملية بالترتيب | Senior → SkyPlanner | تحميل أولي، ثم عند التغيير |
| Recurso: Tempo processo، Tempo setup، Tempo carga e descarga، Tempo transferência، Fator de carga | محطات العمل، والمدد، وأوقات الإعداد والتفكيك، والكفاءة | Senior → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
| Centro de recurso | مجموعات محطات العمل | Senior → SkyPlanner | تحميل أولي، ثم نادرًا بعد ذلك |
| Calendário: Feriados، وتقويم الإنتاج لكل وردية | الورديات وأيام عدم العمل | Senior → SkyPlanner | يومياً، أو تحديد ورديات مستقلة في SkyPlanner |
| Ordens de produção (Firme، Liberada) بمراحلها وموادها | الأوامر ومهام الإنتاج مع مواعيد الاستحقاق واحتياجات المواد | Senior → SkyPlanner | استقصاء كل بضع دقائق |
| حالة مرحلة OP (Events Hub orderProductionStageChangeStatus) | تقدّم العمل | Senior → SkyPlanner | لحظيًا عبر إشعار ويب |
| Estoque لكل SKU | أرصدة المخزون | Senior → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
| Ordens de compra مع تواريخ التسليم | أوامر الشراء، والمواد الواردة بحسب تاريخ التسليم | Senior → SkyPlanner | استعلام دوري، كل ساعة أو عند تشغيل الجدولة |
| مرحلة OP: البداية والنهاية المخططتان، والمورد | البداية والنهاية المخططتان لكل مهمة، ومحطة العمل المخصصة لها | SkyPlanner → Senior | عند تغيّر الجدول، عبر إشعار ويب من SkyPlanner |
| Apontamento de produção: numOrp، codEtg، seqRot، qtdRel، qtdRfg، وتاريخ ووقت البداية والنهاية | سجلات الأوقات وتأكيدات المشغّلين | SkyPlanner → Senior | مع كل تأكيد أو لكل وردية، إذا اختير ذلك |
| غير موجود في Senior ERP | مصفوفة أوقات التهيئة، والأدوات كموارد محدودة السعة، والمهام التي تتطلب عدة مشغّلين، والآلات والأفراد البدلاء | تُدار في SkyPlanner | تُضبط خلال مرحلة التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأوا وحدات حفظ المخزون SKUs والهياكل وroteiros وrecursos وcentros de recurso وتقويم الإنتاج. حدّدوا بعناية كيفية ربط مراكز الموارد: يتحول centro de recurso الذي يضم أربع آلات إلى مجموعة واحدة لمحطات العمل أو أربع محطات عمل. حوّلوا Fator de carga إلى كفاءة لمحطة العمل في SkyPlanner أو إلى ورديات، وليس إلى كليهما.
2. مزامنة أوامر الإنتاج OP. اقرأوا أوامر الإنتاج بالحالتين Firme وLiberada بمراحلها وموادها، إلى جانب أوامر الشراء المفتوحة. لا يزال بإمكان MRP تعديل أوامر الإنتاج بالحالة Planejada أو حذفها، لذا لا تجدولوها إلا إذا أردتم رؤية استشرافية. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء PO، ويُحدّث المخزون عند وضع علامة Delivered على الأمر.
3. إعادة بيانات الجدول إلى Senior. عندما يضع محرك الجدولة مرحلة في الجدول أو ينقلها، يُطلق إشعار ويب من SkyPlanner عملية إرسال البيانات إلى Senior. تُحدّث هذه العملية مواعيد البداية والنهاية المخططة لكل مرحلة من أمر الإنتاج OP والمورد المختار لها، وهي الحقول نفسها التي يعدّلها المخطط في Programação de produção. يتفق فريق SkyPlanner معكم ومع شريك Senior لديكم على خدمة الويب المحددة خلال تحديد النطاق.
4. تأكيدات أرضية المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الأوقات الجدول محدّثًا. أنتم تقررون ما إذا كانت الأوقات الفعلية ستُرسل إلى Senior. عند اختيار ذلك، يتحول كل تأكيد إلى apontamento de produção على مرحلة أمر الإنتاج OP، ويتضمن الكمية المنتجة والهالك وأوقات البداية والنهاية. لا يقبل Senior سجلات الإنتاج إلا لأوامر الإنتاج بالحالة Liberada أو Andamento. وإذا كنتم تسجّلون الإنتاج عبر Fábrica ao Vivo، فإن SkyPlanner يقرأ التقدّم عبر Events Hub بدلًا من ذلك.
5. قواعد ملكية البيانات وحل التعارضات. دوّنها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| وحدات حفظ المخزون SKUs، والهياكل، وroteiros، وكميات أوامر الإنتاج OP وحالتها | Senior ERP |
| تسلسل المراحل، وأوقات البداية والنهاية، وتخصيص الموارد | SkyPlanner |
| مصفوفة أوقات التهيئة، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| تقويم الإنتاج والورديات | نظام واحد يُختار خلال تحديد النطاق |
| Apontamentos، وحركات المخزون، وحساب التكاليف | Senior ERP، بإدخال البيانات فيه أو إرسالها من سجلات الأوقات في SkyPlanner |
حدّدوا نظامًا واحدًا لكتابة تواريخ المراحل. إذا كان المخططون لا يزالون يرتّبون أوامر الإنتاج OP نفسها في Programação de produção أو مخطط Gantt، فاتفقوا على الأوامر التي يتولى SkyPlanner إدارتها.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة التهيئة. وقبل ذلك، تحقّقوا من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام الموارد وroteiros وأوامر الإنتاج OP المفتوحة المصدّرة من Senior بصيغة CSV أو Excel.
- ربط البيانات. اعتمدوا جدول الربط وقواعد مسؤولية إدارة البيانات وتواتر المزامنة، وحدّدوا ما إذا كانت apontamentos ستُرسل إلى Senior.
- الوصول إلى Senior. أنشئوا مستخدم التكامل، وسجّلوا التطبيق في بوابة Senior API، وفعّلوا خدمات الويب G5 وإشعار الويب في Events Hub. اختبروا أولًا في قاعدة بيانات مخصصة لاختبارات القبول.
- التحميل الأولي. وحدات حفظ المخزون SKUs، والهياكل، وroteiros، وrecursos، وcentros de recurso، والتقويم.
- مزامنة أوامر الإنتاج OP وأوامر الشراء. استعلام دوري مع تصفية وإعادة المحاولة، إلى جانب إشعار الويب الخاص بحالة المرحلة.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التهيئة، والأدوات، وأعداد المشغّلين لكل مهمة، والآلات أو الأفراد البدلاء.
- إعادة بيانات الجدول إلى Senior. تواريخ المراحل ومواردها عبر إشعارات الويب من SkyPlanner، إلى جانب apontamentos إذا اختير ذلك.
- الاختبار المتوازي. شغّل SkyPlanner بالتوازي مع الخطة الحالية، وقارن المواعيد، وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إرسال البيانات إلى Senior بمجرد تطابق البيانات.
ما ينبغي مراعاته عند التخطيط لتكامل Senior ERP
- أربعة أوقات لكل مورد. يتضمن Recurso وقت التشغيل، والإعداد، والتحميل والتفريغ، والنقل. قد يكون وقت التحميل والنقل وقت مناولة، لا وقت تشغيل آلة. حدّدوا لكل مورد كيفية ربط كل وقت، وإلا ستكون جميع المدد خاطئة.
- وقت إعداد واحد لكل مورد. حقل Tempo setup في Senior له قيمة واحدة. ابنوا مصفوفة أوقات التهيئة في SkyPlanner استنادًا إلى عمليات التغيير الفعلية لديكم خلال مرحلة التهيئة.
- تنويعات المنتجات. تتكون وحدة حفظ المخزون SKU في Senior من منتج مع derivação، وقد تختلف roteiros باختلاف التنويعة. أدرجوا رمز التنويعة في مفاتيح المنتجات في SkyPlanner.
- حالات أوامر الإنتاج OP. لا تقبل سجلات الإنتاج إلا أوامر الإنتاج بالحالتين Liberada وAndamento. أبقوا تغييرات الحالة في Senior، ودعوا SkyPlanner يتابعها عبر Events Hub.
- النشر الهجين. تعمل خدمات الويب G5 على خادم Senior لديكم، ويعمل Events Hub في Senior X. خطّطوا لإتاحة الوصول عبر الشبكة إلى كليهما.
- تنسيق الأرقام. ترفض خدمات الويب في Senior الأرقام التي تحتوي على فواصل للآلاف، وتتطلب استخدام الفاصلة (,) للفصل بين الجزء الصحيح والجزء العشري. أرسل الأرقام بهذا التنسيق.
من يتولى إعداد التكامل مع Senior ERP ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية ودعمه بعد بدء التشغيل الفعلي، وذلك عبر خدمات الويب وواجهات API في Senior X وإشعارات الويب من Events Hub المتفق عليها. تختلف طريقة تشغيل Senior ERP من مصنع إلى آخر، وهنا تظهر قيمة هذه الخبرة.
- يمكن لشريك Senior الذي تتعامل معه المشاركة. فهو يعرف إعدادات نظامك وتخصيصاته وتراخيصه، ويمكنه إعداد مستخدم التكامل والتسجيل في بوابة API وخدمات الويب بالتعاون مع فريق SkyPlanner.
- يمكن لمطوريك البناء على هذا التكامل باستخدام REST API في SkyPlanner ورمز API. يكفي رمز API للبدء، ويقدم فريق SkyPlanner المساعدة عند الحاجة. تتوفر الوثائق في وثائق تكامل SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا مع خطة اشتراكك، وفقًا لعملياتك واحتياجاتك. راجع الأسعار وتخطيط الإنتاج مع Senior ERP بما يراعي الطاقة الفعلية للآلات والعاملين وصفحة Senior ERP ومركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةمن الوقت الموفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة العمل الجديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
آلاف (1,000s) من أوامر العمل تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وانتقل فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
هانو رينانن، الرئيس التنفيذي
Mamec · خلاطات صناعية ومضخات وتصنيع تعاقدي بتقنيات متقدمة
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية آنية للإنتاج لجميع أقسام المؤسسة.
توقفات أقلبسبب نقص المواد
“تكمن قيمة SkyPlanner بالنسبة لنا في كونه أداة عملية للاستخدام اليومي، خصوصًا لتحديد مواعيد التسليم.”
Tommi Männistö، مدير تخطيط الإنتاج
Eskomatic · التشغيل الميكانيكي للغير
تتيح الجدولة التلقائية لأحمال العمل تحديد مواعيد تسليم أدق، وقد انخفضت توقفات الإنتاج الناجمة عن نقص المواد انخفاضًا حادًا.
الأسئلة الشائعة
هل يوفر Senior ERP واجهة API لأوامر الإنتاج؟
نعم. تُنشئ خدمة الويب com.senior.g5.co.mpr.pcp.ordemproducao في G5 أوامر الإنتاج (OPs) بالإجراء نفسه المستخدم في شاشة ERP، وتغطي خدمات G5 الأخرى المنتجات وتسجيل بيانات الإنتاج. وتضيف Senior X Platform واجهات REST API مع تسجيل الدخول برمز Bearer، وإشعارات الويب من Events Hub.
هل يدعم Senior ERP إشعارات الويب؟
نعم. يرسل Senior X Events Hub إشعارات الويب، ومنها orderProductionStageChangeStatus عند تغير حالة إحدى مراحل أمر الإنتاج (OP). يستخدمها SkyPlanner لمتابعة تقدم العمل في صالة الإنتاج لحظيًا، ويرسل تغييرات الجدول إلى النظام عبر إشعارات الويب الخاصة به.
كيف تُعاد كتابة التواريخ المخططة في Senior ERP؟
يحدد SkyPlanner البداية والنهاية المخططتين لكل مرحلة من مراحل أمر الإنتاج (OP) والمورد المختار لها، وهي الحقول نفسها التي يعدّلها المخطط في Programação de produção. وكلما تغير الجدول، يُطلق إشعار ويب من SkyPlanner عملية إعادة الكتابة، عبر المسار الذي يحدده فريق SkyPlanner لبيئة Senior لديك أثناء تحديد النطاق في مرحلة التهيئة الأولية.
هل يعمل التكامل مع Senior X وERP XT؟
نعم. يعمل ERP XT على خادمك، مع خدمات سحابية على Senior X. ويستخدم التكامل خدمات الويب G5 على الخادم، وواجهات API في Senior X وEvents Hub في السحابة.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Senior بصيغة CSV أو Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
