#P1583
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",
// ...
}
]