partner_api_list

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

Authorization: Bearer <access_token>

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

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

{
  "ok": true,
  "data": [
    {
      "id": 123,
      "code": "C-00123",
      "name": "Example Customer",
      "image_url": "",
      "purchase_display_name": "Example Customer",
      "legal_name": "",
      "partner_type": 1,
      "partner_type_name": "Customer",
      "phone": "",
      "phone_secondary": "",
      "address": "",
      "address_line2": "",
      "email": "",
      "tax_number": "",
      "currency": "IQD",
      "currency_id": 1,
      "credit_limit": "0",
      "enforce_credit_limit": false,
      "payment_terms": "",
      "sales_price_tier": 1,
      "is_active": true,
      "branch_name": "Example Branch",
      "account_ar": "",
      "account_ap": "",
      "accounts_ar": [],
      "accounts_ap": []
    }
  ],
  "meta": {
    "summary": {
      "total": 1,
      "customers": 1,
      "vendors": 0,
      "drivers": 0,
      "inactive": 0
    },
    "pagination": {
      "page": 1,
      "page_size": 25,
      "total": 1,
      "pages": 1,
      "has_previous": false,
      "has_next": false
    }
  }
}

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

تستخدم page ولا تستخدم cursor. الترتيب حسب الاسم ثم المعرف. 400 عند رقم صفحة أو حجم غير قابل للتحويل إلى عدد.

meta.summary محسوبة بعد تصفية kind وقبل active وq؛ total في pagination يعبر عن النتائج بعد جميع الفلاتر.

credit_limit نص مالي. كل عنصر في accounts_ar وaccounts_ap يتضمن code وbranch_name وis_primary. الأمثلة توضيحية.

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