---
title: المنتجات والمواد
description: "سنستعرض هنا كيف يمكنك إنشاء منتجات ومواد وكيف يمكنك إرفاقها بطلباتك باستخدام واجهة برمجة التطبيقات Skyplanner-API. سوف نوضح لك أيضًا كيفية إنشاء خطوات عملية افتراضية لمنتجاتك وكيفية إنشاء عناصر الطلب باستخدام تلك العناصر الافتراضية. #### إنشاء منتج/مادة يتم إنشاء وتحديث…"
url: "https://skyplanner.ai/ar/docs/%d8%a7%d9%84%d9%85%d9%86%d8%aa%d8%ac%d8%a7%d8%aa-%d9%88%d8%a7%d9%84%d9%85%d9%88%d8%a7%d8%af/"
updated: "2025-10-07"
category: عمليات الدمج
tags:
  - التكامل
  - واجهة برمجة التطبيقات
---

# المنتجات والمواد

سنستعرض هنا كيف يمكنك إنشاء منتجات ومواد وكيف يمكنك إرفاقها بطلباتك باستخدام واجهة برمجة التطبيقات Skyplanner-API. سوف نوضح لك أيضًا كيفية إنشاء خطوات عملية افتراضية لمنتجاتك وكيفية إنشاء عناصر الطلب باستخدام تلك العناصر الافتراضية.

#### إنشاء منتج/مادة

يتم إنشاء وتحديث كل من المنتجات والمواد من خلال نفس نقطة نهاية واجهة برمجة التطبيقات: /منتجات. يتم تعيين نوع المنتج من خلال **سمة النوع**: "منتج" أو "مادة

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**الشكل 1.** إنشاء منتج

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**الشكل 2.** إنشاء مادة

عند إنشاء المنتجات والمواد، تأكد من تعيين القيمة **is_active** على أنها صحيحة إذا كنت تريد أن يظهر المنتج/المادة على أنها نشطة في قائمة المنتجات. لاحظ أيضًا أنه يمكنك تعيين كمية المخزون المتاحة باستخدام السمة **free_amount**.

#### إنشاء خطوات عملية افتراضية لمنتج ما

قبل إضافة خطوات العملية الافتراضية لمنتج ما، يجب أن يكون لديك مراحل العمل المناسبة. يمكن إنشاء مراحل العمل إما من خلال واجهة مستخدم Skyplanner أو نقطة نهاية /مراحل العمل.

تتم إضافة خطوات العملية الافتراضية من نقطة النهاية /products/jobs/{productId}.

لذلك على سبيل المثال إذا كنت تريد إضافة خطوة افتراضية إلى المنتج بالمعرف 22220، يمكنك القيام بطلب POST-طلب مثل هذا:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**الشكل 3.** إضافة خطوة عملية افتراضية

بعض المجالات البارزة:

- رقم_الطلب
  - هذا هو رقم فهرس يخبر Skyplanner بالترتيب الذي من المفترض أن تكتمل به خطوات العملية
  - على سبيل المثال: الخطوة الأولى تحصل على القيمة 1، والخطوة الثانية تحصل على القيمة 3، والخطوة الثالثة تحصل على القيمة 3 وهكذا...
- محطات العمل
  - هذه قائمة بمحطات العمل التي يمكن جدولة خطوة العملية هذه عليها
  - اكتب هنا معرّفات محطات العمل كقائمة مفصولة بفاصلة، مثل هذا: "61,62,63"
- التباين_الزمني
  - القيم الممكنة: time_per_pcs, pcs_per_time, fixed_time
- المدة، وقت الضبط، وقت الضبط، وقت الضبط
  - اكتب هذه القيم *بالثواني*

#### تحديث خطوة عملية افتراضية

عند تحديث خطوة عملية افتراضية يجب عليك استخدام السمة **order_number** لتحديد الخطوة المراد تحديثها.

على سبيل المثال، يتم تنفيذ خطوة العملية الأولى**(الطلب_رقم 1**) في هذا المنتج باستخدام طلب PUT-طلب مثل هذا:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**الشكل 4.** تحديث خطوة عملية افتراضية

#### حذف خطوات العملية الافتراضية

يتم حذف خطوات العملية الافتراضية أيضًا باستخدام قيم **Order_number**.

يتم إعطاء أرقام_الطلبات في مصفوفة على هذا النحو:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**الشكل 5.** حذف خطوات العملية الافتراضية

##### إضافة مادة/منتج فرعي إلى منتج ما

لإرفاق مادة أو منتج فرعي نحتاج إلى استخدام نقطة النهاية / المنتجات الفرعية.

العملية بسيطة جدًا: نضع معرف المادة أو المنتج الفرعي في سمة **production_planning_product_product_id** ومعرف المنتج الذي نريد أن تكون المادة/المنتج الفرعي مرتبطًا به في سمة **production_planning_product_product_parent_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**الشكل 6.** إرفاق مادة بمنتج ما

##### إضافة مادة إلى عنصر الطلب

يمكنك أيضًا إرفاق المواد مباشرةً بعنصر الطلب باستخدام نقطة النهاية / صف المواد. وبهذه الطريقة يمكنك إرفاق مواد إضافية أو استخدام قائمة مواد مختلفة تمامًا في عنصر أمر ما عن المواد الافتراضية التي تم تعيينها للمنتجات. لاحظ أنه يمكنك الحصول على كيان صف-مواد واحد فقط لعنصر الطلب لكل مادة. لذا في الواقع لا يمكنك إنشاء كيانين بنفس **معرف_تخطيط_المنتج_المتعلق بالإنتاج**لنفس **معرف_صف_طلب_المنتج phaser_order_row_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**الشكل 7.** إضافة مادة إلى عنصر طلب

#### تحديث مستوى المخزون

يمكنك تحديث مستوى مخزون المنتج أو المادة عن طريق إرسال طلب PUT-إدخال مع سمة **الكمية_المتاحة**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**الشكل 8.** تحديث مستوى المخزون