دریافت لیست پرسنلGET

این درخواست جهت دریافت لیست پرسنل استفاده می‌شود. برای استفاده از فیلتر پرسنل در سایر درخواست ها میتوانید از این آدرس جهت دریافت آیدی پرسنل استفاده نمایید.

ساختار URL

https://attapi.finto.ir/api/v1/custom/persons

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

Query Params

پارامترنوعمقداروضعیتتوضیحات
is_activeNumber0/1اختیاریبرای دریافت لیست پرسنل فعال/غیرفعال

پارامترهای پاسخ

پارامترنوعتوضیحات
idStringآیدی پرسنل
first_nameStringنام پرسنل
last_nameStringنام خانوادگی پرسنل
personnel_codeStringکد پرسنلی
is_activeBoolean وضعیت فعال بودن کاربر: true به معنی فعال و false به معنی غیر فعال بودن پرسنل
job_titleStringعنوان شغلی
shift.idStringآیدی شیفت
shift.nameStringنام شیفت
shift.typeNumberنوع شیفت: 1 به معنای عادی و 2 به معنای ساعتی

پاسخ

{
    "data": [
        {
            "id": "694931ca8d7500d68d0558f5",
            "first_name": "حسین",
            "last_name": "حامدی",
            "personnel_code": "123",
            "is_active": true,
            "job_title": "مهندس",
            "shift": {
                "id": "5e3811341bdbb809d9743a43",
                "name": "شیفت اداری",
                "type": 1
            }
        },
        {
            "id": "6684fd67f701f418c40c2311",
            "first_name": "علی",
            "last_name": "علوی",
            "personnel_code": "84",
            "is_active": true,
            "job_title": null,
            "shift": {
                "id": "5e3811341bdbb809d9743a43",
                "name": "شیفت اداری",
                "type": 1
            }
        }
      ]
}

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی
دریافت نوع درخواست هاGET

این درخواست جهت دریافت فهرست انواع درخواست‌های قابل ثبت در سامانه حضور و غیاب استفاده می‌شود.

ساختار URL

https://attapi.finto.ir/api/v1/custom/request-config

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

پارامترهای پاسخ

پارامترنوعتوضیحات
category_nameStringنام فارسی دسته بندی درخواست
category_enNameStringنام انگلیسی دسته بندی درخواست
category_itemsArray Of Objectآیتم های هر دسته بندی درخواست
category_items[*].enNameStringنام انگلیسی آیتم درخواست
category_items[*].fa_nameStringنام فارسی آیتم درخواست
category_items[*].configsArray Of Objectآرایه ای از کانفیگ های درخواست
category_items[*].configs[*].typeStringنوع درخواست (daily:روزانه , hourly:ساعتی)
category_items[*].configs[*].fa_nameStringنام فارسی درخواست
category_items[*].configs[*].enNameStringنام انگلیسی درخواست
category_items[*].configs[*].is_activeBooleanوضعیت فعال بودن درخواست (true:فعال , false:غیرفعال)

پاسخ

