#P1573

برگهٔ تازه

Route Info

Method	Endpoint	Controller
GET	/api/v2/salary/annual-obligation	OfficialController@salaryAnnualObligation

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

این متد اطلاعات مربوط به تعهدات مالی و پارامترهای محاسباتی حقوق و دستمزد (مانند پایه حقوق، سقف مالیاتی، حق مسکن و...) را برای یک سال مالی مشخص بازیابی می‌کند.

جستجو بر اساس سال: سیستم در جدول salary_annual_obligation رکوردهایی که فیلد year آن‌ها با ورودی کاربر مطابقت دارد را جستجو می‌کند.
بررسی وجود داده:
- اگر اطلاعاتی پیدا شود، لیست رکوردها بازگردانده می‌شود.
- اگر رکوردی برای سال مورد نظر وجود نداشته باشد، خروجی با status: false و پیام "There is no data available" ارسال می‌شود.

پارامترهای ورودی (Input Parameters)

نام پارامتر	نوع	الزامی؟	توضیحات
year	Integer	بله	سال مورد نظر برای دریافت تعهدات مالی (مثلاً 1403).

نمونه خروجی (Response)

{
    "status": true,
    "time": 1732629000,
    "data": [
        {
            "id": 5,
            "year": 1403,
            "min_salary": 70000000,
            "housing_allowance": 9000000,
            "description": "بخشنامه حقوق سال 1403",
            "created_at": "2024-03-20 10:00:00"
        }
    ]
}