جرّب الربط على بيئة HARPLINK التجريبية
https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo
بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.
اختر العملية وافحصها من المتصفح ←warehouses_lookup
اختيار المخازن حسب الإجراء والفرع
/inventory/api/warehouses/lookup/الوصول والصلاحيات
Authorization: Bearer <access_token>يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.
معلمات الاستعلام
| المعلمة | التفاصيل |
|---|---|
qstring | بحث في الاسم والكود واسم الفرع والعنوان والملاحظات. |
actionstring | الإجراء المطلوب؛ الافتراضي view. يستخدم WarehouseAccessService لتصفية الوصول. |
enforce_accessstring | 1 أو true أو yes أو on لفرض تصفية صلاحيات المخزن في قوائم التحويل. |
branch_idinteger | معرف فرع اختياري؛ القيمة غير الرقمية لا تطبق المرشح. |
branch_scopestring | agency للوكالات؛ branch لغير الوكالات. |
[
{
"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انتظر قبل إعادة المحاولةجهّز مثال الربط
خصّص المعلمات وانسخ المثال إلى تطبيقك.
جرّب الطلب على نظام ERP الخاص بك
الحصول على توكن من المتصفح
أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.
يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.
ترويسات الاستجابة
مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.