المخزون
اقرأ المخزون وطبّق تعديلات وحدود بيع وحجوزات يدوية مضبوطة.
العمليات
عرض القائمة · المخزون — المخزونعرض مخزون المنتجات والمستودعات والمواقع الداخلية.
GET
إنشاء · تسوية المخزون — المخزونتغيير كميات المنتجات المادية والقابلة للبيع.
POST
جلب · المخزون — المخزونعرض مخزون المنتجات والمستودعات والمواقع الداخلية.
GET
تحديث · المخزون — المخزونتغيير كميات المنتجات المادية والقابلة للبيع.
PATCH
تحديث · الحجز اليدوي — المخزونتغيير الحجوزات اليدوية. لعمليات التكاملات الخارجية.
PATCH
تحديث · حد المبيعات — المخزونتغيير حدود البيع. لعمليات التكاملات الخارجية.
PATCH
إنشاء استيرادأنشئ مسودة تضم حتى 1000 رمز أو 100 ملف. لا يزيد المخزون المتاح للبيع في هذه المرحلة.
POST
إلغاء الاستيرادتخلّص من مسودة غير مكتملة. لا يسحب هذا الإجراء توريدًا تم تأكيده.
DELETE
قراءة الاستيرادتحقق من الحالة والإصدار ونتيجة التحقق. تنتمي المسودة إلى مفتاح API الذي أنشأها.
GET
تأكيد التوريدأنشئ توريدًا مخططًا أو مستلمًا من الدفعة المتحقق منها. الوحدات المخططة ليست متاحة للبيع بعد.
POST
استلام توريد مخططاستلم الوحدات الموجودة دون استيراد الرموز أو الملفات مرة أخرى.
POST
التحقق من الاستيرادتحقق من الدفعة كاملة. يرفض التكرار أو الإدخال غير الصحيح الدفعة، ولا تُقتطع الرموز.
POST
سحب توريداسحب الوحدات الحرة فقط. تبقى الوحدات المحجوزة والمخصصة مرتبطة بطلباتها.
POST
قراءة إعدادات المخزون الرقمياقرأ الإعدادات والكميات قبل تعديلها. لا تتضمن الاستجابة رموزًا أو محتوى ملفات.
GET
تعديل المخزون الرقميفعّل الرموز أو الملفات الفردية بدءًا من Professional. يحافظ التعطيل على الوصول إلى المشتريات السابقة.
PATCH
عرض الوحداتاقرأ حتى 100 وحدة في الصفحة. تعرض القائمة البيانات الوصفية دون كشف الرموز.
GET
تغيير ترتيب التخصيصأرسل الصفحة الكاملة دون تصفية بالترتيب المطلوب. يعيد الإصدار القديم 409.
POST
قراءة محتوى وحدة حرةيُعاد الرمز بصيغة JSON والملف كمحتوى ثنائي. يتطلب كل طلب Bearer وصلاحية reveal.
GET
التحقق من الوصول إلى وحدة حرةتحقق من صلاحيات GET نفسها دون تنزيل المحتوى. لا تُحجز الوحدة بهذه العملية.
HEAD
إزالة وحدة حرةأزل رمزًا أو ملفًا غير مباع مع ذكر السبب. تُرفض الوحدات المحجوزة أو المخصصة.
POST
استبدال وحدة حرةاستبدل الرمز أو الملف دون تغيير ترتيبه. يُحفظ التعديل في سجل المخزون.
POST
تجهيز رفع خاصاحجز مساحة لملف واربطه باستيراد أو بالوحدة المراد استبدالها.
POST
التحقق من الرفعتحقق من الحجم والمجموع الاختباري والصيغة. لا يعني اكتمال الرفع استلام التوريد.
GET
رفع ملفأرسل الملف بصيغة multipart/form-data عبر HTTPS. لا ترسل Base64 أو رابطًا لجلب الملف.
PUT
آلية العمل
تميّز سجلات المخزون بين الكمية الفعلية on_hand وحجوزات طلبات الشراء والحجوزات اليدوية والكمية المتاحة للبيع. استخدم معرّف المخزون وإصداره المعادين؛ فمخزون المنتج ومخزون المتغير هدفان منفصلان.
تعني sellable_limit بقيمة -1 عدم وجود حد، بينما تعني 0 عدم وجود توفر للبيع. يُمثّل التوفر غير المحدود بالقيمة null في available. لا تعامل null كصفر. تستخدم تعديلات المخزون وحدود البيع والحجوزات اليدوية عمليات وصلاحيات منفصلة.