Approve Work Cycle Change

อนุมัติหรือปฏิเสธเอกสารเปลี่ยนกะการทำงาน รองรับการอนุมัติแบบหลายขั้นตอน (Multi-level Approval)

ใช้ API นี้เพื่ออนุมัติ ปฏิเสธ หรือยกเลิกเอกสารเปลี่ยนกะ เมื่ออนุมัติขั้นสุดท้ายระบบจะเปลี่ยนกะให้พนักงานอัตโนมัติ

Endpoint


POST /api/v1/open-apis/work-cycle-change/approve

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`work_cycle_change_id`	string	Yes	รหัสเอกสารเปลี่ยนกะ (Base64)	`MjAyNjA0MzBXQzAwMDAwMDAx`
`employee_code`	string	Yes	รหัสพนักงานเจ้าของเอกสาร	`EMP001`
`approve_flag`	string	Yes	สถานะการอนุมัติ (`02`-`08`)	`02`
`authorize_id`	string	Yes	รหัสผู้อนุมัติ (Base64)	`MjAyNjA0MzBVU0VSMDAwMDAx`

หา authorize_id ได้อย่างไร: รับค่าจาก Get Employee Data Filter โดยใช้ path_action=get-user พร้อม employee_code ของผู้ทำรายการ — ใช้ค่า user_id ที่ได้กลับมาเป็น authorize_id

Optional Parameters

Parameter	Type	Default	Description
`approve_remark`	string	`""`	หมายเหตุ (บังคับสำหรับการปฏิเสธ)
`authorize_line`	string \| boolean	`""`	เช็คสายอนุมัติตามลำดับ (`true`/`false`)
`extra_round`	string	`"N"`	งวดพิเศษ (`Y`/`N`)
`no_hr_permission`	boolean	`false`	ระงับสิทธิพิเศษ HR

Option Values for approve_flag

ค่า	สถานะ (TH)	สถานะ (EN)	การทำงาน
`02`	อนุมัติ	Approved	อนุมัติขั้นสุดท้าย — ระบบจะเปลี่ยนกะให้พนักงานอัตโนมัติ
`03`	ไม่อนุมัติ	Not Approved	ปฏิเสธเอกสาร
`04`	หัวหน้าอนุมัติขั้นที่ 1	Manager Approved Step 1	ส่งต่อไปยังขั้นตอนถัดไป
`05`	ยกเลิก	Cancelled	ยกเลิก/ถอนคืนเอกสาร
`06`	หัวหน้าอนุมัติขั้นที่ 2	Manager Approved Step 2	ส่งต่อไปยังขั้นตอนถัดไป
`07`	หัวหน้าอนุมัติขั้นที่ 3	Manager Approved Step 3	ส่งต่อไปยังขั้นตอนถัดไป
`08`	หัวหน้าอนุมัติขั้นที่ 4	Manager Approved Step 4	ส่งต่อไปยังขั้นตอนถัดไป

authorize_line — เมื่อส่ง true ผู้ใช้ที่เป็น HR จะต้องผ่านกระบวนการอนุมัติตามลำดับเหมือนพนักงานทั่วไป (ไม่ bypass สายอนุมัติ)

no_hr_permission — เมื่อส่ง true ระบบจะระงับสิทธิพิเศษ HR ทำให้ต้องตรวจสอบกฎอย่างเคร่งครัด (เช่น cut-off date)

Request Body Example


{
  "work_cycle_change_id": "MjAyNjA0MzBXQzAwMDAwMDAx",
  "employee_code": "EMP001",
  "approve_flag": "02",
  "authorize_id": "MjAyNjA0MzBVU0VSMDAwMDAx",
  "approve_remark": "อนุมัติเปลี่ยนกะ"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "work_cycle_change_id": "20260430WC00000001",
    "employee_code": "EMP001",
    "approve_flag": "02",
    "approve_remark": "อนุมัติเปลี่ยนกะ",
    "approved_at": "2026-04-30 10:30:00"
  }
}

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'authorize_id'",
    "'approve_flag' must be 02-08"
  ]
}

Error Response - Remark Required for Rejection (HTTP 400)


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "'approve_remark' is required when approve_flag is '03'"
  ]
}

Error Response - Document Not Found (HTTP 400)


{
  "code": 400,
  "message": "Document not found"
}

Error Response - Overtime Exists (HTTP 400)


{
  "code": 400,
  "message": "Overtime exists"
}

Error Response - Salary Period Closed (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว"
}

Error Response - Cut-off Date Exceeded (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "เกินวันที่ cut-off แล้ว"
}

Response Fields

