Skip to Content
🚀 Welcome to Humansoft Open API Documentation
DocumentationAPI ReferenceWork Cycle Change (เปลี่ยนกะ)Overview

Work Cycle Change (เปลี่ยนกะ)

API สำหรับจัดการคำขอเปลี่ยนกะการทำงานของพนักงาน

ภาพรวม

Work Cycle Change API ช่วยให้พนักงานสามารถยื่นคำขอเปลี่ยนกะหรือสลับกะกับวันอื่น โดยผ่านระบบอนุมัติอัตโนมัติ

การเปลี่ยนกะต้องผ่านการอนุมัติจากผู้บังคับบัญชาตามที่บริษัทกำหนด

Available Endpoints

EndpointMethodDescription
Get Work Cycle TypesGETดึงรายการกะทั้งหมด
Get Change ListGETดึงรายการคำขอเปลี่ยนกะ
Submit Change RequestPOSTยื่นคำขอเปลี่ยนกะ
Update Change RequestPOSTแก้ไขคำขอเปลี่ยนกะ
Delete Change RequestPOSTลบคำขอเปลี่ยนกะ

โหมดการเปลี่ยนกะ

ModeรหัสDescription
เปลี่ยนกะchangeเปลี่ยนกะของวันที่ระบุเป็นกะอื่น
สลับกะswitchสลับกะระหว่าง 2 วัน

Change Mode (เปลี่ยนกะ)

เปลี่ยนกะของวันที่ระบุเป็นกะอื่น เช่น:

  • วันที่ 15 ม.ค. ปกติเข้ากะ A (08:00-17:00) → เปลี่ยนเป็นกะ B (13:00-22:00)

Switch Mode (สลับกะ)

สลับกะระหว่าง 2 วัน เช่น:

  • วันที่ 15 ม.ค. กะ A สลับกับ วันที่ 16 ม.ค. กะ B

สถานะการอนุมัติ

StatusรหัสDescription
รออนุมัติ01คำขออยู่ระหว่างรอการอนุมัติ
อนุมัติแล้ว02คำขอได้รับการอนุมัติ
ไม่อนุมัติ03คำขอไม่ได้รับการอนุมัติ
ยกเลิก04คำขอถูกยกเลิก
ส่งกลับแก้ไข05คำขอถูกส่งกลับให้แก้ไข
รออนุมัติระดับ 2-406-08คำขอรอผู้อนุมัติระดับสูงขึ้น

Quick Start

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

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

2. ยื่นคำขอเปลี่ยนกะ

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/submit" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "work_cycle_change_dt": "2026-01-20", "work_cycle_mode_lv": "change", "work_cycle_id": "V0MwMDI=", "work_cycle_change_desc": "ต้องไปธุระช่วงเช้า" }'

3. ดูรายการคำขอเปลี่ยนกะ

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

Common Use Cases

  1. พนักงานขอเปลี่ยนกะ - ยื่นคำขอเปลี่ยนกะในวันที่ต้องการ
  2. สลับกะกับเพื่อนร่วมงาน - สลับกะระหว่าง 2 วัน
  3. HR ตรวจสอบคำขอ - ดูรายการคำขอเปลี่ยนกะทั้งหมด
  4. แก้ไข/ยกเลิกคำขอ - แก้ไขหรือลบคำขอที่ยังไม่อนุมัติ

Business Rules

ข้อจำกัดการเปลี่ยนกะ:

  • ไม่สามารถเปลี่ยนกะในวันที่มี OT ได้
  • ไม่สามารถเปลี่ยนกะในงวดเงินเดือนที่ปิดแล้ว
  • ไม่สามารถแก้ไข/ลบคำขอที่อนุมัติแล้ว
  • มี Cut-off date และ Quota limit ตามที่บริษัทกำหนด
Last updated on