Skip to main content
#P1607

GET /v2/accounting/closing

Route Info

Method Endpoint Controller Middleware
GET /v2/accounting/closing AccountingController@showClosingAccount authWithJwt

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

این مسیر اطلاعات مربوط به تاریخ پایان دوره مالی بسته شده را برای دفتر (Branch/Office) فعلی برمی‌گرداند. داده‌ها از جدول office_config خوانده می‌شوند و مقدار کلید END_OF_FINANCIAL_PERIOD_CLOSING_ACCOUNTS بررسی می‌شود. در صورت وجود مقدار، تنها سال و ماه از آن جدا و بازگردانده می‌شود.

تابع کمکی Functions::officeConfig($office, $key) وظیفه دارد مقدار تنظیم دفتر را از جدول office_config بخواند. اگر چیزی یافت نشود، مقدار false برمی‌گردد.

این مسیر برای کنترل دوره‌های مالی در مسیرهای دیگر (مثل ثبت یا حذف سند) کاربرد دارد تا مانع عملیات بعد از تاریخ بسته شدن شود.

فرآیند محاسباتی (Logic Steps)

  1. دریافت شناسه شعبه با کلید branch از Query String یا Token.
  2. فراخوانی تابع officeConfig(branch, 'END_OF_FINANCIAL_PERIOD_CLOSING_ACCOUNTS').
  3. اگر مقدار موجود بود، رشته خروجی مثلاً 14040301 به قالب JSON تبدیل می‌شود:
    • year = 1404
    • month = 03
  4. در غیر این صورت مقدار null برای payload برگردانده می‌شود.

پاسخ موفق (Success Response)

{
  "payload": {
    "year": "1404",
    "month": "03"
  },
  "meta": {
    "timestamp": 1733053000
  }
}

پاسخ در صورت نبود تنظیمات

اگر مقدار در جدول تنظیمات یافت نشود:

{
  "payload": null,
  "meta": {
    "timestamp": 1733053000
  }
}

وابستگی دیتابیس (Database Dependency)

Table Key Description
office_config END_OF_FINANCIAL_PERIOD_CLOSING_ACCOUNTS تاریخ بسته شدن حساب‌های دوره مالی (فرمت: YYYYMMDD)

توابع کمکی استفاده شده (Helper Functions)

static function officeConfig($office, $key)
{
    return DB::table('office_config')
             ->where('office', $office)
             ->where('key', strtoupper($key))
             ->value('value') ?: false;
}

اطلاعات تکمیلی (Meta)

  • HTTP Status Code: 200 در همه حالات (حتی بدون داده)
  • Authentication: لازم است (JWT Token)
  • Dependency: Redis ندارد – کاملاً DB-driven
Back to top