Field	Type	Description
`work_cycle_change_id`	string	รหัสเอกสารเปลี่ยนกะ
`employee_code`	string	รหัสพนักงานเจ้าของเอกสาร
`approve_flag`	string	สถานะการอนุมัติ
`approve_remark`	string	หมายเหตุการอนุมัติ
`approved_at`	string	วันเวลาที่อนุมัติ (YYYY-MM-DD HH:MM:SS)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "work_cycle_change_id": "MjAyNjA0MzBXQzAwMDAwMDAx",
    "employee_code": "EMP001",
    "approve_flag": "02",
    "authorize_id": "MjAyNjA0MzBVU0VSMDAwMDAx",
    "approve_remark": "อนุมัติเปลี่ยนกะ"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      work_cycle_change_id: 'MjAyNjA0MzBXQzAwMDAwMDAx',
      employee_code: 'EMP001',
      approve_flag: '02',
      authorize_id: 'MjAyNjA0MzBVU0VSMDAwMDAx',
      approve_remark: 'อนุมัติเปลี่ยนกะ'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.work_cycle_change_id)
  console.log('สถานะ:', data.payload.approve_flag)
  console.log('อนุมัติเมื่อ:', data.payload.approved_at)
} else {
  console.error('Error:', data.errors || data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "work_cycle_change_id": "MjAyNjA0MzBXQzAwMDAwMDAx",
    "employee_code": "EMP001",
    "approve_flag": "02",
    "authorize_id": "MjAyNjA0MzBVU0VSMDAwMDAx",
    "approve_remark": "อนุมัติเปลี่ยนกะ"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('อนุมัติสำเร็จ:', data['payload']['work_cycle_change_id'])
    print('สถานะ:', data['payload']['approve_flag'])
    print('อนุมัติเมื่อ:', data['payload']['approved_at'])
else:
    print('Error:', data.get('errors') or data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "work_cycle_change_id" => "MjAyNjA0MzBXQzAwMDAwMDAx",
    "employee_code" => "EMP001",
    "approve_flag" => "02",
    "authorize_id" => "MjAyNjA0MzBVU0VSMDAwMDAx",
    "approve_remark" => "อนุมัติเปลี่ยนกะ"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "อนุมัติสำเร็จ: " . $data['payload']['work_cycle_change_id'] . "\n";
    echo "สถานะ: " . $data['payload']['approve_flag'] . "\n";
    echo "อนุมัติเมื่อ: " . $data['payload']['approved_at'];
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['error']);
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`work_cycle_change_id`	ต้องระบุและเป็น string	`Missing required parameter: 'work_cycle_change_id'`
`employee_code`	ต้องระบุและเป็น string	`Missing required parameter: 'employee_code'`
`approve_flag`	ต้องระบุและเป็น `02`-`08`	`'approve_flag' must be 02-08`
`authorize_id`	ต้องระบุและเป็น string	`Missing required parameter: 'authorize_id'`
`approve_remark`	บังคับเมื่อ `approve_flag` = `03` (ปฏิเสธ)	`'approve_remark' is required when approve_flag is '03'`
`work_cycle_change_id`	ต้องมีอยู่ในระบบ	`Document not found`

Business Rules

ข้อจำกัดการอนุมัติ:

ระบบคำนวณขั้นตอนถัดไปอัตโนมัติตามสายการอนุมัติที่กำหนด
เมื่ออนุมัติขั้นสุดท้าย (approve_flag = 02) ระบบจะเปลี่ยนกะให้พนักงานอัตโนมัติ
การปฏิเสธ (approve_flag = 03) ต้องระบุ approve_remark เสมอ
ไม่สามารถอนุมัติได้หากมีเอกสาร OT ในวันเดียวกัน
ต้องไม่อยู่ในงวดเงินเดือน งวด OT หรืองวด worktime ที่ปิดแล้ว ยกเว้นเข้าเงื่อนไข extra_round
HR สามารถข้ามการตรวจสอบ cut-off date ได้ (ยกเว้น no_hr_permission = true)
ระบบจะส่งการแจ้งเตือนอัตโนมัติ

Error Handling

Error	Cause	Solution
`Missing required parameter: 'work_cycle_change_id'`	ไม่ได้ส่ง work_cycle_change_id	ตรวจสอบ request body
`Missing required parameter: 'authorize_id'`	ไม่ได้ส่ง authorize_id	ตรวจสอบ request body
`'approve_flag' must be 02-08`	ค่า approve_flag ไม่ถูกต้อง	ใช้ค่า `02`-`08` ตามตาราง Option Values
`'approve_remark' is required when approve_flag is '03'`	ปฏิเสธโดยไม่ระบุหมายเหตุ	ส่ง `approve_remark` เมื่อ `approve_flag` = `03`
`Document not found`	ไม่พบเอกสาร	ตรวจสอบ `work_cycle_change_id`
`Overtime exists`	มีเอกสาร OT ในวันเดียวกัน	ตรวจสอบเอกสาร OT ของพนักงานในวันนั้น
`ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว`	งวดเงินเดือนปิดแล้ว	เลือกเอกสารในงวดที่เปิดอยู่
`เกินวันที่ cut-off แล้ว`	เกินวัน cut-off	ติดต่อ HR หรือส่ง `no_hr_permission` = `false`

Notes

Use Cases

หัวหน้าอนุมัติคำขอ - อนุมัติเอกสารเปลี่ยนกะของพนักงานในสายงาน
HR อนุมัติหรือปฏิเสธเอกสาร - อนุมัติหรือปฏิเสธเอกสารในฐานะ HR
อนุมัติแบบหลายขั้นตอน - ส่ง approve_flag = 04-08 เพื่ออนุมัติในแต่ละขั้นตอน
ยกเลิกเอกสาร - ส่ง approve_flag = 05 เพื่อยกเลิก/ถอนคืนเอกสาร

Approval Flow

04 -> 06 -> 07 -> 08 -> 02 (ตามสายการอนุมัติที่กำหนด)
ระบบจะคำนวณขั้นตอนถัดไปอัตโนมัติ ไม่จำเป็นต้องส่ง approve_flag ถัดไปเอง
หากเป็นขั้นตอนสุดท้าย ระบบจะเปลี่ยนสถานะเป็น 02 (Approved) อัตโนมัติ และเปลี่ยนกะให้พนักงานทันที

HR Special Permission

โดยปกติ HR สามารถข้ามการตรวจสอบ cut-off date ได้
หากต้องการให้ HR ปฏิบัติตามกฎเดียวกับพนักงานทั่วไป ให้ส่ง authorize_line = true และ/หรือ no_hr_permission = true

Submit Work Cycle Change - ยื่นเอกสารเปลี่ยนกะ
Get Change List - ดึงรายการเอกสารเปลี่ยนกะ
Update Work Cycle Change - แก้ไขเอกสารเปลี่ยนกะ
Delete Work Cycle Change - ลบเอกสารเปลี่ยนกะ