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

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

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

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

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

تنزيل مرجع OpenAPI ↓

المخزون

warehouses_api

قراءة المخازن المتاحة للمستخدم

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

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

Authorization: Bearer <access_token>

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

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

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

200 OK
{
  "results": [
    {
      "id": 3,
      "code": "WH-01",
      "name": "Example Warehouse",
      "is_vehicle_warehouse": false,
      "branch_id": 1,
      "branch_name": "Example Branch",
      "inventory_account_id": 12,
      "inventory_account_name": "1101 - Inventory",
      "cogs_account_id": 13,
      "cogs_account_name": "5101 - Cost of sales",
      "allow_negative": false,
      "is_active": true,
      "address": "",
      "notes": "",
      "latitude": "",
      "longitude": "",
      "geofence_radius_m": 100,
      "access_instructions": ""
    }
  ]
}

هذا العقد يشرح GET فقط؛ POST لإنشاء المخزن عملية مستقلة لم تراجع هنا.

يتطلب inventory.warehouse.view. المستخدم العادي يرى المخازن ذات user_access/can_use مع شرط WarehouseAccessService.any_access_q؛ المدير العام لا يخضع لهذه التصفية.

لا توجد صفحة أو limit أو تصفية بحث في هذا التنفيذ. لا تفترض أن النتائج تقتصر على الفرع الحالي أو على المخازن الفعالة فقط.

إحداثيات الموقع نصوص؛ عند غياب الموقع تعاد نصوص فارغة ونصف قطر100. is_vehicle_warehouse يعتمد على ارتباط مركبة فعالة في وحدة salesforce.

الرفض من صلاحيات المخزن يعيد401 أو403 مع ok=false وmessage؛ قد تستخدم طبقة الحماية العامة detail قبل الوصول إلى العملية.

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

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

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

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

TRY THIS ENDPOINT

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

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

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

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

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

cURL

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