التكاملات / ERP / Acumatica Cloud ERP
دليل تكامل Acumatica لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Acumatica هذا للشركاء وفرق تقنية المعلومات كيفية ربط Acumatica Cloud ERP (Manufacturing Edition) بنظام SkyPlanner APS. يعمل التكامل بين SkyPlanner وAcumatica في كلا الاتجاهين:
- تُستورد أوامر الإنتاج بعملياتها، إلى جانب مراكز العمل والآلات والأدوات والورديات وأصناف المخزون وأوامر الشراء.
- تُكتب تواريخ البدء والانتهاء المخططة في عمليات أمر الإنتاج، ثم يُثبَّت الأمر.
- تُعاد سجلات وقت المشغّلين إلى Acumatica في صورة قيود عمل ونقل.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يتوافق مع إعدادات Acumatica لديكم أثناء التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطوّرين الراغبين في المشاركة أو تطوير التكامل بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهات التكامل في Acumatica
يعتمد التكامل على الواجهات المتاحة أصلًا في Acumatica. ولا يُثبَّت أي مكوّن داخل بيئة النظام.
- REST API القائمة على العقود. لنقاط النهاية أرقام إصدارات تتبع إصدار النظام. تتيح نقطة النهاية Manufacturing (مثل 26.200.001 للإصدار 2026 R2) الوصول إلى
ProductionOrderوOrderOperationDetailوBillOfMaterialوWorkCenterوMachineوToolوShiftوWorkCenterCrewScheduleوLaborEntryوMoveEntryوMaterialEntry. أما نقطة النهاية Default فتغطيStockItemوPurchaseOrderوSalesOrder. وتتبع عناوين URL الصيغة{instance}/entity/{Endpoint}/{version}/{Entity}. - إجراءات عبر نقطة النهاية نفسها. تنفّذ الإجراءات
FirmProductionOrderوUndoFirmProductionOrderوReleaseLaborEntryوReleaseMoveEntryوReleaseMaterialEntryالمنطق نفسه الذي تنفّذه الأزرار في شاشات النظام. - OData. يمكن إتاحة أي Generic Inquiry (SM208000) عبر OData. وأسرع طريقة لقراءة البيانات دفعة واحدة هي استخدام Generic Inquiry لعمليات الإنتاج المفتوحة مع تواريخها.
- الإشعارات الفورية (SM302000). تعتمد على Generic Inquiry أو استعلام مضمّن، وترسل الصفوف المُدرجة والمحذوفة إلى عنوان URL تحدّدونه.
- سيناريوهات الاستيراد والتصدير مع موفّري بيانات CSV وExcel لتحميل البيانات دفعة واحدة.
تجدون قائمة الكيانات والإجراءات في Web Service Endpoints (SM207000) وفي مستودع عميل REST الخاص بـ Acumatica.
المصادقة والحدود
يستخدم Acumatica بروتوكولَي OAuth 2.0 وOpenID Connect من خلال تطبيقات العميل المسجّلة في Connected Applications (SM303010). مسارات المصادقة الموثّقة هي Authorization Code وImplicit وResource Owner Password Credentials وHybrid. للتكامل بين الخوادم، سجّلوا حساب مستخدم مخصّصًا للتكامل بأدوار تمنحه الحد الأدنى من الصلاحيات، واستخدموا Authorization Code مع رمز تحديث، أو Resource Owner Password Credentials.
يحدّد الترخيص الحد الأقصى للاستخدام: تعرض License Monitoring Console (SM604000) العدد المسموح به لطلبات API في الدقيقة ولمستخدمي API.
من جانب SkyPlanner، تعتمد المصادقة في REST API على رمز API (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. ويشرح دليل التكامل التعليمي كيفية إجراء الاستدعاءات الأولى.
ربط البيانات
| كائن Acumatica (نقطة النهاية / النموذج) | كائن SkyPlanner | الاتجاه | وتيرة المزامنة |
|---|---|---|---|
StockItem (Default؛ Stock Items IN202500) | المنتجات والمواد | Acumatica → SkyPlanner | تحميل أولي، ثم نقل التغييرات فقط |
BillOfMaterial (AM208000): المواد والعمليات | بنية المنتج، والمنتجات الفرعية، والمواد لكل منتج | Acumatica → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| عمليات BOM: Setup، Run، Machine، Queue، Finish، Move Time | خطوات العملية مع مددها وأوقات الإعداد والتفكيك | Acumatica → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
WorkCenter (AM207000)، Machine (AM204500)، WorkCenterSubstitute | محطات العمل ومجموعاتها، ومعدلات الكفاءة، ومحطات العمل البديلة | Acumatica → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
Shift، Work Calendar (CS209000)، WorkCenterCrewSchedule | الورديات والطاقة المتاحة للعاملين | Acumatica → SkyPlanner | يوميًا، أو تُدار الورديات في SkyPlanner |
Tool (AM205500) | الأدوات بوصفها موارد محدودة | Acumatica → SkyPlanner | تحميل أولي |
ProductionOrder مع OrderOperationDetail (Planned، Released، In Process) | الأوامر والمهام مع مواعيد الاستحقاق وأولوية التنفيذ واحتياجات المواد | Acumatica → SkyPlanner | إشعار فوري أو استقصاء كل بضع دقائق |
بنود PurchaseOrder (Default) | أوامر الشراء مع تاريخ التسليم المتوقع | Acumatica → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
| كميات الأصناف في المستودعات | أرصدة المخزون | Acumatica → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
OrderOperationDetail: StartDate، EndDate، WorkCenter | البدء والانتهاء المخططان ومحطة العمل لكل عملية | SkyPlanner → Acumatica | عند تغيير الجدول، عبر webhook من SkyPlanner |
الإجراء FirmProductionOrder | يمنع Acumatica APS من تعديل التواريخ المكتوبة | SkyPlanner → Acumatica | بعد كل إعادة كتابة للبيانات |
LaborEntry وMoveEntry مع إجراءات الترحيل | سجلات الوقت والكميات المنجزة وتأكيدات المشغّلين | SkyPlanner → Acumatica | عند كل تأكيد أو لكل وردية |
| غير موجودة في Acumatica | مصفوفة أوقات الإعداد، والمشغّلون المحدّدون بالاسم، والمهام التي تتطلب عدة مشغّلين | تُدار في SkyPlanner | تُضبط أثناء التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأوا مراكز العمل والآلات والأدوات والورديات والتقاويم أولًا، ثم أصناف المخزون وقوائم المواد. حدّدوا كيفية تمثيل مركز عمل يضم عدة آلات: هل يكون مجموعة واحدة من محطات العمل، تمثّل فيها كل آلة محطة عمل، أم محطة عمل واحدة؟ يوضّح حقل Basis for Capacity في Acumatica النهج الذي يعتمده المصنع.
2. مزامنة الأوامر. اقرأوا أوامر الإنتاج مع عملياتها من الأمر نفسه، وليس من BOM. فالعمليات تُنسخ إلى الأمر، ويجري المخطّطون تعديلاتهم عليها هناك. اضبطوا إشعارًا فوريًا يعتمد على Generic Inquiry للأوامر والعمليات المفتوحة، أو استقصوا هذا الاستعلام دوريًا. واقرأوا أيضًا بنود أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عندما يُعلَّم أمر الشراء بالحالة Delivered.
3. إعادة كتابة بيانات الجدول. لكل عملية يضعها المحرّك في الجدول أو ينقلها، يكتب SkyPlanner قيمتَي StartDate وEndDate في OrderOperationDetail، ويكتب مركز العمل أيضًا عند نقل العمل إلى مركز بديل. ثم يستدعي FirmProductionOrder. وتوضح Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (عند تشغيل تخطيط الإنتاج الذي يراعي الطاقة الفعلية للآلات والعاملين، لا يعيد النظام جدولة أوامر الإنتاج المثبّتة.) (المصدر)
4. تأكيدات صالة الإنتاج. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer. وتتحوّل سجلات الوقت إلى مستندات LaborEntry (الوقت والكمية المنجزة لكل عملية) أو مستندات MoveEntry (الكمية فقط)، وتُرحَّل باستخدام الإجراء المناسب. إذا كانت صالة الإنتاج لديكم تسجّل البيانات بالفعل في Acumatica عبر Labor (AM301000) أو Shop Floor Kiosk، فتتدفق بيانات التقدّم في الاتجاه المعاكس. اختاروا قناة واحدة، ولا تستخدموا القناتين معًا.
5. قواعد ملكية البيانات ومعالجة التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| أصناف المخزون وقوائم المواد والكميات وحالة الأمر وحساب التكاليف | Acumatica |
| تسلسل العمليات وأوقات البدء والانتهاء وتعيين محطات العمل | SkyPlanner |
| مصفوفة أوقات الإعداد والأدوات ومتطلبات المشغّلين والبدائل | SkyPlanner |
| الورديات وحالات الغياب | نظام واحد يُختار أثناء تحديد النطاق |
| حركات العمل والنقل | Acumatica، وتُرحَّل إليه من سجلات الوقت في SkyPlanner أو تُدخل في صالة الإنتاج |
المصدر الرئيسي للتعارض هو نظام APS الخاص بـ Acumatica. فقد يعيد Rough Cut Planning أو APS Maintenance Process حساب تواريخ الأوامر التي جدولها SkyPlanner. يمنع تثبيت كل أمر بعد كتابة بياناته حدوث ذلك. واستبعد الأوامر المجدولة من عمليات تشغيل APS أيضًا.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك الفعلية خلال التجربة المجانية لمدة 30 يومًا. صدّر مراكز العمل وأوامر الإنتاج المفتوحة مع عملياتها من Generic Inquiry إلى Excel، ثم استوردها وتحقق من صحة الجدول.
- ربط البيانات. حدّد جدول ربط البيانات وقواعد ملكيتها ودورية المزامنة وقناة ترحيل قيود العمل.
- الوصول. سجّل التطبيق المتصل، وأنشئ مستخدم التكامل والأدوار، وتحقق من إصدار نقطة النهاية في Web Service Endpoints. ابدأ ببيئة اختبار معزولة.
- التحميل الأولي. مراكز العمل والآلات والأدوات والورديات وأصناف المخزون وقوائم المواد.
- مزامنة الأوامر. زامن أوامر الإنتاج والعمليات وأوامر الشراء عبر إشعارات الدفع أو الاستعلام الدوري.
- إعداد القيود في SkyPlanner. اضبط مصفوفة أوقات الإعداد، وحدّد المشغلين بأسمائهم والمهام التي تتطلب عدة مشغلين والبدائل.
- الكتابة إلى النظام المصدر. تواريخ العمليات وتثبيت الأوامر وقيود العمل أو النقل.
- التشغيل المتوازي. قارن تواريخ SkyPlanner بالخطة الحالية وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل الكتابة إلى النظام المصدر بعد التأكد من تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Acumatica
- تحقق من محرك APS المفعّل. يخزّن كل من Classic وOptimized إعداداته على حدة، ولا يمكن تفعيل سوى أحدهما. راجع Enable/Disable Features (CS100000) قبل أول كتابة إلى النظام المصدر.
- ثبّت إصدار نقطة النهاية. الإصدار جزء من عنوان URL. تضيف ترقية النظام إصدارًا جديدًا، لذا أعد الاختبار مع كل ترقية.
- تحديث العمليات. بعض حقول العمليات متاحة للقراءة فقط عبر REST، كما أن حالة الأمر تؤثر في إمكانية التحديث. اختبر تسلسل الكتابة إلى النظام المصدر في بيئة اختبار معزولة للأوامر بالحالتين Released وIn Process.
- الوحدات وحقول الوقت. يُحسب وقت التشغيل بحسب Run Units، ووقت الآلة بحسب Machine Units. ويرد عن وقت الانتظار والنقل: “affect the calculated schedule but do not occupy work center capacity.” (يؤثران في الجدول المحسوب، لكنهما لا يشغلان طاقة مركز العمل). احرص على دقة التحويل عند الاستيراد.
- تحديد توافر المواد. يشترط Classic APS توافر جميع المواد بكامل كمياتها. أما SkyPlanner فيخطط بناءً على المخزون وأوامر الشراء المنتظرة حسب تواريخها. اتفقوا على النتيجة التي سيعتمدها المخططون.
- حدود API. يحدد الترخيص عدد الطلبات المسموح بها في الدقيقة. استخدم قراءة التغييرات فقط وإشعارات الدفع بدلًا من إعادة تحميل البيانات كاملةً.
من يتولى إعداد التكامل مع Acumatica ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي. تختلف طريقة استخدام Acumatica من مصنع إلى آخر، وهنا تُوظّف هذه الخبرة.
- يمكن لشريك Acumatica الذي تتعامل معه المشاركة. فهو يعرف التخصيصات وGeneric Inquiries والأدوار لديك. ويوفر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وآليات webhooks.
- يمكن لمطوريك إنشاء التكامل بأنفسهم باستخدام REST API نفسها ورمز API. يكفي رمز API للبدء، ويساعد فريق SkyPlanner عند الحاجة. اتبعت Laboratory & Allied هذا المسار مع SAP Business One، إذ أنشأ فريق تقنية المعلومات الداخلي لديها التكامل بنفسه إلى حد كبير، بمساعدة SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مقدمًا وفقًا لعملياتك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء. اطّلع على مقارنة مع نظام APS الخاص بـ Acumatica في صفحة تخطيط الإنتاج في Acumatica وفق الطاقة الفعلية للآلات والعاملين، وعلى نظرة عامة في صفحة Acumatica، وعلى الأنظمة الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةتُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع الكهربائية ومعدات الفصل والتوصيل
يوفر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة المهام الجديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس تقنية المعلومات
Laboratory & Allied · صناعة الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
آلاف (1,000)من أوامر العمل تُجدول تلقائيًا
“أصبحت سيطرتنا على الإنتاج مختلفة، وانتقل فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
Hannu Ryynänen، الرئيس التنفيذي
Mamec · خلاطات ومضخات صناعية وتصنيع تعاقدي بتقنيات متقدمة
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية للإنتاج في الوقت الفعلي على مستوى المؤسسة بأكملها.
99.2%الالتزام بمواعيد التسليم
“أتاح SkyPlanner رؤية أوضح لتحديد الاختناقات، وجعل إدارة الإنتاج أكثر وضوحًا.”
Toni Tuori، مدير الإنتاج
Piristeel · أنظمة سلامة الأسطح وتصريف مياه الأمطار
بلغ الالتزام بمواعيد التسليم 99.2% هذا العام، وتوفر الجدولة ما يصل إلى أربع ساعات من وقت العمل يوميًا.
الأسئلة الشائعة
هل تتيح API الخاصة بـ Acumatica الوصول إلى أوامر الإنتاج؟
نعم. تتيح نقطة النهاية Manufacturing في REST API القائمة على العقود الوصول إلى ProductionOrder وOrderOperationDetail وBillOfMaterial وWorkCenter وMachine وTool وقيود العمل والنقل، إلى جانب إجراءات مثل FirmProductionOrder.
من ينشئ التكامل مع Acumatica؟
يضبط فريق SkyPlanner التكامل ثنائي الاتجاه بما يناسب إعداد Acumatica لديك أثناء التهيئة، ويدعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لشريك Acumatica أو لمطوريك إنشاء التكامل باستخدام REST API الموثقة من SkyPlanner، ويكفي رمز API للبدء.
هل نحتاج إلى Acumatica APS لهذا التكامل؟
لا. ينفّذ Acumatica تخطيط الإنتاج الذي يراعي الطاقة الفعلية للآلات والعاملين عبر نموذج Rough Cut Planning، بينما يخطط Classic APS للأوامر التي تنتهي بعد أكثر من 120 يومًا بافتراض طاقة غير محدودة (المصدر). أما SkyPlanner فينشئ بنفسه جدولًا تفصيليًا يراعي الطاقة الفعلية، اعتمادًا على أوامر الإنتاج والعمليات ومراكز العمل والآلات والأدوات. لذلك يعمل التكامل سواء كان APS مفعّلًا أم لا، وهو نظام تقول Acumatica إنه “is subject to licensing” (يخضع للترخيص). يحافظ Autopilot على تحديث الجدول، ويسجّل المشغلون العمل باستخدام Mobile Confirmations.
كيف نمنع Acumatica APS من تغيير التواريخ التي يحددها SkyPlanner؟
يثبّت SkyPlanner كل أمر إنتاج بعد كتابة تواريخ عملياته. وعند الجدولة وفق الطاقة الفعلية، لا يعيد Acumatica جدولة الأوامر المثبّتة.
هل يستطيع Acumatica إرسال التغييرات فور حدوثها؟
نعم. ترسل إشعارات الدفع (SM302000) المُعدّة على Generic Inquiry الصفوف التي تغيّرت إلى عنوان URL فور حدوث التغيير. وترسل webhooks الخاصة بـ SkyPlanner تغييرات الجدول في الاتجاه المعاكس.
ما طريقة المصادقة التي ينبغي أن يستخدمها التكامل؟
OAuth 2.0 عبر عميل مسجّل في Connected Applications (SM303010)، مع مستخدم مخصّص للتكامل وأدوار بأقل قدر لازم من الصلاحيات. ويُؤكّد مسار المصادقة المناسب لبيئتك أثناء تحديد النطاق.
هل يمكننا اختبار SkyPlanner قبل إنشاء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد ملفات Excel أو CSV من Generic Inquiry في Acumatica، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
