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

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

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

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

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

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

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

Response тайлбар

Name
workerId
Type
integer
Description
Timely-д бүртгэгдсэн ажилчны ID
Name
division
Type
string
Description
Ажилтны алба нэгж.
Name
position
Type
string
Description
Ажилтны албан тушаал
Name
worker_name
Type
string
Description
Ажилтны нэр.
Name
register_number
Type
string
Description
Ажилтны регистрийн дугаар.
Name
supposed_work_day
Type
integer
Description
Ажилтны ажиллах ёстой өдөр.
Name
supposed_work_hour
Type
integer
Description
Ажилтны ажиллах ёстой цаг.
Name
holiday
Type
integer
Description
Баярын өдөр.
Name
tomilolt
Type
integer
Description
Томилолт.
Name
remote_worked
Type
integer
Description
Гадуур ажилласан өдөр.
Name
sick_day
Type
integer
Description
Өвчтэй өдөр.
Name
sick_hour
Type
integer
Description
Өвчтэй цаг
Name
tasalsan
Type
integer
Description
Тасалсан хоног
Name
tasalsan_hour
Type
integer
Description
Тасалсан цаг
Name
half_worked
Type
integer
Description
Тал ажилласан
Name
late_days
Type
integer
Description
Хоцорсон өдөр
Name
late_minutes
Type
integer
Description
Хоцорсон минут
Name
early_dispersed_minute
Type
integer
Description
Эрт тарсан минут
Name
overtime_in
Type
integer
Description
Ирсэн идэвхийн цаг
Name
overtime_out
Type
integer
Description
Тарсан идэвхийн цаг
Name
free_day
Type
integer
Description
Чөлөөтэй өдөр
Name
free_hour
Type
integer
Description
Энгийн чөлөөтэй цаг
Name
free_hour_salary
Type
string
Description
Цалинтай чөлөөтэй цаг
Name
overtime
Type
integer
Description
Энгийн илүү цаг
Name
overtime_night
Type
integer
Description
Шөнийн илүү цаг
Name
holiday_overtime
Type
integer
Description
Баярын илүү цаг
Name
overtime_free
Type
integer
Description
Илүү цагийн амралт
Name
e_free_day
Type
integer
Description
Ээлжийн амралттай өдөр
Name
e_free_hour
Type
integer
Description
Ээлжийн амралттай цаг
Name
worked_days
Type
integer
Description
Ажилласан хоног
Name
worked_hours
Type
integer
Description
Ажилласан цаг

Request

GET

/v1/messages

 curl --location --request POST 'https://api.timely.mn/v3/overview' \
  --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": 9999,
        "division": "Ажилтан",
        "position": "Борлуулалтын ажилтан",
        "worker_name": "Нэр",
        "register_number": "БЮ0000000",
        "supposed_work_day": 6,
        "supposed_work_hour": 54,
        "holiday": 1,
        "tomilolt": 0,
        "remote_worked": 0,
        "sick_day": 0,
        "sick_hour": 0,
        "tasalsan": 4,
        "tasalsan_hour": "36.0",
        "half_worked": 1,
        "late_days": 1,
        "late_minutes": 75,
        "early_dispersed_minute": 0,
        "overtime_in": "01.00",
        "overtime_out": 0,
        "free_day": 0,
        "free_hour": 0,
        "free_hour_salary": "0.00",
        "overtime": 0,
        "overtime_night": 0,
        "holiday_overtime": 0,
        "overtime_free": 0,
        "e_free_day": 0,
        "e_free_hour": 0,
        "worked_days": 2,
        "worked_hours": 11.75
    }
]
}

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

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

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

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

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

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

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

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

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

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

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