دليل تكامل Katana لجدولة الإنتاج باستخدام SkyPlanner APS

Katana منتج سحابي واحد متعدد المستأجرين، لذا يستخدم جميع العملاء واجهة API نفسها. وهي REST API بالإصدار v1 على العنوان https://api.katanamrp.com/v1، وتتوفر مواصفاتها بصيغة OpenAPI 3.0 على العنوان https://api.katanamrp.com/v1/openapi.json. تجدون التوثيق في بوابة مطوري Katana.

نقاط النهاية التي يحتاج إليها نظام الجدولة:

• البيانات الرئيسية: /products، /materials، /variants، /recipe_rows، /bom_rows، /product_operation_rows.
• الأوامر: /manufacturing_orders، /manufacturing_order_operation_rows، /manufacturing_order_recipe_rows، /manufacturing_order_productions.
• التسلسل: /manufacturing_order_rerank.
• العرض والطلب: /inventory، /purchase_orders، /purchase_order_rows، /sales_orders، /sales_order_rows.

لا توجد نقطة نهاية باسم /resources. تظهر الموارد في الحقلين resource_id وresource_name ضمن صفوف عمليات المنتجات وصفوف عمليات أوامر التصنيع.

سجّلوا إشعار ويب بطلب POST إلى /webhooks، مع عنوان HTTPS والأحداث المطلوبة. (المصدر) فيما يلي الأحداث المفيدة للجدولة:

• manufacturing_order.created، .updated، .deleted، .in_progress، .blocked، .done
• manufacturing_order_operation_row.created، .updated، .in_progress، .paused، .completed
• current_inventory.material_updated، .material_out_of_stock
• purchase_order.* وpurchase_order_row.*، بما في ذلك أحداث الاستلام
• product.*، product_recipe_row.* وsales_order.*

محتوى الإشعارات مختصر: نوع المورد والإجراء وحقل href. يجلب المستقبِل الكائن كاملًا من عنوان href. ويحمل كل إرسال ترويسة x-sha2-signature ‏(HMAC SHA-256) للتحقق من صحته. يجب أن تستجيب نقطة النهاية لديكم برمز 20X خلال 10 ثوانٍ، ويعيد Katana المحاولة ثلاث مرات، بعد 30 ثانية و2 دقيقة و15 دقيقة.

1. التحميل الأولي للبيانات الرئيسية. اجلبوا المنتجات والمواد ومتغيرات المنتجات وصفوف التركيبات وصفوف عمليات المنتجات صفحةً تلو الأخرى، مع ضبط معدل الطلبات ليبقى دون الحد المسموح. أنشئوا محطات العمل في SkyPlanner استنادًا إلى الموارد المتميزة في صفوف العمليات، واحتفظوا بمفتاح مطابقة 1:1. اضبطوا الورديات والإجازات والعمل الإضافي لكل محطة عمل في SkyPlanner، إذ لا يوفر Katana تقويمًا للموارد.

2. مزامنة الأوامر. اشتركوا في أحداث أوامر التصنيع وصفوف العمليات والمخزون وأوامر الشراء. عند كل حدث، اجلبوا الكائن من عنوان href الخاص به وحدّثوا المهمة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند استلامه. وتتيح مطابقة البيانات كل ليلة باستخدام مرشحات تاريخ التحديث تدارك أي حدث فائت.

3. إرسال الجدول إلى Katana. تُنقل الخطة إلى Katana باستدعاءين:

• يؤدي طلب POST إلى /manufacturing_order_rerank الوظيفة التالية: “moves one or more manufacturing orders to an exact place in the production schedule” (ينقل أمر تصنيع واحدًا أو أكثر إلى موضع محدد في جدول الإنتاج). ويقبل ما يصل إلى 250 أمر تصنيع مفتوحًا في كل طلب، لوضعها في أول الجدول أو آخره أو قبل أمر تصنيع محدد أو بعده. (المصدر)
• يضبط طلب PATCH إلى /manufacturing_orders/{id} قيمة production_deadline_date. ولا يقبلها Katana إلا إذا كان الحساب التلقائي للموعد النهائي معطّلًا لموقع المصنع المعني. (المصدر)

لا يقتصر أثر إعادة الترتيب على القائمة. ففي Katana، “higher-priority MOs reserve required materials and subassemblies first” (تحجز أوامر التصنيع الأعلى أولويةً المواد والتجميعات الفرعية المطلوبة أولًا). لذلك يحدد تسلسل SkyPlanner أيضًا أي أمر تصنيع يحصل على المخزون في Katana.

4. تأكيدات صالة الإنتاج. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer أو Quick Log Mode. ويكتب SkyPlanner الحالة والوقت الفعلي في صف عملية أمر التصنيع. وإذا اختار المصنع مواصلة استخدام Katana Shop Floor App بدلًا من ذلك، يقرأ SkyPlanner أحداث صفوف العمليات. اختاروا قناة واحدة لتسجيل العمل في كل مصنع.

5. مسؤولية البيانات وقواعد حل التعارضات. وثّقوها قبل بدء التشغيل الفعلي:

• وضع المواعيد النهائية يمحو التواريخ. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (عند تفعيل الوضع التلقائي، تُستبدل جميع المواعيد النهائية اليدوية ولا يمكن استعادتها.) احسم اختيار الوضع مرة واحدة عند انطلاق المشروع.
• لا يوجد تقويم للموارد. لا تستنتج الورديات من قيمة Weekly throughput وحدها. بل أعدّ الورديات لكل محطة عمل في SkyPlanner.
• الموارد متاحة في صفوف العمليات فقط. حافظ على ثبات أسماء الموارد في Katana، لأنها مفاتيح الربط بمحطات العمل في SkyPlanner.
• وحدات الوقت. تُقاس قيمة planned_time_parameter بالثواني؛ وهي مدة لكل وحدة في العمليات من نوع per-unit، ومدة إجمالية للأنواع process وsetup وfixed. طابق النوع بصورة صحيحة، وإلا اختلفت المدد بعامل يساوي الكمية.
• مجموعات الإنتاج حسب الطلب. عند إعادة الترتيب، تبقى أوامر التصنيع المرتبطة بأمر البيع نفسه معًا، لذا رتّبها كمجموعة واحدة.
• تغيّر سلوك إعادة الترتيب. منذ 7 أكتوبر 2026، تضع نقاط نهاية إعادة الترتيب الطلبات في الموضع المحدد تمامًا. ويجب إعادة اختبار عمليات التكامل المبنية على السلوك السابق. (المصدر)