#P1599
GET /v2/accounting/account/get
Route Info
| Method | Endpoint | Controller |
| GET | /v2/accounting/account/get | AccountingController@getAccountInTreeView |
شرح عملکرد (Functionality)
این مسیر برای دریافت جزئیات یک حساب درخت حسابداری استفاده میشود. با توجه به پارامتر type که میتواند یکی از سه مقدار group، general یا moeen باشد، اطلاعات از جداول مرتبط استخراج شده و ساختار داده متناسب بازگردانده میشود.
اطلاعات بازگشتی شامل:
- کد حساب (code + public_code)
- عنوان فارسی و انگلیسی
- ماهیت (nature)
- وضعیت (status)
- برای سطوح پایینتر، اطلاعات والد (parent)
- برای معین (moeen): تنظیمات اضافی مانند bill، detailed_first و ...
پارامترهای ورودی (Query Params)
/v2/accounting/account/get?type=TYPE&id=ID
- type (الزامی): یکی از مقادیر
group،generalیاmoeen - id (الزامی): شناسه حساب
خروجی موفق (Success Response)
نمونه پاسخ برای نوع Group
{
"status": true,
"time": 1718449999,
"data": {
"id": 3,
"type": "group",
"code": "11",
"public_code": "11",
"title_fa": "دارایی",
"title_en": "Assets",
"nature": 1,
"status": 1
}
}
نمونه پاسخ برای نوع General
{
"status": true,
"time": 1718449999,
"data": {
"parent": {
"type": "group",
"code": "11",
"public_code": "11",
"id": 3,
"title": { "fa": "دارایی", "en": "Assets" }
},
"id": 18,
"type": "general",
"code": "02",
"public_code": "1102",
"title_fa": "موجودی کالا",
"title_en": "Inventory",
"nature": 1,
"status": 1
}
}
نمونه پاسخ برای نوع Moeen
{
"status": true,
"time": 1718449999,
"data": {
"parent": {
"type": "general",
"code": "02",
"public_code": "1102",
"id": 18,
"title": { "fa": "موجودی کالا", "en": "Inventory" }
},
"id": 51,
"type": "moeen",
"code": "005",
"public_code": "1102005",
"title_fa": "موجودی انبار مرکزی",
"title_en": "Main Warehouse",
"nature": 1,
"nature_check": 1,
"currency": 1,
"aggregation": 0,
"bill": [ ... ],
"detailed_first": null,
"detailed_second": null,
"detailed_third": null,
"detailed_fourth": null,
"status": 1
}
}
خروجی خطا (Error Response)
در صورت بروز خطا مانند عدم یافتن رکورد یا خطای دیتابیس:
{
"status": false,
"time": 1718449999,
"code": 5005,
"message": "Error message...",
"trace": [ ... ]
}