Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Employee Setting

ดึงการตั้งค่ากะพื้นฐานของพนักงาน

ใช้ API นี้เพื่อดูว่าพนักงานมีการตั้งค่ากะพื้นฐานอย่างไร เช่น กะประจำวันจันทร์-ศุกร์

Endpoint

GET /api/v1/open-apis/work-cycle/get-employee-base-work-cycle-setting

Request Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงานEMP001

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": { "work_cycle_format": "weekly", "work_cycle_id_json": "{\"monday\":\"1\",\"tuesday\":\"1\",\"wednesday\":\"1\",\"thursday\":\"1\",\"friday\":\"1\",\"saturday\":null,\"sunday\":null}", "work_cycle_lists": { "monday": { "work_cycle_code": "A", "work_cycle_id": "V0MwMDE=" }, "tuesday": { "work_cycle_code": "A", "work_cycle_id": "V0MwMDE=" }, "wednesday": { "work_cycle_code": "A", "work_cycle_id": "V0MwMDE=" }, "thursday": { "work_cycle_code": "A", "work_cycle_id": "V0MwMDE=" }, "friday": { "work_cycle_code": "A", "work_cycle_id": "V0MwMDE=" }, "saturday": { "work_cycle_code": null, "work_cycle_id": null }, "sunday": { "work_cycle_code": null, "work_cycle_id": null } } } }

Error Response - Missing Parameter (HTTP 400)

{ "code": 400, "message": "ไม่สำเร็จ", "error": "Missing required parameter: employee_code" }

Error Response - Employee Not Found (HTTP 400)

{ "code": 400, "message": "ไม่สำเร็จ", "error": "Employee not found with code: EMP999" }

Response Fields

FieldTypeDescription
work_cycle_formatstringรูปแบบกะ (weekly, daily, fixed)
work_cycle_id_jsonstringJSON ของ work_cycle_id แต่ละวัน
work_cycle_listsobjectรายการกะแต่ละวัน (พร้อมรายละเอียด)

work_cycle_lists[day]

FieldTypeDescription
work_cycle_codestringรหัสกะ (เช่น A, B) หรือ null ถ้าหยุด
work_cycle_idstringID ของกะ (Base64) หรือ null ถ้าหยุด

Code Examples

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

Work Cycle Format

FormatDescription
weeklyกำหนดกะรายสัปดาห์ (จันทร์-อาทิตย์)
dailyกำหนดกะรายวัน (กำหนดกะแยกแต่ละวัน)

Day Keys

Keyวัน
mondayวันจันทร์
tuesdayวันอังคาร
wednesdayวันพุธ
thursdayวันพฤหัสบดี
fridayวันศุกร์
saturdayวันเสาร์
sundayวันอาทิตย์

Error Handling

ErrorCauseSolution
Missing required parameter: employee_codeไม่ได้ส่ง employee_codeตรวจสอบ query parameter
Employee not found with code: XXXไม่พบพนักงานตรวจสอบ employee_code

Notes

Use Cases

  1. ดูกะพื้นฐานของพนักงาน - ตรวจสอบว่าพนักงานทำกะอะไรในแต่ละวัน
  2. แสดงฟอร์มแก้ไข - ดึงข้อมูลปัจจุบันก่อนแก้ไข
  3. ตรวจสอบวันหยุด - ดูว่าวันไหนไม่มีกะ (null)

Null Values

  • work_cycle_code = null และ work_cycle_id = null หมายถึงวันหยุด
  • พนักงานไม่ต้องเข้างานในวันนั้น
Last updated on