[
    {
        "category_name": "مرخصی",
        "category_enName": "vacation",
        "category_items": [
            {
                "enName": "vacation",
                "fa_name": "مرخصی استحقاقی",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "مرخصی استحقاقی روزانه",
                        "enName": "vacation",
                        "is_active": true
                    },
                    {
                        "type": "hourly",
                        "fa_name": "مرخصی استحقاقی ساعتی",
                        "enName": "vacation",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "sick_leave",
                "fa_name": "مرخصی استعلاجی",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "مرخصی استعلاجی روزانه",
                        "enName": "sick_leave",
                        "is_active": true
                    },
                    {
                        "type": "hourly",
                        "fa_name": "مرخصی استعلاجی ساعتی",
                        "enName": "sick_leave",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "unpaid_vacation",
                "fa_name": "مرخصی بی‌حقوق",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "مرخصی بی‌حقوق روزانه",
                        "enName": "unpaid_vacation",
                        "is_active": true
                    },
                    {
                        "type": "hourly",
                        "fa_name": "مرخصی بی‌حقوق ساعتی",
                        "enName": "unpaid_vacation",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "3HfyxVFFaE",
                "fa_name": "مرخصی تشویقی",
                "configs": [
                    {
                        "type": "hourly",
                        "fa_name": "مرخصی تشویقی (ساعتی)",
                        "enName": "3HfyxVFFaE",
                        "is_active": true
                    }
                ]
            }
        ]
    },
    {
        "category_name": "ماموریت",
        "category_enName": "mission",
        "category_items": [
            {
                "enName": "mission",
                "fa_name": "ماموریت",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "ماموریت روزانه",
                        "enName": "mission",
                        "is_active": true
                    },
                    {
                        "type": "hourly",
                        "fa_name": "ماموریت ساعتی",
                        "enName": "mission",
                        "is_active": true
                    }
                ]
            }
        ]
    },
    {
        "category_name": "اضافه کار",
        "category_enName": "add_work",
        "category_items": [
            {
                "enName": "add_work",
                "fa_name": "اضافه کار",
                "configs": [
                    {
                        "type": "hourly",
                        "fa_name": "اضافه کار",
                        "enName": "add_work",
                        "is_active": true
                    }
                ]
            }
        ]
    },
    {
        "category_name": "تردد",
        "category_enName": "entrance",
        "category_items": [
            {
                "enName": "entrance",
                "fa_name": "تردد دستی",
                "configs": [
                    {
                        "type": "other",
                        "fa_name": "تردد دستی",
                        "enName": "entrance",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "project_entrance",
                "fa_name": "تردد دستی پروژه",
                "configs": [
                    {
                        "type": "other",
                        "fa_name": "تردد دستی پروژه",
                        "enName": "project_entrance",
                        "is_active": true
                    }
                ]
            }
        ]
    },
    {
        "category_name": "سایر",
        "category_enName": "other",
        "category_items": [
            {
                "enName": "change_shift",
                "fa_name": "جابجایی شیفت",
                "configs": [
                    {
                        "type": "other",
                        "fa_name": "جابجایی شیفت",
                        "enName": "change_shift",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "compensate",
                "fa_name": "تهاتر",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "تهاتر",
                        "enName": "compensate",
                        "is_active": true
                    }
                ]
            },
            {
                "enName": "holiday",
                "fa_name": "روز تعطیل",
                "configs": [
                    {
                        "type": "daily",
                        "fa_name": "روز تعطیل",
                        "enName": "holiday",
                        "is_active": true
                    }
                ]
            }
        ]
    }
]

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی
دریافت لیست درخواست هاGET

این درخواست جهت دریافت فهرست درخواست‌های ثبت‌شده پرسنل استفاده می‌شود. درخواست‌ها می‌تواند شامل مرخصی، مأموریت، اضافه‌کار، تردد و سایر درخواست‌ها باشد. همچنین با استفاده از مقادیر پارامترهای ورودی میتوانید درخواست ها را در بازه مشخص،براساس پرسنل،گروه شغلی ،نوع درخواست و وضعیت فیلتر نمایید.

ساختار URL

https://attapi.finto.ir/api/v1/custom/requests

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

Query Params

پارامترنوعمقداروضعیتتوضیحات
fromString-اجباری تاریخ شروع بازه برای دریافت اطلاعات باید به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404
toString-اجباری تاریخ پایان بازه برای دریافت اطلاعات باید به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404
groupsArray of String-اجباریآرایه ای شامل گروه شغلی
personsArray of String-اجباریآرایه ای شامل کد پرسنلی پرسنل
statusNumber-اجباری 0:در دست بررسی , 1: تایید شده , 2:رد شده , 3: در جریان
typeArray of String-اجباری آرایه ای از نام انگلیسی درخواست ها(مراجعه شود به لیست نوع درخواست ها)

پارامترهای پاسخ

پارامترنوعتوضیحات
idStringآیدی درخواست
titleStringعنوان درخواست
person.idStringآیدی پرسنل
person.first_nameStringنام پرسنل
person.last_nameStringنام خانوادگی پرسنل
person.personnel_codeStringکد پرسنلی
person_toString در صورت درخواست جابه جایی شیفت این پارامتر مشخص کننده آیدی شخصی است که با آن شخص درخواست جابه جایی شیفت داده شده است.
shift_toString در صورت درخواست تعویض شیفت این پارامتر مشخص کننده آیدی شیفتی است که با آن شیفت درخواست تعویض شیفت داده شده است.
from_dateStringتاریخ شروع درخواست
to_dateStringتاریخ پایان درخواست
entrance_typeString در صورت درخواست تردد این پارامتر معین کننده نوع تردد است که 0 یعنی خروج و 1 یعنی ورود
descriptionStringتوضیحات درخواست
statusString 0:در دست بررسی , 1: تایید شده , 2:رد شده , 3: در جریان
has_attachNumber0: عدم وجود پیوست , 1: دارای پیوست
created_atStringتاریخ ایجاد درخواست
latitudeStringعرض جغرافیایی انتخاب شده در ثبت درخواست توسط پرسنل
longitudeStringطول جغرافیایی انتخاب شده در ثبت درخواست توسط پرسنل
work_flowArray Of Object در صورت دارا بودن سلسله مراتب آرایه ای از اطلاعات سلسله مراتبی گروه شغلی پرسنل درخواست دهنده را میدهد.
work_flow[*].idString آیدی گروه شغلی بالارده گروه شغلی پرسنل درخواست دهنده
work_flow[*].timeString در صورت وجود سلسله مراتب تایید/رد درخواست ها جریان کاری درخواست در این بخش قابل مشاهده هست.
work_flow[*].descriptionStringاسم گروه شغلی در سلسله مراتب
work_flow[*].statusNumber 0:در دست بررسی , 1: تایید شده , 2:رد شده , 3: در جریان
work_flow[*].notationStringتوضیحات رد درخواست در صورت رد شدن درخواست
filesArray Of Objectآرایه ای از پیوست های آپلود شده درخواست ها

پاسخ

{
    "data": [
        {
            "id": "697074af34f300cc280146de",
            "title": "مرخصی استحقاقی ساعتی",
            "person": {
                "id": "5ed3b584f180624c1d141112",
                "first_name": "علی",
                "last_name": "محمدی",
                "personnel_code": "565656"
            },
            "person_to": null,
            "shift_to": null,
            "from_date": "1404/11/01 12:00",
            "to_date": "1404/11/01 14:00",
            "entrance_type": null,
            "description": null,
            "status": "0",
            "has_attach": 0,
            "created_at": "1404/11/01 10:09",
            "latitude": null,
            "longitude": null,
            "work_flow": [
                {
                    "id": "697074af34f300cc280146df",
                    "time": "1404/11/01 10:39",
                    "description": "بخش پشتیبانی",
                    "status": 3,
                    "notation": null
                },
                {
                    "id": "697074af34f300cc280146e0",
                    "time": null,
                    "description": "بخش آی تی",
                    "status": 0,
                    "notation": null
                }
            ],
            "disable": false,
            "files": null,
            "distance": null
        }
      
    ]
}

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی
درخواست دریافت تایم‌شیت در بازه مشخصPOST

این درخواست جهت دریافت تایم‌شیت (خلاصه کارکرد روزانه) پرسنل در یک بازه زمانی مشخص استفاده می‌شود. خروجی این درخواست شامل ترددها، حضور، غیبت، اضافه‌کار، مرخصی و سایر آیتم‌های مؤثر در کارکرد است.

ساختار URL

https://attapi.finto.ir/api/v1/custom/{from}/{to}/timesheet

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

URL Params

پارامترنوعمقداروضعیتتوضیحات
fromString-اجباری تاریخ شروع بازه برای دریافت اطلاعات باید به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404
toString-اجباری تاریخ پایان بازه برای دریافت اطلاعات باید به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404

Body

پارامترنوعمقداروضعیتتوضیحات
personsArray of String-اجباریآرایه ای از آیدی های پرسنل

پارامترهای پاسخ

پارامترنوعتوضیحات
person_idStringآیدی پرسنل
person_nameStringنام پرسنل
personnel_codeStringکد پرسنلی
timesheetArray Of Objectاطلاعات کارکرد پرسنل
dateStringتاریخ روز گزارش گیری شده
dayStringروز هفته
day_FridayNumber در صورت جمعه کاری، 1 نمایش داده میشود و در غیر اینصورت 0
entrancesArrayآرایه ای از تردد ها
sum_friday_holiday_add_workObjectجمع جمعه کاری و تعطیل کاری به ساعت و دقیقه
total_add_work_timeObject جمع اضافه کاری جمعه، اضافه کاری و اضافه کاری تعطیل به ساعت و دقیقه
friday_work_timeObjectجمعه کاری به ساعت و دقیقه
holiday_add_work_timeObjectاضافه کاری روز تعطیل به ساعت و دقیقه
total_timeObjectکل حضور به ساعت و دقیقه
unpaid_vacation_timeObjectمرخصی بدون حقوق به ساعت و دقیقه
sick_leave_timeObjectمرخصی استعلاجی به ساعت و دقیقه
vacation_timeObjectمرخصی استحقاقی به ساعت و دقیقه
mission_timeObjectماموریت به ساعت و دقیقه
extra_add_work_timeObjectمازاد حضور به ساعت و دقیقه
add_work_timeObjectاضافه کاری به ساعت و دقیقه
nightwork_timeObjectشبکاری به ساعت و دقیقه
shift_duty_timeObjectموظفی به ساعت و دقیقه
total_absentObjectجمع غیبت و کسری کار به ساعت و دقیقه
absent_timeObjectکسری کار به ساعت و دقیقه
present_timeObjectحضور در شیفت به ساعت و دقیقه
absenceNumberغیبت به روز
سایر پارامتر ها (مانند 3HfyxVFFaE)Objectبه پاسخ لیست درخواست ها مراجعه شود.

پاسخ

{
    "data": [
        {
            "person_id": "5ed3b584f180624c1d141112",
            "personnel_code": "565656",
            "person_name": "علی حامدی",
            "timesheet": [
                {
                    "date": "1404/10/01",
                    "day": "دوشنبه",
                    "type": 1,
                    "holiday": {
                        "is_holiday": false,
                        "text": null
                    },
                    "absence": 1,
                    "present_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "absent_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "total_absent": {
                        "hour": "09",
                        "minute": "00"
                    },
                    "shift_duty_time": {
                        "hour": "09",
                        "minute": "00"
                    },
                    "nightwork_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "add_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "extra_add_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "mission_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "vacation_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "sick_leave_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "unpaid_vacation": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "unpaid_vacation_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "total_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "holiday_add_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "friday_add_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "friday_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "total_add_work_time": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "sum_friday_holiday_add_work": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "extra_compensate": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "miss_compensate": {
                        "hour": "00",
                        "minute": "00"
                    },
                    "day_friday": 0,
                    "entrances": [],
                    "daily_violation": 0,
                    "weekly_violation": 0,
                    "six_days_violation": 0,
                    "3HfyxVFFaE": {
                        "hour": "00",
                        "minute": "00"
                    }
                }
            ]
        }
    ]
}

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی
دریافت گزارش کارکرد پرسنل در بازه مشخصPOST

