Цагийн Тайлан

Цагийн тайлан гэдэг нь тухайн зааж өгсөн хоёр хугацааны хооронд сонгосон алба хэлтэсийн ажилтан эсвэл бүх ажилтан ажилдаа ирсэн цаг нь дэлгэрэнгүйгээр харагдана

https://api.timely.mn/v3/overview-attd

Хүсэлтэндээ хавсаргах зүйлс

  • Name
    company_register
    Type
    string
    Description

    Компаны регистрийн дугаар

  • Name
    div_id
    Type
    string
    Description

    Алба хэлтэсийн дугаар ( 0 бол бүх алба хэлтэс )

  • Name
    dateFrom
    Type
    String
    Description

    "2022-10-01" гэх хэв маягтай эхлэх хугацааг заана.

  • Name
    dateTo
    Type
    string
    Description

    "2022-10-01" гэх хэв маягтай дуусах хугацааг заана.

  • Name
    page
    Type
    integer
    Description

    Хуудаслалттай бол хэддүгээр хуудасыг харуулахыг заана. (optional)

  • Name
    limit
    Type
    integer
    Description

    Хуудаслалттай бол нэг хуудсанд хэдэн ажилтныг харуулахыг заана. (optional)

POST/v3/overview-attd

Цагийн тайланг авах

Энэ API нь POST хүсэлт явуулахдаа илгээсэн хүсэлтэнд хавсаргах зүйлсийг хүлээн авч, тухайн хугацаанд сонгосон алба хэлтэсийн ажилтан эсвэл бүх ажилтан ажилдаа хэр ирсэн нь дэлгэрэнгүйгээр харагдана.

