Reload Employee Data

โหลดข้อมูลพนักงานในงวดโอทีใหม่

ใช้เมื่อแก้ไขข้อมูลพนักงาน เช่น อัตราค่าจ้างหรือหน่วยงาน หลังจากสร้างงวดไปแล้ว เพื่อให้งวดใช้ข้อมูลล่าสุดในการคำนวณ

Endpoint


POST /api/v1/open-apis/calculation-ot/reload-employee-data

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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	งวดเงินเดือนที่รอบโอทีสังกัด (YYYY-MM)	`2026-09`
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการโหลดข้อมูลใหม่	`EMP001`

Request Body Example


{
  "year_month": "2026-09",
  "employee_code": "EMP001"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "Reload Employee For (2026-09) Accept",
  "payload": {
    "employee_code": "EMP001",
    "year_month": "2026-09"
  }
}

Error Response - Employee Not Found (HTTP 400)


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

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

Error Response - Salary Period Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่พบงวดเงินเดือนของเดือนที่ระบุ",
  "payload": []
}

วิธีแก้: ตรวจสอบว่าสร้างงวดเงินเดือนของเดือนนั้นแล้ว และงวดยังไม่ปิด

Error Response - Unauthorized (HTTP 401)


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

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

Response Fields

Field	Type	Description
`employee_code`	string	รหัสพนักงานที่โหลดข้อมูลใหม่
`year_month`	string	งวดเดือนที่ทำรายการ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/reload-employee-data" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year_month": "2026-09",
    "employee_code": "EMP001"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/reload-employee-data',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year_month: '2026-09',
      employee_code: 'EMP001'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('โหลดข้อมูลสำเร็จ:', data.payload.employee_code)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/calculation-ot/reload-employee-data"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "year_month": "2026-09",
    "employee_code": "EMP001"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('โหลดข้อมูลสำเร็จ:', data['payload']['employee_code'])
else:
    print('Error:', data.get('message'))

PHP


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

Validation Rules

Parameter	Validation	Error Message
`year_month`	ต้องระบุและเป็นรูปแบบ YYYY-MM	`กรุณาระบุ 'year_month' (รูปแบบ YYYY-MM)`
`employee_code`	ต้องระบุและมีอยู่จริงในระบบ	`Employee not found with code: EMP001`
สถานะงวดเงินเดือน	งวดเงินเดือนของเดือนนั้นต้องยังไม่ปิด	`ไม่พบงวดเงินเดือนของเดือนที่ระบุ`

Notes

ทำทีละคน ถ้าแก้ข้อมูลหลายคนให้เรียกซ้ำทีละรหัส
หลังโหลดข้อมูลใหม่ ควรสั่ง Calculate OT ซ้ำเพื่อให้ยอดคำนวณจากข้อมูลล่าสุด

Calculate OT - สั่งคำนวณโอทีรายคนหลังโหลดข้อมูลใหม่
Reload Company Config - โหลดการตั้งค่าบริษัทของงวดใหม่