Save Work Cycle Grid

บันทึกการแก้ไขตารางกะการทำงานของพนักงานหลายคนพร้อมกันแบบ Grid ในรอบช่วงเวลาที่กำหนด

ใช้ API นี้เพื่อบันทึกกะการทำงานที่แก้ไขบนตาราง Grid โดยส่งข้อมูลรายวันของพนักงานแต่ละคน — ค่า time_attendance_group_transac_id และ work_cycle_id ที่ส่งมาต้องได้จาก Get Work Cycle Grid ก่อนเสมอ

Endpoint


POST /api/v1/open-apis/time-manage/edit-work-cycle-multiple

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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_lists`	array	Yes	รายชื่อพนักงานและตารางวันที่ต้องการบันทึกแก้ไข (ดูโครงสร้างด้านล่าง)	`[...]`

employee_lists[] Fields

Field	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการบันทึกแก้ไข	`"EMP001"`
`day_lists`	array	Yes	รายการวันและรหัสกะใหม่ที่แก้ไข (ดูโครงสร้างด้านล่าง)	`[...]`

employee_lists[].day_lists[] Fields

Field	Type	Required	Description	Example
`work_date`	string	Yes	วันที่ต้องการเปลี่ยนกะ (`YYYY-MM-DD`)	`"2026-07-01"`
`time_attendance_group_transac_id`	string	Yes	รหัสอ้างอิงรายการเวลาประจำวัน (ได้จาก Get Work Cycle Grid)	`"20260701ACD8956C44C3"`
`work_cycle_id`	string	Yes	รหัสอ้างอิงกะใหม่ที่เลือก (ได้จาก Get Work Cycle List)	`"202401083EAE7D1F9711"`
`work_cycle_code`	string	Yes	รหัสย่อกะการทำงานใหม่ (เช่น `"M1"`)	`"M1"`
`master_salary_report_id`	string	No	รหัสรอบเดือนประมวลผลเงินเดือน	`"202607286709D2934361"`

Request Body Example


{
  "employee_lists": [
    {
      "employee_code": "EMP001",
      "day_lists": [
        {
          "work_date": "2026-07-01",
          "time_attendance_group_transac_id": "20260701ACD8956C44C3",
          "work_cycle_id": "202401083EAE7D1F9711",
          "work_cycle_code": "M1",
          "master_salary_report_id": "202607286709D2934361"
        }
      ]
    }
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "Edit Work Cycle Multiple Accept",
  "payload": {
    "status": "success",
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          {
            "work_date": "2026-07-01",
            "time_attendance_group_transac_id": "20260701ACD8956C44C3",
            "status": "updated",
            "old_work_cycle_code": "N1",
            "new_work_cycle_code": "M1"
          }
        ]
      }
    ]
  }
}

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "employee_lists[0].day_lists[0]: Please specify both 'work_cycle_id' and 'work_cycle_code'",
    "employee_lists[0].day_lists[1]: Invalid 'work_cycle_id' (202504083EAE7D1F9711) - not found in the system"
  ]
}

Error Response - Closed Period (HTTP 400)


{
  "code": 400,
  "message": "ไม่สามารถแก้ไขเอกสารได้เนื่องจากเกินกำหนดเวลาที่ร้องขอแล้ว",
  "errors": []
}

Error Response - Unauthorized (HTTP 401)


{
  "statusCode": 401,
  "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}

Response Fields

`payload`

Field	Type	Nullable	Description
`status`	string	No	สถานะภาพรวมการทำงาน (เช่น `"success"`)
`employee_lists`	array	No	รายชื่อและผลลัพธ์การแก้ไขของพนักงานแต่ละคน

`payload.employee_lists[]`

Field	Type	Nullable	Description
`employee_code`	string	No	รหัสพนักงานที่ดำเนินการแก้ไข
`day_lists`	array	No	รายการวันที่เปลี่ยนแปลงของพนักงานคนนั้น

`payload.employee_lists[].day_lists[]`

Field	Type	Nullable	Description
`work_date`	string	No	วันที่ทำการปรับปรุงกะการทำงาน (`YYYY-MM-DD`)
`time_attendance_group_transac_id`	string	No	รหัสอ้างอิงรายการเวลาประจำวัน
`status`	string	No	สถานะของวันนั้น: `"updated"` (อัปเดตสำเร็จ) หรือ `"unchanged"` (ไม่มีการเปลี่ยนแปลง)
`old_work_cycle_code`	string	Yes	รหัสย่อกะการทำงานเดิมก่อนแก้ไข
`new_work_cycle_code`	string	Yes	รหัสย่อกะการทำงานใหม่หลังแก้ไขสำเร็จ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-work-cycle-multiple" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          {
            "work_date": "2026-07-01",
            "time_attendance_group_transac_id": "20260701ACD8956C44C3",
            "work_cycle_id": "202401083EAE7D1F9711",
            "work_cycle_code": "M1",
            "master_salary_report_id": "202607286709D2934361"
          }
        ]
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-work-cycle-multiple',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_lists: [
        {
          employee_code: 'EMP001',
          day_lists: [
            {
              work_date: '2026-07-01',
              time_attendance_group_transac_id: '20260701ACD8956C44C3',
              work_cycle_id: '202401083EAE7D1F9711',
              work_cycle_code: 'M1',
              master_salary_report_id: '202607286709D2934361'
            }
          ]
        }
      ]
    })
  }
)
 
const data = await response.json()
console.log(data)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-work-cycle-multiple"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "employee_lists": [
        {
            "employee_code": "EMP001",
            "day_lists": [
                {
                    "work_date": "2026-07-01",
                    "time_attendance_group_transac_id": "20260701ACD8956C44C3",
                    "work_cycle_id": "202401083EAE7D1F9711",
                    "work_cycle_code": "M1",
                    "master_salary_report_id": "202607286709D2934361"
                }
            ]
        }
    ]
}
 
response = requests.post(url, headers=headers, json=payload)
print(response.json())

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-work-cycle-multiple";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "employee_lists" => [
        [
            "employee_code" => "EMP001",
            "day_lists" => [
                [
                    "work_date" => "2026-07-01",
                    "time_attendance_group_transac_id" => "20260701ACD8956C44C3",
                    "work_cycle_id" => "202401083EAE7D1F9711",
                    "work_cycle_code" => "M1",
                    "master_salary_report_id" => "202607286709D2934361"
                ]
            ]
        ]
    ]
];
 
$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);
print_r(json_decode($response, true));
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation
`employee_lists`	ต้องส่งเป็นอาร์เรย์รายการพนักงานที่ต้องการแก้ไข
`employee_code` / `day_lists`	สมาชิกแต่ละคนใน `employee_lists` ต้องมีรหัสพนักงานและรายการวันทำงาน
`work_date` / `time_attendance_group_transac_id`	ทุกวันใน `day_lists` ต้องระบุวันที่และรหัสอ้างอิงรายการเวลาประจำวัน
`work_cycle_id` / `work_cycle_code`	ต้องส่งมาคู่กันทั้งสองตัว และห้ามเป็นค่าว่าง
`time_attendance_group_transac_id` / `work_cycle_id`	ต้องเป็นค่าที่มีอยู่จริงในระบบ มิเช่นนั้นจะถูกปฏิเสธ

Business Rules

time_attendance_group_transac_id และ work_cycle_id ต้องนำมาจาก Get Work Cycle Grid โดยตรง — ห้ามสร้างหรือสุ่มค่าขึ้นเอง
วันที่พ้นกำหนดเวลาส่งข้อมูลหรือปิดงวดแล้วจะไม่สามารถบันทึกได้ และระบบจะปฏิเสธเป็นรายคน
รายการที่ส่งค่ากะเดิมซ้ำจะได้ status เป็น "unchanged" ส่วนรายการที่เปลี่ยนกะสำเร็จจะได้ "updated"
บางกรณีระบบจะข้ามการอัปเดตวันนั้นแบบเงียบ (คืน status: "unchanged" โดยไม่แจ้ง error) เช่น วันนั้นมี OT ที่อนุมัติแล้ว หรือมีเอกสาร Workforce Activity ครอบคลุมวันนั้นอยู่แล้ว

Get Work Cycle Grid - ดึงตารางกะการทำงานของพนักงานเพื่อนำ ID มาแก้ไข
Get Work Cycle List - ดึงรายการกะทั้งหมดสำหรับใช้เป็นตัวเลือกตอนเปลี่ยนกะ