api_items_collection

الوصول والصلاحيات

Authorization: Bearer <access_token>

يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.

معلمات الاستعلام

{
  "results": [],
  "total": 0,
  "active_total": 0,
  "inactive_total": 0,
  "page": 1,
  "page_size": 50,
  "total_pages": 1
}

العقد يراجع GET فقط؛ إنشاء الصنف عبر POST لم يراجع هنا.

results مصفوفة أصناف؛ المثال يعرض قائمة فارغة صحيحة. تتضمن كل نتيجة id/code/name/art_no/barcode/serial_no/ctn/text/item_type/category_name/preferred_supplier_name/is_active.

حقول الأسعار: default_sale_price وprice_1 وeffective_sale_price وprice_2 وmax_discount_percent وdiscount_limit_type وmax_discount_amount وpromotion_name. price_3 يظهر فقط مع صلاحية مشاهدة السعر الخاص.

حقول التكلفة purchase_price وstandard_cost وcurrent_cost وcost_method وstock_value تظهر فقط عند سماح CostVisibilityService؛ غياب الحقل لا يعني أن قيمته صفر.

تتضمن النتيجة allow_as_gift وsold_by_weight وscale_plu وscale_unit وscale_tare_weight وimage_url وimages وtotal_stock. serial_no يكرر barcode في هذا التنفيذ ولا يمثل قائمة أرقام تسلسلية.

الكميات والأسعار تعاد أرقام JSON هنا. إجمالي المخزون والتكلفة يجمعان أرصدة الصنف؛ لا توجد تصفية فرع في هذا المسار. مخزون التجميع يحسب عبر خدمة التجميع.

active_total وinactive_total يحسبان بعد تطبيق المرشحات. لا توجد تصفية شركة إضافية داخل هذا التنفيذ؛ لا تفترض أن النتائج محصورة في شركة أو فرع السياق.

يتطلب inventory.item.view إضافة إلى المصادقة وسياسة API. رفض الصلاحية يعيد403 مع ok=false وmessage وrequired_permission.

التعامل مع الأخطاء