طلب العناصر

هنا ندخل في التفاصيل حول جلب عناصر الطلبات وإنشائها وتحديثها وحذفها.

يمكن الوصول إلى عناصر الطلبات من نقطة النهاية /phaser-order-rows.

جلب عناصر الطلبات #

تقوم بجلب عناصر الطلب عن طريق إرسال طلب GET- طلب إلى نقطة نهاية /phaser-order-rows:

يمكنك البحث عن عناصر الطلب من خلال مجموعة متنوعة من المعلمات المختلفة:

• phaser_order_id
  • معرف طلب Skyplanner الداخلي، يمكن العثور عليه من نقطة نهاية /phaser-orders-endpoint
• خارجي_معرف
  • المعرف الخارجي لعنصر الطلب
  • على سبيل المثال المعرف الفريد من نظامك الخارجي (ERP، إلخ)
• معرف_تخطيط_الإنتاج_منتج_بمنتج_معرّف
  • معرّف منتج Skyplanner الداخلي
  • يمكن العثور عليها من نقطة نهاية /المنتجات/ المنتجات
• المعرف_الأصلي
  • إذا كان أحد عناصر الطلب يحتوي على عناصر فرعية (مثل المنتجات الفرعية) فإن العناصر الفرعية تحتوي على معرّف عنصر الطلب الأصل في حقل parent_id
• فهرس_الصفوف
  • الرقم الفهرسي لعنصر الطلب

• رقم العمل
  • قيمة رقم العمل لعنصر الطلب
• الحالة
  • حالة عنصر الطلب
  • القيم المسموح بها: جديدة أو بدأت أو مكتملة
• المنصب
  • قيمة موضع عنصر الطلب

• تاريخ_التسليم
  • تاريخ تسليم عنصر الطلب
  • الصيغة 2025-06-05T22:00:00+00:00
• حالة_تاريخ_التسليم
  • الشرط الاختياري للبحث عن تاريخ التسليم
  • الخيارات: >، =، =، <=، !=، !=
  • في حالة عدم وجود قيمة معطاة، سيتم استخدام الشرط >= الشرط
• هو_المتوقع
  • إرجاع عناصر الطلبات التي هي احتمالات فقط
• تضمين_أرشيف
  • تضمين عناصر الطلبات المؤرشفة (المحذوفة بشكل ناعم) في عملية الجلب
  • يُشار إليها بقيمة is_archive
• معدلة
  • عناصر طلب الإرجاع التي تم تعديلها بعد تاريخ معين
  • الصيغة 2025-06-05T22:00:00+00:00
• حالة معدلة
  • الشرط الاختياري للبحث عن القيمة المعدلة
  • الخيارات: >، =، =، <=، !=، !=
  • في حالة عدم وجود قيمة معطاة، سيتم استخدام الشرط >= الشرط

يمكنك أيضًا مزج معلمات البحث ومطابقتها مثل هذا:

لجلب عنصر طلب معين بمعرف Skyplanner الداخلي الخاص به يمكنك القيام بطلب مثل هذا:

إنشاء عناصر الطلبات #

لاحظ أنه يجب عليك إنشاء طلب قبل إنشاء عنصر الطلب!

لإنشاء عنصر طلب، أرسل طلب POST إلى نقطة نهاية /phaser-order-rows إلى نقطة نهاية /phaser-order-rows:

فيما يلي نظرة عامة حول الحقول التي يمكنك استخدامها عند إنشاء عنصر طلب:

• phaser_order_id
  • معرف Skyplanner الداخلي للطلب الذي تم إرفاق عنصر الطلب به
  • الحقل المطلوب
• معرف_صف_طلب_إنتاج_تخطيط_الإنتاج
  • بعد تصدير الأمر إلى وحدة جدولة الإنتاج في Skyplanner، يتم إنشاء كيان منفصل يسمى صف أمر تخطيط الإنتاج ويتم تعيين معرفه في هذا الحقل
  • لا يوصى باستخدامه (اتركه فارغًا أو لا ترسل هذا الحقل على الإطلاق في حقل الطلب)
• معرف_تخطيط_الإنتاج_منتج_بمنتج_معرّف
  • معرّف منتج Skyplanner للمنتج الذي ينتجه عنصر الطلب
  • مطلوب إذا كنت ترغب في إحضار خطوات عملية افتراضية من المنتج