Response тайлбар

  • Name
    workerId
    Type
    integer
    Description

    Timely-д бүртгэгдсэн ажилчны ID

  • Name
    division
    Type
    string
    Description

    Ажилтны алба нэгж.

  • Name
    position
    Type
    string
    Description

    Ажилтны албан тушаал

  • Name
    workerName
    Type
    string
    Description

    Ажилтны нэр.

  • Name
    register
    Type
    string
    Description

    Ажилтны регистрийн дугаар.

  • Name
    work_day
    Type
    integer
    Description

    Ажилтны ажиллах ёстой өдөр.

  • Name
    work_time
    Type
    integer
    Description

    Ажилтны ажиллах ёстой цаг.

  • Name
    holiday_day
    Type
    integer
    Description

    Баярын өдөр.

  • Name
    holiday_time
    Type
    integer
    Description

    Баярын цаг.

  • Name
    absent_day
    Type
    integer
    Description

    Тасалсан өдөр.

  • Name
    absent_time
    Type
    integer
    Description

    Тасалсан цаг.

  • Name
    late_day
    Type
    integer
    Description

    Хоцорсон өдөр.

  • Name
    late_time
    Type
    integer
    Description

    Хоцорсон цаг.

  • Name
    leave_day
    Type
    integer
    Description

    Эрт тарсан өдөр.

  • Name
    leave_time
    Type
    integer
    Description

    Эрт тарсан цаг.

  • Name
    half_day
    Type
    integer
    Description

    Тал ажилласан өдөр.

  • Name
    half_time
    Type
    integer
    Description

    Тал ажилласан цаг.

  • Name
    break_late_leave_day
    Type
    integer
    Description

    Цайны цагийн хоцорсон, эрт тарсан өдөр.

  • Name
    break_late_leave_time
    Type
    integer
    Description

    Цайны цагийн хоцорсон, эрт тарсан цаг.

  • Name
    worked_day
    Type
    integer
    Description

    Хуваарьт ажилласан өдөр.

  • Name
    worked_time
    Type
    integer
    Description

    Хуваарьт ажилласан цаг.

  • Name
    holiday_worked_day
    Type
    integer
    Description

    Баяраар ажилласан өдөр.

  • Name
    holiday_worked_time
    Type
    integer
    Description

    Баяраар ажилласан цаг.

  • Name
    actual_worked_day
    Type
    integer
    Description

    Амралтаар ажилласан өдөр.

  • Name
    actual_worked_time
    Type
    integer
    Description

    Амралтаар ажилласан цаг.

  • Name
    act_in_day
    Type
    integer
    Description

    Ирсэн идэвхийн өдөр.

  • Name
    act_in_time
    Type
    integer
    Description

    Ирсэн идэвхийн цаг.

  • Name
    act_out_day
    Type
    integer
    Description

    Явсан идэвхийн өдөр.

  • Name
    act_out_time
    Type
    integer
    Description

    Явсан идэвхийн цаг.

  • Name
    overtime_rest_day
    Type
    integer
    Description

    Илүү цагийн амралтын өдөр.

  • Name
    overtime_rest_time
    Type
    integer
    Description

    Илүү цагийн амралтын цаг.

  • Name
    app_leave_day
    Type
    integer
    Description

    Чөлөөний өдөр.

  • Name
    app_leave_time
    Type
    integer
    Description

    Чөлөөний цаг.

  • Name
    vacation_day
    Type
    integer
    Description

    Ээлжийн амралтын өдөр.

  • Name
    vacation_time
    Type
    integer
    Description

    Ээлжийн амралтын цаг.

  • Name
    assign_day
    Type
    integer
    Description

    Томилолтын өдөр.

  • Name
    assign_time
    Type
    integer
    Description

    Томилолтын цаг.

  • Name
    sick_day
    Type
    integer
    Description

    Өвчтэй байх өдөр.

  • Name
    sick_time
    Type
    integer
    Description

    Өвчтэй байх цаг.

  • Name
    offsite_day
    Type
    integer
    Description

    Гадуур ажиллах өдөр.

  • Name
    offsite_time
    Type
    integer
    Description

    Гадуур ажиллах цаг.

  • Name
    salary_leave_day
    Type
    integer
    Description

    Цалинтай амралтын өдөр.

  • Name
    salary_leave_time
    Type
    integer
    Description

    Цалинтай амралтын цаг.

  • Name
    remote_day
    Type
    integer
    Description

    Гэрээс ажиллах өдөр.

  • Name
    remote_time
    Type
    integer
    Description

    Гэрээс ажиллах цаг.

  • Name
    rooster_rest_day
    Type
    integer
    Description

    Ростерын амралтын өдөр.

  • Name
    rooster_rest_time
    Type
    integer
    Description

    Ростерын амралтын цаг.

  • Name
    planned_rest_day
    Type
    integer
    Description

    Төлөвлөгөөт амралтын өдөр.

  • Name
    planned_rest_time
    Type
    integer
    Description

    Төлөвлөгөөт амралтын цаг.

  • Name
    road_day
    Type
    integer
    Description

    Замд байх өдөр.

  • Name
    road_time
    Type
    integer
    Description

    Замд байх цаг.

  • Name
    replace_worker_day
    Type
    integer
    Description

    Орлон ажиллах өдөр.

  • Name
    replace_worker_time
    Type
    integer
    Description

    Орлон ажиллах цаг.

  • Name
    course_day
    Type
    integer
    Description

    Сургалтын өдөр.

  • Name
    course_time
    Type
    integer
    Description

    Сургалтын цаг.

  • Name
    patrol_day
    Type
    integer
    Description

    Эргүүл хийх өдөр.

  • Name
    patrol_time
    Type
    integer
    Description

    Эргүүл хийх цаг.

  • Name
    shift_work_day
    Type
    integer
    Description

    Ээлжээр ажиллах өдөр.

  • Name
    shift_work_time
    Type
    integer
    Description

    Ээлжээр ажиллах цаг.

  • Name
    rooster_day
    Type
    integer
    Description

    Ростерын өдөр.

  • Name
    rooster_time
    Type
    integer
    Description

    Ростерын цаг.

  • Name
    shortened_time_day
    Type
    integer
    Description

    Богиносгосон ажлын өдөр.

  • Name
    shortened_time_time
    Type
    integer
    Description

    Богиносгосон ажлын цаг.

  • Name
    overtime_holiday_day
    Type
    integer
    Description

    Баярын илүү цагийн өдөр.

  • Name
    overtime_holiday_time
    Type
    integer
    Description

    Баярын илүү цагийн цаг.

  • Name
    overtime_night_day
    Type
    integer
    Description

    Шөнийн илүү цагийн өдөр.

  • Name
    overtime_night_time
    Type
    integer
    Description

    Шөнийн илүү цагийн цаг.

  • Name
    overtime_regular_day
    Type
    integer
    Description

    Энгийн илүү цагийн өдөр.

  • Name
    overtime_regular_time
    Type
    integer
    Description

    Энгийн илүү цагийн цаг.

  • Name
    salary_leave_new_child_day
    Type
    integer
    Description

    Шинэ хүүхэдтэй болсон цалинтай амралтын өдөр.

  • Name
    salary_leave_new_child_time
    Type
    integer
    Description

    Шинэ хүүхэдтэй болсон цалинтай амралтын цаг.

  • Name
    vacation_full_day
    Type
    integer
    Description

    Бүтэн ээлжийн амралтын өдөр.

  • Name
    vacation_full_time
    Type
    integer
    Description

    Бүтэн ээлжийн амралтын цаг.

  • Name
    vacation_partial_day
    Type
    integer
    Description

    Хэсэгчилсэн ээлжийн амралтын өдөр.

  • Name
    vacation_partial_time
    Type
    integer
    Description

    Хэсэгчилсэн ээлжийн амралтын цаг.

  • Name
    vacation_non_day
    Type
    integer
    Description

    Биеэр эдлэхгүй ээлжийн амралтын өдөр.

  • Name
    vacation_non_time
    Type
    integer
    Description

    Биеэр эдлэхгүй ээлжийн амралтын цаг.

  • Name
    overtime_vacation_day
    Type
    integer
    Description

    Амралтын илүү цагийн өдөр.

  • Name
    overtime_vacation_time
    Type
    integer
    Description

    Амралтын илүү цагийн цаг.

  • Name
    assign_inner_day
    Type
    integer
    Description

    Дотоод томилолтын өдөр.

  • Name
    assign_inner_time
    Type
    integer
    Description

    Дотоод томилолтын цаг.

  • Name
    assign_outer_day
    Type
    integer
    Description

    Гадаад томилолтын өдөр.

  • Name
    assign_outer_time
    Type
    integer
    Description

    Гадаад томилолтын цаг.

  • Name
    post_day
    Type
    integer
    Description

    Пост дээр байх өдөр.

  • Name
    post_time
    Type
    integer
    Description

    Пост дээр байх цаг.

  • Name
    overtime_regular_work_day
    Type
    integer
    Description

    Илүү цагийн ажилласан өдөр.

  • Name
    overtime_regular_work_time
    Type
    integer
    Description

    Илүү цагийн ажилласан цаг.

  • Name
    salary_leave_other_day
    Type
    integer
    Description

    Бусад цалинтай амралтын өдөр.

  • Name
    salary_leave_other_time
    Type
    integer
    Description

    Бусад цалинтай амралтын цаг.

