Update Change Request

แก้ไขคำขอเปลี่ยนกะที่มีอยู่

ใช้ API นี้เพื่อแก้ไขรายละเอียดคำขอเปลี่ยนกะ เช่น เปลี่ยนกะใหม่ หรือเพิ่มเหตุผล

Endpoint


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

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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`work_cycle_change_id`	string	Yes	ID ของคำขอที่ต้องการแก้ไข	`V0NDMDAxMjM=`

Optional Parameters

Parameter	Type	Required	Description	Example
`work_cycle_change_dt`	string	No	วันที่เปลี่ยนกะใหม่ (YYYY-MM-DD)	`2026-01-21`
`work_cycle_mode_lv`	string	No	โหมดใหม่ (`change`, `switch`)	`change`
`work_cycle_id`	string	No	ID กะใหม่ (Base64)	`MjAyNTExMjdENDU3M0M0MjE2Mzk=`
`work_cycle_change_desc`	string	No	เหตุผล/รายละเอียดใหม่	`แก้ไขเหตุผล`
`image_content`	string	No	ไฟล์แนบใหม่ (Base64)	`data:image/png;base64,...`
`authorize_id`	string	No	ID ผู้ทำรายการ (Base64)	`MjAyNjA0MzBVU0VSMDAwMDAx`

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

Request Body Example


{
  "work_cycle_change_id": "V0NDMDAxMjM=",
  "work_cycle_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk=",
  "work_cycle_change_desc": "เปลี่ยนเป็นกะ C แทน"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "work_cycle_change_id": "V0NDMDAxMjM=",
    "employee_id": "RU1QMDE=",
    "work_cycle_change_dt": "2026-01-20",
    "work_cycle_mode_lv": "change",
    "work_cycle_id": "20251127D4573C421639",
    "work_cycle_change_desc": "เปลี่ยนเป็นกะ C แทน",
    "approve_flag": "01"
  }
}

Error Response - Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Work cycle change record not found"
}

Error Response - Already Approved (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "ไม่สามารถแก้ไขเอกสารที่อนุมัติแล้ว"
}

Error Response - Salary Period Closed (HTTP 400)


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

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/update" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "work_cycle_change_id": "V0NDMDAxMjM=",
    "work_cycle_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk=",
    "work_cycle_change_desc": "เปลี่ยนเป็นกะ C แทน"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/update',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      work_cycle_change_id: 'V0NDMDAxMjM=',
      work_cycle_id: 'MjAyNTExMjdENDU3M0M0MjE2Mzk=',
      work_cycle_change_desc: 'เปลี่ยนเป็นกะ C แทน'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('แก้ไขสำเร็จ:', data.payload.work_cycle_change_id)
} else {
  console.error('Error:', data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/update"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "work_cycle_change_id": "V0NDMDAxMjM=",
    "work_cycle_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk=",
    "work_cycle_change_desc": "เปลี่ยนเป็นกะ C แทน"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('แก้ไขสำเร็จ:', data['payload']['work_cycle_change_id'])
else:
    print('Error:', data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/update";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "work_cycle_change_id" => "V0NDMDAxMjM=",
    "work_cycle_id" => "MjAyNTExMjdENDU3M0M0MjE2Mzk=",
    "work_cycle_change_desc" => "เปลี่ยนเป็นกะ C แทน"
];
 
$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'];
} else {
    echo "Error: " . $data['error'];
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`work_cycle_change_id`	ต้องระบุ	`Missing required parameter: 'work_cycle_change_id'`
`work_cycle_change_dt`	รูปแบบ YYYY-MM-DD (ถ้าระบุ)	`'work_cycle_change_dt' must be in Y-m-d format`
`work_cycle_mode_lv`	ต้องเป็น change หรือ switch (ถ้าระบุ)	`'work_cycle_mode_lv' must be 'change' or 'switch'`

Business Rules

ข้อจำกัดการแก้ไข:

ไม่สามารถแก้ไขคำขอที่อนุมัติแล้ว (approve_flag = 02)
ไม่สามารถแก้ไขในงวดเงินเดือนที่ปิดแล้ว
มี Cut-off date ที่กำหนดได้

Error Handling

Error	Cause	Solution
`Missing required parameter: 'work_cycle_change_id'`	ไม่ได้ส่ง work_cycle_change_id	ตรวจสอบ request body
`Work cycle change record not found`	ไม่พบคำขอ	ตรวจสอบ work_cycle_change_id
`ไม่สามารถแก้ไขเอกสารที่อนุมัติแล้ว`	คำขออนุมัติแล้ว	ไม่สามารถแก้ไขได้
`ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว`	งวดปิดแล้ว	ติดต่อ HR
`ไม่สามารถแก้ไขเอกสารได้เนื่องจากเกินกำหนดเวลา`	เกิน Cut-off date	ติดต่อ HR
`มีคำขอเปลี่ยนกะในวันดังกล่าวอยู่แล้ว`	ซ้ำกับคำขออื่น	ตรวจสอบวันที่

Notes

Use Cases

แก้ไขกะที่ต้องการ - เปลี่ยนจากกะ B เป็นกะ C
เพิ่มเหตุผล - อัพเดทรายละเอียด
เปลี่ยนวันที่ - แก้ไขวันที่เปลี่ยนกะ

Partial Update

สามารถส่งเฉพาะ field ที่ต้องการแก้ไข
field ที่ไม่ได้ส่งจะคงค่าเดิม

หา work_cycle_change_id

ใช้ Get Change List เพื่อดู work_cycle_change_id

Get Change List - ดูรายการคำขอ
Submit Change Request - ยื่นคำขอใหม่
Delete Change Request - ลบคำขอ