Skip to main content
#P1598

POST /v2/accounting/account/update

Route Info

Method Endpoint Controller
POST /v2/accounting/account/update AccountingController@updateAccountInTreeView

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

این مسیر برای ایجاد (store) یا ویرایش (update) اطلاعات حساب‌های درخت حسابداری مورد استفاده قرار می‌گیرد. در این متد سه نوع ساختار حسابداری پشتیبانی می‌شود:

  • گروه حسابداری (Group)
  • کل حسابداری (General)
  • معین حسابداری (Moeen)

نوع عملیات از طریق پارامتر action مشخص می‌شود:

  • store: ایجاد رکورد جدید
  • update: ویرایش رکورد موجود

ورودی‌ها در کلید data قرار می‌گیرند و بر اساس نوع حساب (type) عمل درج یا ویرایش روی یکی از جداول زیر انجام می‌شود:

  • accounting_groups
  • accounting_generals
  • accounting_moeens

در صورت بروز خطا، پیام و Trace کامل استثنا بازگردانده می‌شود.

پارامترهای ورودی (JSON Body)

ساختار کلی ورودی

{
  "action": "store | update",
  "id": 12,                   // فقط در حالت update
  "data": {
    "type": "group | general | moeen",
    "code": "112",
    "title_fa": "عنوان فارسی",
    "title_en": "English Title",
    "nature": 1,
    "status": 1,
    "...": "سایر فیلدهای ویژه نوع حساب"
  }
}

فیلدهای تکمیلی برای نوع General

  • group

فیلدهای تکمیلی برای نوع Moeen

  • general
  • nature_check
  • currency
  • aggregation
  • bill (JSON)
  • detailed_first (JSON)
  • detailed_second (JSON)
  • detailed_third (JSON)
  • detailed_fourth (JSON)

خروجی موفق (Success Response)

{
  "status": true,
  "time": 1718450000
}

خروجی خطا (Error Response)

در صورت بروز خطا (مانند خطای دیتابیس)، ساختار زیر بازگردانده می‌شود:

{
  "status": false,
  "time": 1718450000,
  "code": 5005,
  "message": "Exception message...",
  "trace": [ ... ]
}