POST /v2/accounts/list

Route Info 

 

 

 

 

 

 Method 

 Endpoint 

 Controller 

 

 

 POST 

 /v2/accounts/list 

 AccountingController@accountsList 

 

 

 

 

 

 شرح عملکرد (Functionality) 

 این متد لیست حساب‌های بانکی/مالی فعال مربوط به شعبه کاربر جاری را برمی‌گرداند و اطلاعات حساب را با اطلاعات بانک عامل ادغام می‌کند. 

 

 

 فیلترینگ داده‌ها: 

 

 فقط حساب‌های فعال ( status = 1 ). 

 فقط حساب‌های متعلق به شعبه جاری کاربر ( branch = request->branch ). 

 

 

 الحاق اطلاعات بانک (Left Join): جدول حساب‌ها ( accounting_accounts ) با جدول بانک‌ها ( accounting_banks ) الحاق می‌شود تا نام فارسی بانک و لوگوی آن دریافت شود. نکته: فیلد title در خروجی، در واقع همان accounting_banks.title_fa است (مگر اینکه خود جدول اکانت هم فیلد تایتل داشته باشد که باعث هم‌پوشانی می‌شود). 

 

 

 ساختار خروجی (Response) 

 توجه: برخلاف سایر متدها، این متد مستقیماً یک آرایه (Array) برمی‌گرداند و فاقد کلیدهای استاندارد status یا data است. 

 [

 {

 "id": 105,

 "branch": 2,

 "bank": 12, // شناسه بانک در جدول accounting_banks

 "account_number": "123-456-789",

 "sheba": "IR000000000000000000",

 "status": 1,

 "title": "بانک ملت", // برگرفته از title_fa جدول بانک‌ها

 "logo": "mellat.png", // برگرفته از جدول بانک‌ها

 "balance": 5000000, // سایر فیلدهای جدول اکانت...

 "pos_device": 1

 },

 {

 "id": 106,

 "branch": 2,

 "bank": 4,

 "title": "بانک پاسارگاد",

 "logo": "pasargad.png",

 // ...

 }

]