partner-choices

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

Authorization: Bearer <access_token>

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

مصادقة الإضافات

Authorization: HarplinkPlugin <client-uuid>.<secret>

يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:

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

{
  "results": [
    {
      "id": 123,
      "code": "C123",
      "name": "Example Customer",
      "legal_name": "",
      "type": 1,
      "branch_id": 2,
      "currency_id": 1,
      "currency_code": "IQD",
      "account_ar_id": 13,
      "account_ar_code": "1201",
      "account_ar_name": "Receivables",
      "account_ap_id": null,
      "account_ap_code": "",
      "account_ap_name": "",
      "phone": "",
      "email": ""
    }
  ]
}

نتائج فعالة في الشركة، ومقيدة بالفرع حين يتوفر. دون شركة تعاد قائمة فارغة.

customer وsupplier يشملان الأطراف ذات النوع both؛ البحث بالكود والاسم والاسم القانوني والهاتف والبريد.

الترتيب بالاسم ثم المعرف، limit الافتراضي 50 والحد الأعلى 200. لا يوجد cursor أو page.

401 لمصادقة مفقودة أو غير صالحة؛ 403 عند رفض نطاق الاعتماد أو صلاحية المستخدم. حقول الطلب غير الصالحة تعيد 400 عندما توجد قواعد تحقق.

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