این درخواست جهت دریافت اطلاعات ترددهای ثبت‌شده پرسنل در یک بازه زمانی مشخص استفاده می‌شود. داده‌های خروجی شامل ورود، خروج، نوع ثبت تردد و وضعیت آن بوده و برای محاسبه کارکرد، گزارش‌گیری و کنترل عملکرد پرسنل کاربرد دارد.

ساختار URL

https://attapi.finto.ir/api/v1/custom/{from}/{to}/worktimes/report

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

URL Params

پارامترنوعمقداروضعیتتوضیحات
fromString-اجباری تاریخ شروع بازه گزارش گیری به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404
toString-اجباری تاریخ پایان بازه گزارش گیری به فرمت YYYY-MM-DD باشد (تاریخ شمسی) مثال: 10-01-1404

Body

پارامترنوعمقداروضعیتتوضیحات
personsArray Of String-اختیاریآرایه ای از آیدی های پرسنل

پارامترهای پاسخ

پارامترنوعتوضیحات
idStringآیدی پرسنل
first_nameStringنام پرسنل
last_nameStringنام خانوادگی پرسنل
personnel_codeStringکد پرسنلی پرسنل
melli_codeStringکد ملی پرسنل
day_FridayNumberتعداد جمعه کاری به روز
sum_friday_holiday_add_workObjectجمع جمعه کاری و تعطیل کاری به ساعت و دقیقه
total_add_work_timeObject جمع اضافه کاری جمعه، اضافه کاری و اضافه کاری تعطیل به ساعت و دقیقه
friday_work_timeObjectجمعه کاری به ساعت و دقیقه
holiday_add_work_timeObjectاضافه کاری روز تعطیل به ساعت و دقیقه
total_timeObjectکل حضور به ساعت و دقیقه
unpaid_vacation_timeObjectمرخصی بدون حقوق به ساعت و دقیقه
sick_leave_timeObjectمرخصی استعلاجی به ساعت و دقیقه
vacation_timeObjectمرخصی استحقاقی به ساعت و دقیقه
mission_timeObjectماموریت به ساعت و دقیقه
extra_add_work_timeObjectمازاد حضور به ساعت و دقیقه
add_work_timeObjectاضافه کاری به ساعت و دقیقه
nightwork_timeObjectشبکاری به ساعت و دقیقه
shift_duty_timeObjectموظفی به ساعت و دقیقه
total_absentObjectجمع غیبت و کسری کار به ساعت و دقیقه
absent_timeObjectکسری کار به ساعت و دقیقه
present_timeObjectحضور در شیفت به ساعت و دقیقه
absenceNumberغیبت به روز
day_workNumberکارکرد به روز
p_day_workNumberکارکرد با احتساب روز بدون شیفت

