List OT Templates

ดูรายการ OT Template ทั้งหมดที่บันทึกไว้

Template คือรูปแบบงวดโอทีที่บันทึกไว้ใช้ซ้ำทุกเดือน — เก็บ master_salary_ot_report_template_id ที่ได้ไว้ส่งให้ Create Round from Template

Endpoint


POST /api/v1/open-apis/calculation-ot/get-list-ot-round-template

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

Request Parameters

ไม่มี parameters

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "Get OT templates Accept",
  "payload": [
    {
      "master_salary_ot_report_template_id": "20251127T8891F6A3D024",
      "master_salary_ot_template_code": "OT-T001",
      "master_salary_ot_template_name": "งวดโอที 21-20",
      "ot_template_start_dt": "21",
      "ot_template_end_dt": "20",
      "ot_template_start_month": -1,
      "employee_count": 25
    }
  ]
}

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 (ต้องแปลงเป็น Base64 ก่อนส่งกลับเข้า request)
`master_salary_ot_template_code`	string	รหัสอ้างอิงที่ระบบสร้างให้
`master_salary_ot_template_name`	string	ชื่อ Template
`ot_template_start_dt`	string	วันที่ของเดือนที่เริ่มรอบ เช่น `21`
`ot_template_end_dt`	string	วันที่ของเดือนที่จบรอบ เช่น `20` หรือ `EOM` = สิ้นเดือน
`ot_template_start_month`	int	จำนวนเดือนที่เลื่อนจากงวดเงินเดือน เช่น `-1` = เริ่มเดือนก่อนหน้า
`employee_count`	int	จำนวนพนักงานที่บันทึกไว้ใน Template นี้

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/get-list-ot-round-template" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/get-list-ot-round-template',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('จำนวน Template:', data.payload.length)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/get-list-ot-round-template"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
 
response = requests.post(url, headers=headers, json={})
data = response.json()
 
if data['code'] == 200:
    print('จำนวน Template:', len(data['payload']))
else:
    print('Error:', data.get('message'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/get-list-ot-round-template";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [];
 
$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 "จำนวน Template: " . count($data['payload']);
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Notes

ถ้ายังไม่เคยสร้าง Template จะได้ payload เป็น array ว่าง

Create Round from Template - ใช้ Template นี้สร้างงวดจริง
Get OT Template - ดูรายละเอียดของ Template ตัวใดตัวหนึ่ง
Create OT Template - สร้าง Template ใหม่