Skip to Content
🚀 Welcome to Humansoft Open API Documentation
DocumentationAPI ReferenceWork Cycle (กะการทำงาน)Overview

Work Cycle (กะการทำงาน)

API สำหรับจัดการกะการทำงาน (Shift) ของพนักงาน

ภาพรวม

Work Cycle API ช่วยให้คุณสามารถดึงข้อมูลกะการทำงาน จัดการตารางกะรายวัน และกำหนดกะพื้นฐานให้พนักงาน

กะการทำงานกำหนดเวลาเข้า-ออกงาน เวลาพัก และจำนวนชั่วโมงทำงานของพนักงาน

Available Endpoints

EndpointMethodDescription
Get Work Cycle TypesGETดึงรายการกะทั้งหมดในองค์กร
Get Employee SettingGETดึงการตั้งค่ากะพื้นฐานของพนักงาน
Get Monthly ScheduleGETดึงตารางกะรายเดือนของพนักงาน
Update Employee SettingPOSTแก้ไขการตั้งค่ากะพื้นฐานของพนักงาน

ประเภทกะการทำงาน

TypeรหัสDescription
กะปกติ00กะมาตรฐาน เช่น 08:00-17:00
กะคู่ (Dual Shift)04กะที่มี 2 ช่วงเวลาทำงานในวันเดียว

รูปแบบกะ (Work Cycle Format)

FormatDescriptionตัวอย่าง
weeklyกำหนดกะรายสัปดาห์จันทร์-ศุกร์ กะ A, เสาร์-อาทิตย์ หยุด
dailyกำหนดกะรายวันตารางกะหมุนเวียน
fixedกะคงที่ทุกวันกะ A

โครงสร้างข้อมูลกะ

{ "code": "A", "name": "A : 08:00-17:00", "work_cycle_id": "1", "work_cycle_type": "00", "work_start_time": "08:00", "work_end_time": "17:00", "break_start_time": "12:00", "break_end_time": "13:00", "work_hour": "08:00:00", "break_hour": "01:00:00" }

Quick Start

1. ดูรายการกะทั้งหมด

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/get-types" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

2. ดูตารางกะรายเดือนของพนักงาน

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/get-employee-work-cycle-month?employee_code=EMP001&month_no=2026-01" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

3. แก้ไขกะพื้นฐานของพนักงาน

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/update-employee-base-work-cycle-setting" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "work_cycle_format": "weekly", "day_lists": [ {"day": "monday", "id": "V0MwMDE=", "code": "A", "name": "A : 08:00-17:00"}, {"day": "tuesday", "id": "V0MwMDE=", "code": "A", "name": "A : 08:00-17:00"} ] }'

Common Use Cases

  1. ดูรายการกะ - แสดง Dropdown เลือกกะในระบบ
  2. ดูตารางกะรายเดือน - แสดงปฏิทินกะของพนักงาน
  3. แก้ไขกะพื้นฐาน - กำหนดกะประจำวันให้พนักงาน
  4. ตรวจสอบสิทธิ์เปลี่ยนกะ - ตรวจสอบ Cut-off date

Cut-off Date

การเปลี่ยนกะมี Cut-off Date ที่กำหนดได้ในระบบ หลังจากวันที่กำหนดจะไม่สามารถแก้ไขกะได้

  • is_change_work_cycle = 'Y' - สามารถเปลี่ยนกะได้
  • is_change_work_cycle = 'N' - ไม่สามารถเปลี่ยนกะได้ (เกิน Cut-off หรือรอบเงินเดือนปิด)
  • Holiday - วันทำงาน/วันหยุด
  • Overtime - ทำงานล่วงเวลา
  • Time Leave - การลา
Last updated on