پاسخ

{
    "data": [
        {
            "id": "5ed3b584f180624c1d141112",
            "first_name": "علی",
            "last_name": "حامدی",
            "personnel_code": "565656",
            "melli_code": "0860503623",
            "present_time": {
                "hour": "00",
                "minute": "00"
            },
            "absent_time": {
                "hour": "00",
                "minute": "00"
            },
            "absence": 1,
            "total_absent": {
                "hour": "09",
                "minute": "00"
            },
            "nightwork_time": {
                "hour": "00",
                "minute": "00"
            },
            "add_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "shift_duty_time": {
                "hour": "09",
                "minute": "00"
            },
            "mission_time": {
                "hour": "00",
                "minute": "00"
            },
            "vacation_time": {
                "hour": "00",
                "minute": "00"
            },
            "sick_leave_time": {
                "hour": "00",
                "minute": "00"
            },
            "unpaid_vacation": {
                "hour": "00",
                "minute": "00"
            },
            "extra_add_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "total_time": {
                "hour": "00",
                "minute": "00"
            },
            "holiday_add_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "friday_add_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "friday_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "total_add_work_time": {
                "hour": "00",
                "minute": "00"
            },
            "sum_friday_holiday_add_work": {
                "hour": "00",
                "minute": "00"
            },
            "extra_compensate": {
                "hour": "00",
                "minute": "00"
            },
            "miss_compensate": {
                "hour": "00",
                "minute": "00"
            },
            "day_friday": 0,
            "day_work": 0,
            "p_day_work": 0,
            "3HfyxVFFaE": {
                "hour": "00",
                "minute": "00"
            }
        }
    ]
}

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی
لیست گروه های شغلی GET