• خارجي_معرف
  • المعرف الفريد لعنصر الطلب
  • استخدم هذا لربط عنصر طلب Skyplanner بعنصر الطلب الخاص بك من نظام خارجي (تخطيط موارد المؤسسات وما إلى ذلك)
  • يجب أن تكون فريدة من نوعها
• المعرف_الأصلي
  • إذا كان عنصر الطلب عنصرًا فرعيًا لعنصر طلب آخر، فقم بإعطاء قيمة المعرف الأصلي هنا
• فهرس_الصفوف
  • أين يقع هذا العنصر في قائمة عناصر الطلب بالترتيب في الترتيب
• رقم العمل
  • تُستخدم فقط كقيمة رقم عمل إعلامي لعنصر الطلب
  • غير مرئي في واجهة مستخدم Skyplanner
• الحالة
  • حالة عنصر الطلب
  • القيم المسموح بها: جديد، بدأ، جاهز، على مراحل
• هو_أرشيف
  • هل تم أرشفة عنصر الطلب (حذف ناعم)
• المنصب
  • قيمة معرّف عنصر الطلب (انظر الشكل 3.)
• المبلغ
  • إجمالي الكمية المصنعة من المنتج
• المبلغ_المطلوب
  • الكمية المطلوبة من المنتج
• السعر
  • سعر الوحدة من المنتج
• استخدام_مواد_مخصصة
  • إذا كنت لا ترغب في استخدام إعداد المواد الافتراضي من بيانات المنتج، قم بتعيين هذه القيمة إلى صواب
  • افتراضي: خطأ
• استخدام_مواد_مخصصة_محسوبة_مخصص_محسوبة
  • يتم احتساب كميات المواد المخصصة بناءً على كمية المنتجات المصنعة
  • إذا تم ضبطها على خطأ، تكون كميات المواد ثابتة
  • افتراضي: خطأ
• الحصول_على_خطوات_افتراضية
  • إنشاء خطوات عملية لطلب عنصر بناءً على خطوات العملية الافتراضية للمنتج
  • افتراضي: خطأ
• استخدام_معدلات_الوظائف_المحسوبة_في_الوظائف
  • حساب مدد خطوات العملية بناءً على بيانات السجل الزمني السابقة
  • في حالة عدم توفر بيانات كافية للحساب، يتم استخدام المدد الافتراضية
  • افتراضي: خطأ
• العناصر_الفرعية
  • إنشاء عناصر فرعية للمنتج أيضًا إذا كانت متوفرة
  • افتراضي: خطأ
• تاريخ_التسليم
  • الصيغة: 2022-01-01 10:30:11
• تاريخ_بدء_الأهلية
  • الصيغة: 2022-01-01 10:30:11
• معرّف_الرسم
  • مُعرِّف الرسم/المطبوعة الزرقاء/التعليمات
• الوصف
  • وصف عنصر الطلب
• وصف_إضافي
  • وصف إضافي لبند الطلب
• هو_المتوقع
  • هل عنصر الطلب احتمال
  • افتراضي: خطأ

تحديث عناصر الطلبات #

لتحديث بيانات عنصر الطلب، يمكنك إرسال طلب PUT إلى نقطة نهاية /phaser-order-rows:

حذف عناصر الطلبات #

يتم حذف عناصر الأمر بطريقة “الحذف الناعم”. في الواقع، يؤدي حذف عنصر أمر إلى تغيير قيمة is_archive الخاصة به إلى صواب. هذا يعني أنه يمكنك استعادة عناصر الطلب المحذوفة عن طريق تحديث قيمة is_archive إلى خطأ.

عند حذف عنصر أمر، سيقوم النظام أيضًا بحذف خطوات العملية المرتبطة به.

يمكنك حذف عناصر الطلب عن طريق إرسال طلب حذف-حذف إلى نقطة نهاية /phaser-أمر-صفوف-طلب:

يمكنك حذف عناصر الطلب عن طريق إعطاء معرّفات Skyplanner الداخلية في المصفوفة “ids” أو المعرّفات_الخارجية في المصفوفة “external_ids”.