مركز المساعدةمركز المساعدة / المطورون · مرجع
أنشئ منتجًا أو حدّثه، واضبط المخزون والأسعار لمنتجات كثيرة، من نظام ERP أو نقاط البيع لديك.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
الثلاثة كلها طلبات POST تحت /api/webhook، وتستخدم رمز Webhook. راجع تبويب Webhooks/Pushers.
/item-createيحتاج إلى تفعيل Webhook المنتجات.
يُبحث عن المنتج عبر item_id أولًا، ثم عبر barcode. إذا لم يطابق أيٌّ منهما، يُنشأ منتج جديد. الكود لا يطابق بالاسم، مع أن التبويب يذكر ذلك.
| الحقل | مطلوب | المعنى |
|---|---|---|
item_id | لا | معرّف المنتج في نظامك، ويُحفظ كمعرّف خارجي للمنتج. أرسله مع كل طلب |
name | نعم | اسم المنتج، حتى 255 حرفًا |
price | نعم | سعر البيع، 0 أو أكثر |
category_name | نعم | الفئة الرئيسية |
unit | نعم | وحدة مثل kg أو pcs، حتى 50 حرفًا |
old_price | لا | السعر قبل الخصم |
sub_categories | لا | اسم فئة فرعية أو أكثر |
unit_value, unit_label | لا | حجم العبوة وتسمية الوحدة |
description | لا | وصف المنتج |
barcode | لا | الباركود، حتى 255 حرفًا |
stock_quantity, stock_alert_quantity | لا | المخزون المتوفر، ومستوى تنبيه انخفاض المخزون |
is_active | لا | true يُظهر المنتج للعملاء |
تحتوي الاستجابة على المنتج في data والرسالة "Item created or updated successfully".
المنتج الجديد الذي يتجاوز حد المنتجات في باقتك يُرفض بـ HTTP 402. تحديثات المنتجات الموجودة تمرّ دائمًا.
/stock-updateلا يلزم زر تفعيل.
| الحقل | مطلوب | المعنى |
|---|---|---|
products_info | نعم | قائمة، عنصر واحد لكل منتج |
products_info[].ID | نعم | نص. يُطابَق مع المعرّف الخارجي للمنتج أولًا، ثم مع معرّفه في المتجر |
products_info[].qty | لا | كمية المخزون الجديدة. 0 قيمة صالحة؛ يصبح المنتج غير متوفر عندما يصل مجموعه إلى 0 |
products_info[].price | لا | سعر البيع الجديد |
products_info[].package_price | لا | السعر الجديد «قبل الخصم» |
products_info[].package_name | لا | اسم المنتج الجديد |
products_info[].branch_id | لا | مرجع أحد مواقعك، حتى 100 حرف |
إذا كانت قيمة price أو package_price هي 0 فإنها تُتجاهل. احذف المفتاح من الطلب ليبقى على قيمته.
المتاجر التي لها أكثر من موقع: يجب أن يطابق branch_id قيمة مرجع نظام ERP / الويب هوك لأحد المواقع. راجع تكاملات الموقع. المرجع غير المعروف أو الموقع المتوقف يُفشل ذلك الصف.
تسرد الاستجابة updated_products وtotal_updated وerrors:
| النتيجة | الحالة | الرسالة |
|---|---|---|
| تحديث منتج واحد على الأقل | 200 | "Products updated successfully" |
| فشل كل الصفوف | 400 | "All product updates failed" |
| منتج غير موجود | خطأ في الصف | "Product with ID '…' not found in shop" |
الصف الخاطئ لا يوقف بقية الصفوف.
/stock-update-by-order| الحقل | مطلوب | المعنى |
|---|---|---|
order_id | نعم | معرّف أمر بيع في Zoho Inventory، كنص |
يُخصم المخزون فقط لأمر بيع حالته الفرعية «مؤكَّد»، ومرة واحدة لكل أمر.