Save Template Employees

บันทึกรายชื่อพนักงานใน OT Template

เป็นการแทนที่ทั้งชุด — ต้องส่งรายชื่อทั้งหมดที่ต้องการให้อยู่ใน Template คนที่ไม่อยู่ในรายการจะถูกถอดออกจาก Template

Endpoint


POST /api/v1/open-apis/calculation-ot/save-ot-round-template

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลเงินเดือนทั้งองค์กร (payroll:read:all)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`master_salary_ot_report_template_id`	string	Yes	รหัส Template (Base64) — ได้จาก List OT Templates	`MjAyNTExMjdUODg5MUY2QTNEMDI0`
`employee_codes`	array	Yes	รายการรหัสพนักงานทั้งหมดที่ต้องการให้อยู่ใน Template	`["EMP001", "EMP002"]`

Request Body Example


{
  "master_salary_ot_report_template_id": "MjAyNTExMjdUODg5MUY2QTNEMDI0",
  "employee_codes": [
    "EMP001",
    "EMP002"
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "Save OT template Accept",
  "payload": {
    "master_salary_ot_report_template_id": "20251127T8891F6A3D024",
    "employee_codes": [
      "EMP001",
      "EMP002"
    ],
    "assigned_count": 2
  }
}

Error Response - Employee Not Found (HTTP 400)


{
  "code": 400,
  "message": "Employee not found with code: EMP001",
  "payload": []
}

วิธีแก้: ตรวจสอบรหัสพนักงานให้ตรงกับที่แสดงในระบบ

Error Response - Template ID Missing (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "กรุณาระบุ 'master_salary_ot_report_template_id'"
  ]
}

วิธีแก้: เรียก List OT Templates เพื่อดูรหัส Template ที่มีอยู่

Error Response - Multiple Employees Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่พบพนักงานรหัส: EMP099, EMP100",
  "payload": []
}

วิธีแก้: ตรวจสอบรหัสที่ระบุ แล้วส่งใหม่ทั้งชุด — ระบบไม่บันทึกบางส่วน

Error Response - Template Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่พบ OT Template ตามรหัสที่ระบุ",
  "payload": []
}

วิธีแก้: ตรวจรหัส Template จาก List OT Templates และตรวจว่าเข้ารหัส Base64 แล้ว — รหัสที่ถอดไม่ออกจะได้ข้อความเดียวกันนี้

Error Response - Unauthorized (HTTP 401)


{
  "code": 401,
  "message": "Unauthorized",
  "payload": []
}

วิธีแก้: ตรวจสอบว่า API Key ถูกต้องและมีสิทธิ์ตามที่ระบุไว้ด้านบน — ดูวิธีตั้งค่าได้ที่ Get Started

Response Fields

Field	Type	Description
`master_salary_ot_report_template_id`	string	รหัส Template ที่บันทึก
`employee_codes`	array	รายชื่อที่ส่งเข้ามา
`assigned_count`	int	จำนวนรายชื่อที่บันทึก

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/save-ot-round-template" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "master_salary_ot_report_template_id": "MjAyNTExMjdUODg5MUY2QTNEMDI0",
    "employee_codes": [
      "EMP001",
      "EMP002"
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/save-ot-round-template',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      master_salary_ot_report_template_id: 'MjAyNTExMjdUODg5MUY2QTNEMDI0',
      employee_codes: ['EMP001', 'EMP002']
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('จำนวนที่บันทึก:', data.payload.assigned_count)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/save-ot-round-template"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "master_salary_ot_report_template_id": "MjAyNTExMjdUODg5MUY2QTNEMDI0",
    "employee_codes": ["EMP001", "EMP002"]
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('จำนวนที่บันทึก:', data['payload']['assigned_count'])
else:
    print('Error:', data.get('message'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/save-ot-round-template";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "master_salary_ot_report_template_id" => "MjAyNTExMjdUODg5MUY2QTNEMDI0",
    "employee_codes" => ["EMP001", "EMP002"]
];
 
$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']['assigned_count'];
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`master_salary_ot_report_template_id`	ต้องระบุและเป็นรหัส Template ที่มีอยู่จริง	`กรุณาระบุ 'master_salary_ot_report_template_id'`
`employee_codes`	ต้องเป็น array ของรหัสพนักงาน	`กรุณาระบุ 'employee_codes' (array ของรหัสพนักงาน)`
`employee_codes[]`	ทุกรหัสต้องมีอยู่จริงในระบบ	`ไม่พบพนักงานรหัส: EMP099, EMP100`

Notes

การแก้รายชื่อใน Template ไม่กระทบงวดที่สร้างไปแล้วจาก Template นี้
ดูว่ามีใครเลือกได้บ้างจาก List Available for Template

List Available for Template - ดูพนักงานที่เลือกเข้า Template ได้
Get OT Template - ตรวจรายละเอียด Template
Create Round from Template - ใช้ Template นี้สร้างงวดจริง