Skip to main content
#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": [ ... ]
}