Edit Time

เพิ่ม แก้ไข หรือลบข้อมูลการบันทึกเวลาทำงาน รองรับ 3 คำสั่ง: add, save, delete

Endpoint


POST /api/v1/open-apis/salary/update-data-filter?path_action=edit_time

Common Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`command`	string	No	คำสั่ง: `"add"`, `"save"` (default), `"delete"`	`"save"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN`	`"TH"`

command = “add”

เพิ่มรายการลงเวลาใหม่ (ประเภท Manual เสมอ)

Parameter	Type	Required	Description	Example
`attendance_datetime`	string	Yes	วันเวลา (YYYY-MM-DD HH:mm:ss)	`"2026-02-18 09:00:00"`
`work_type_lv`	string	No	รอบการทำงาน: `"1"` (เช้า), `"2"` (บ่าย)	`"1"`

command = “save”

แก้ไขวันที่ เวลา หรือรอบการทำงานของรายการที่มีอยู่

Parameter	Type	Required	Description	Example
`time_attendance_transac_id`	string	Yes	ID รายการที่ต้องการแก้ไข (Base64)	`"MjAyNjAxMjhERTg5NkE4MjFGNzA="`
`attendance_date`	string	Yes	วันที่ใหม่ (YYYY-MM-DD)	`"2026-02-18"`
`work_type_lv`	string	No	รอบการทำงาน: `"1"`, `"2"`, `null`	`"2"`
`attendance_datetime`	string	No	เวลาใหม่ (YYYY-MM-DD HH:mm:ss)	`"2026-02-18 09:00:00"`

command = “delete”

ลบรายการลงเวลา — การลบข้อมูลไม่สามารถกู้คืนได้

Parameter	Type	Required	Description	Example
`time_attendance_transac_id`	string	Yes	ID รายการที่ต้องการลบ (Base64)	`"MjAyNjAxMjhERTg5NkE4MjFGNzA="`

command=save สามารถแก้ไขได้เฉพาะเดือนที่ยังไม่ปิด
command=delete จะลบข้อมูลจริง — การลบข้อมูลไม่สามารถกู้คืนได้

Response Format

Success Response (command=add)


{
  "code": 200,
  "message": "Edit Time Attendance (add) Success",
  "payload": {
    "time_attendance_transac_id": "20260128DE896A821F70",
    "employee_id": "202503219741427917A0",
    "attendance_date": "2026-02-18",
    "attendance_datetime": "2026-02-18 09:00:00",
    "time_attendance_type_lv": "Manual",
    "work_type_lv": "1",
    "log_tracking_id": "202602186515550EFC83"
  }
}

Success Response (command=save)


{
  "code": 200,
  "message": "Edit Time Attendance (save) Success",
  "payload": {
    "command": "save",
    "time_attendance_transac_id": "20260128DE896A821F70",
    "employee_id": "202503219741427917A0",
    "attendance_date": "2026-02-18",
    "attendance_datetime": "2026-02-18 09:00:00",
    "log_tracking_id": "202602186515550EFC83"
  }
}

Success Response (command=delete)


{
  "code": 200,
  "message": "Edit Time Attendance (delete) Success",
  "payload": {
    "employee_id": "202503219741427917A0",
    "time_attendance_transac_id": "20260128DE896A821F70",
    "action_command": "delete",
    "attendance_datetime": "2026-02-18 09:00:00",
    "log_tracking_id": "202602186515550EFC83"
  }
}

Error Response (Month Closed)


{
  "code": 403,
  "message": "Exception Edit Time Attendance (save) Failure Finish Month",
  "payload": []
}

Code Examples

cURL


# เพิ่มเวลาใหม่ (command=add)
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee_code": "EMP001", "attendance_datetime": "2026-02-18 09:00:00", "work_type_lv": "1", "command": "add"}'
 
# แก้ไขวันที่ (command=save)
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee_code": "EMP001", "time_attendance_transac_id": "MjAyNjAxMjhERTg5NkE4MjFGNzA=", "attendance_date": "2026-02-18", "command": "save"}'
 
# ลบรายการ (command=delete)
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee_code": "EMP001", "time_attendance_transac_id": "MjAyNjAxMjhERTg5NkE4MjFGNzA=", "command": "delete"}'

JavaScript


// แก้ไขวันที่ (command=save)
const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      time_attendance_transac_id: 'MjAyNjAxMjhERTg5NkE4MjFGNzA=',
      attendance_date: '2026-02-18',
      command: 'save'
    })
  }
)
const data = await response.json()
console.log(`${data.message} - Log: ${data.payload.log_tracking_id}`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
 
# แก้ไขวันที่ (command=save)
body = {
    "employee_code": "EMP001",
    "time_attendance_transac_id": "MjAyNjAxMjhERTg5NkE4MjFGNzA=",
    "attendance_date": "2026-02-18",
    "command": "save"
}
response = requests.post(url, headers=headers, json=body)
data = response.json()
print(f"{data['message']} - Log: {data['payload']['log_tracking_id']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=edit_time";
 
// แก้ไขวันที่ (command=save)
$body = json_encode([
    "employee_code" => "EMP001",
    "time_attendance_transac_id" => "MjAyNjAxMjhERTg5NkE4MjFGNzA=",
    "attendance_date" => "2026-02-18",
    "command" => "save"
]);
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo "{$data['message']} - Log: {$data['payload']['log_tracking_id']}\n";
?>

Notes

command=add จะตั้งค่า time_attendance_type_lv = "Manual" อัตโนมัติเสมอ
command=save ต้องใช้ time_attendance_transac_id จาก Search Time Attendance
ทุก command จะสร้าง log tracking เพื่อบันทึกประวัติการแก้ไข (log_tracking_id)

Search Time Attendance - ค้นหารายการเพื่อหา time_attendance_transac_id
Get Detail - ดูรายละเอียดก่อนแก้ไข/ลบ
Add Time Attendance - เพิ่มรายการใหม่ (ทางเลือกนอกจาก command=add)