HARPLINK ↗HARPLINK DEVELOPERSمساحة المطور ↗متجر التطبيقات ↗
OFFICIAL SANDBOX

جرّب الربط على بيئة HARPLINK التجريبية

https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo

بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.

اختر العملية وافحصها من المتصفح ←

تنزيل مرجع OpenAPI ↓

المخزون

warehouses_lookup

اختيار المخازن حسب الإجراء والفرع

دليل العملية
GET
/inventory/api/warehouses/lookup/
AUTHENTICATION

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

Authorization: Bearer <access_token>

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

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

المعلمةالتفاصيل
qstringبحث في الاسم والكود واسم الفرع والعنوان والملاحظات.
actionstringالإجراء المطلوب؛ الافتراضي view. يستخدم WarehouseAccessService لتصفية الوصول.
enforce_accessstring1 أو true أو yes أو on لفرض تصفية صلاحيات المخزن في قوائم التحويل.
branch_idintegerمعرف فرع اختياري؛ القيمة غير الرقمية لا تطبق المرشح.
branch_scopestringagency للوكالات؛ branch لغير الوكالات.

استجابة توضيحية

200 OK
[
  {
    "id": 3,
    "code": "WH-01",
    "name": "Example Warehouse",
    "branch_id": 1,
    "branch_name": "Example Branch",
    "branch_type": "BRANCH",
    "address": "",
    "text": "WH-01 - Example Warehouse - Example Branch",
    "is_vehicle_warehouse": false
  }
]

الاستجابة مصفوفة مباشرة وليست كائناً يحتوي results. مخازن فعالة مرتبة بالكود فقط.

بحد أقصى30 نتيجة عند تطبيق تصفية صلاحيات المخزن. إجراءات transfer_from وtransfer_to وreceive_transit تعرض مخازن الاختيار دون تلك التصفية أو الحد، ما لم يكن enforce_access=true.

رؤية مخزن في قائمة التحويل لا تمنح حق تنفيذ التحويل؛ عملية التحويل نفسها تتحقق من الصلاحيات. استخدم enforce_access=true إذا احتجت قائمة مصفاة.

لا يوجد page أو cursor. المعرف id للربط، والكود للعرض؛ branch_scope=branch يستبعد نوع AGENCY.

هذا المسار يستخدم المصادقة والسياسة العامة وصلاحيات الوصول للمخزن؛ لا يضيف شرط inventory.warehouse.view مباشراً. لا يفترض حصر الشركة من هذه الدالة وحدها.

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

400راجع بيانات الطلب
401أعد المصادقة
403راجع صلاحية الحساب
429انتظر قبل إعادة المحاولة
REQUEST BUILDER

جهّز مثال الربط

خصّص المعلمات وانسخ المثال إلى تطبيقك.

إضافة معلمات استعلام
TRY THIS ENDPOINT

جرّب الطلب على نظام ERP الخاص بك

الحصول على توكن من المتصفح

أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.

أدخل التوكن أو client-uuid.secret بدون اسم نوع المصادقة. يُستخدم لهذا الطلب ولا يُحفظ في المتصفح.

يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.

cURL

مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.