OFFICIAL SANDBOX

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

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

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

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

تنزيل مرجع OpenAPI ↓

المبيعات

invoice_list_api

قراءة فواتير المبيعات مع البحث والتصفية والانتقال بين صفحات النتائج.

دليل العملية

GET

/sales/api/invoices/list/

AUTHENTICATION

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

Bearer Tokenكيف أحصل عليه؟ ↗

Authorization: Bearer <access_token>

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

sales.invoice.list

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

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

المعلمة	التفاصيل
`page_size`integer	عدد النتائج: من 10 إلى 100، الافتراضي 25.
`cursor`integer	استخدم next_cursor من الاستجابة السابقة لجلب الصفحة التالية.
`date_from`date	بداية فترة تاريخ الفاتورة بصيغة YYYY-MM-DD.
`date_to`date	نهاية فترة تاريخ الفاتورة بصيغة YYYY-MM-DD.
`search`string	البحث برقم الفاتورة أو اسم العميل.
`status`integer	0 مسودة، 1 معتمدة، 2 مرحّلة، 3 ملغاة.
`has_previous`string	أي قيمة غير فارغة تجعل has_previous تساوي true في الاستجابة.

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

200 OK

{
  "ok": true,
  "data": [
    {
      "id": 123,
      "inv_no": "INV-00123",
      "inv_date": "2026-10-07",
      "customer_name": "Example Customer",
      "status": 0,
      "total_bc": "150000.00"
    }
  ],
  "pagination": {
    "page_size": 25,
    "has_previous": false,
    "has_next": true,
    "next_cursor": 123
  }
}

النتائج مرتبة تنازلياً بالمعرف. أرسل cursor بقيمة next_cursor حتى تصبح has_next تساوي false.

تستخدم هذه العملية cursor، وليس page أو offset.

القيم التالية توضيحية. total_bc قيمة نصية؛ حافظ على دقة الأرقام المالية عند معالجتها.

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

400راجع بيانات الطلب

401أعد المصادقة

403راجع صلاحية الحساب

429انتظر قبل إعادة المحاولة

REQUEST BUILDER

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

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

TRY THIS ENDPOINT

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

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

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

اسم مستخدم ERP كلمة مرور ERP

قيمة اعتماد المصادقة المختارة

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

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

جسم الاستجابة

ترويسات الاستجابة

cURL

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

حقول ظاهرة في تنفيذ العملية

هذه أسماء مستخرجة من الكود، وقد توجد حقول إضافية أو شروط تعتمد على نوع العملية. راجع عقد العملية ونتيجة الفحص.

حقول الاستجابة

data message ok pagination