این درخواست جهت دریافت فهرست گروه‌های شغلی تعریف‌شده در سامانه حضور و غیاب استفاده می‌شود. گروه شغلی مبنای دسته‌بندی پرسنل از نظر قوانین کارکرد، شیفت، اضافه‌کار و سایر محاسبات مرتبط است.

ساختار URL

https://attapi.finto.ir/api/v1/custom/groups

Header

پارامترنوعمقداروضعیتتوضیحات
tokenString-اجباریتوکن دریافتی کاربر

پارامترهای پاسخ

پارامترنوعتوضیحات
idStringآیدی گروه شغلی
nameStringنام گروه شغلی
parent_id.idStringآیدی گروه شغلی parent
parent_id.nameStringنام گروه شغلی parent

پاسخ

{
    "data": [
        {
            "id": "61f8ca7230ecd347ce4ff400",
            "name": "بخش آی تی",
            "parent_id": {
                "id": "679922d8a993f534620c05a8",
                "name": "منابع انسانی"
            }
        },
        {
            "id": "61f8cb61eee273632152cb07",
            "name": "بخش پشتیبانی",
            "parent_id": {
                "id": "679922d8a993f534620c05a8",
                "name": "منابع انسانی"
            }
        },
        {
            "id": "61f8cb61eeasdzxcassedf12312",
            "name": "منابع انسانی",
            "parent_id": null
        },
    ]
}

جدول خطاها

کدتوضیحات
401خطای احراز هویت
422خطای مقادیر ورودی