تخطَّ إلى المحتوى
دُرج

واجهة المخزون

مستويات المخزون

GET /api/v1/inventory

ترجع مستويات المخزون الحالية لجميع المنتجات ومتغيراتها.

الاستجابة

{
  "data": [
    {
      "product_id": "prod-uuid-1",
      "product_name": "Premium Arabic Coffee",
      "sku": "COF-001",
      "stock": 150,
      "variants": [
        {
          "variant_id": "var-uuid-1",
          "variant_name": "250g",
          "sku": "COF-001-250",
          "stock": 80
        }
      ],
      "last_modified": "2026-04-20T10:30:00Z"
    }
  ]
}

حركات المخزون

GET /api/v1/inventory/movements

ترجع سجل تدقيق تغييرات المخزون.

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

المعاملالنوعالوصف
limitintegerعدد العناصر في الصفحة (1-200، الافتراضي 50)
product_idstringتصفية حسب المنتج
sincestringالحركات بعد هذا التاريخ بتنسيق ISO فقط

أسباب الحركة

السببالوصف
saleانخفاض المخزون بسبب طلب
refundاستعادة المخزون بسبب استرجاع
cancelاستعادة المخزون بسبب إلغاء
adjustmentتعديل يدوي للمخزون
bulk_importاستيراد جماعي عبر CSV