Request

GET
/v1/messages
 curl --location --request POST 'https://api.timely.mn/v3/overview-attd' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "company_register":"6076858",
    "div_id": "0",
    "dateFrom": "2023-01-01",
    "dateTo": "2023-01-09",
    "page": 1,
    "limit": 2
  }'

Response

{
"success": "1",
"data": [
    {
        "workerId": "1622",
        "division": "test",
        "position": "Борлуулалтын менежер",
        "workerName": "Цогоо",
        "register": "АА12312322",
        "attd": {
            "work_day": 16,
            "work_time": 128,
            "holiday_day": 0,
            "holiday_time": 0,
            "absent_day": 0,
            "absent_time": 0,
            "late_day": 2,
            "late_time": 0.5166666666666667,
            "leave_day": 0,
            "leave_time": 0,
            "half_day": 0,
            "half_time": 0,
            "total_minus_day": 0,
            "total_minus_time": 0.5166666666666667,
            "worked_day": 16,
            "worked_time": 127.48333333333333,
            "total_day": 16,
            "total_time": 127.48333333333333,
            "holiday_worked_day": 0,
            "holiday_worked_time": 0,
            "actual_worked_day": 0,
            "actual_worked_time": 0,
            "act_in_day": 0,
            "act_in_time": 0,
            "act_out_day": 12,
            "act_out_time": 12.100000000000001,
            "attdRequestDay": 0,
            "attdRequestTime": 0,
            "minusRequestDay": 0,
            "minusRequestTime": 0,
            "sum_total_day": 16,
            "sum_total_time": 139.58333333333334
        },
        "request": {
            "app_leave_day": 1,
            "app_leave_time": 2,
            "overtime_total_day": 0,
            "overtime_total_time": 0
        }
    }
],
"pagination": {
    "totalItems": 14,
    "totalPages": 4,
    "currentPage": 1,
    "itemsPerPage": 4
}
}

Алдааны хариултууд

Талбар дутуу байх үед

{
  "success": "0", 
  "message": "Бүх талбарыг бөглөнө үү"
}

Компаны регистерийн дугаарын орон 7той тэнцэхгүй байх үед

{
  {
    "success": "0", 
    "message": "Регистерийн дугаар буруу байна"
  }
}

Огноо YYYY-MM-DD форматаас зөрж 10-аас бага оронтой байх үед

{
  "success": "0", 
  "message": "Огнооны формат буруу байна"
}

Өгөгдсөн регистерийн дугаартай компани бүртгэлгүй байх үед

{
  "success": "0", 
  "message": "Компани бүртгэлгүй байна"
}

Тодорхойгүй алдаа гарах үед

{
  "success": "0", 
  "message": "Тодорхойгүй алдаа гарлаа"
}