Add Employee Training

เพิ่มประวัติการฝึกอบรมของพนักงาน

Endpoint


POST /api/v1/open-apis/employee/add-employee-profile?path_action=training

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `training`
`language_code`	string	No	ภาษา (`TH` / `EN`)

Request Body

Parameter	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงาน
`training_name`	string	Yes	ชื่อหลักสูตร/คอร์ส
`training_date`	string	No	วันที่เริ่มอบรม (YYYY-MM-DD)
`training_end_date`	string	No	วันที่สิ้นสุดอบรม (YYYY-MM-DD)
`training_hour`	number/string	No	จำนวนชั่วโมง
`training_price`	number/string	No	ค่าใช้จ่าย/ค่าอบรม (บาท)
`training_teacher`	string	No	ชื่อวิทยากร/ผู้สอน
`training_location`	string	No	สถานที่จัดอบรม
`training_type_lv`	string	No	รูปแบบการฝึกอบรม (`01` = ภายใน, `02` = ภายนอก)
`training_inform_type_lv`	string	No	แจ้งกรมพัฒนาฝีมือแรงงาน (`01` = ไม่แจ้ง, `02` = แจ้ง)

Response Format

Success Response


{
  "code": 200,
  "message": "Add Training Success",
  "payload": {
    "employee_training_id": "20260215A1B2C3D4E5F6",
    "employee_id": "20260121FC89F3BB9120",
    "training_name": "หลักสูตร Leadership Development",
    "training_date": "2026-02-15",
    "training_end_date": "2026-02-17",
    "training_hour": 24,
    "training_price": 15000.00,
    "training_teacher": "อาจารย์สมชาย ใจดี",
    "training_location": "โรงแรม ABC กรุงเทพฯ",
    "training_type_lv": "01",
    "training_inform_type_lv": "02",
    "training_log_type": "Manual"
  }
}

Error Response


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'",
    "Missing required parameter: 'training_name'"
  ]
}

Validation Rules

Field	Rule
`employee_code`	ต้องระบุและต้องมีพนักงานในระบบ
`training_name`	ต้องระบุชื่อหลักสูตร
`training_date`	ถ้าระบุต้องเป็นรูปแบบ YYYY-MM-DD
`training_end_date`	ถ้าระบุต้องเป็นรูปแบบ YYYY-MM-DD และต้องมากกว่าหรือเท่ากับ `training_date`
`training_hour`	ถ้าระบุต้องเป็นตัวเลข
`training_price`	ถ้าระบุต้องเป็นตัวเลข
`training_type_lv`	ถ้าระบุต้องเป็น `01` หรือ `02`
`training_inform_type_lv`	ถ้าระบุต้องเป็น `01` หรือ `02`

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile?path_action=training&language_code=TH" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "training_name": "หลักสูตร Leadership Development",
    "training_date": "2026-02-15",
    "training_end_date": "2026-02-17",
    "training_hour": "24",
    "training_price": "15000",
    "training_teacher": "อาจารย์สมชาย ใจดี",
    "training_location": "โรงแรม ABC กรุงเทพฯ",
    "training_type_lv": "01",
    "training_inform_type_lv": "02"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile?path_action=training&language_code=TH',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      training_name: 'หลักสูตร Leadership Development',
      training_date: '2026-02-15',
      training_end_date: '2026-02-17',
      training_hour: '24',
      training_price: '15000',
      training_teacher: 'อาจารย์สมชาย ใจดี',
      training_location: 'โรงแรม ABC กรุงเทพฯ',
      training_type_lv: '01',
      training_inform_type_lv: '02'
    })
  }
)
const data = await response.json()
console.log('Created training ID:', data.payload.employee_training_id)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {"path_action": "training", "language_code": "TH"}
data = {
    "employee_code": "EMP001",
    "training_name": "หลักสูตร Leadership Development",
    "training_date": "2026-02-15",
    "training_end_date": "2026-02-17",
    "training_hour": "24",
    "training_price": "15000",
    "training_teacher": "อาจารย์สมชาย ใจดี",
    "training_location": "โรงแรม ABC กรุงเทพฯ",
    "training_type_lv": "01",
    "training_inform_type_lv": "02"
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Created training ID: {result['payload']['employee_training_id']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile?path_action=training&language_code=TH";
 
$data = [
    "employee_code" => "EMP001",
    "training_name" => "หลักสูตร Leadership Development",
    "training_date" => "2026-02-15",
    "training_end_date" => "2026-02-17",
    "training_hour" => "24",
    "training_price" => "15000",
    "training_teacher" => "อาจารย์สมชาย ใจดี",
    "training_location" => "โรงแรม ABC กรุงเทพฯ",
    "training_type_lv" => "01",
    "training_inform_type_lv" => "02"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Created training ID: " . $result['payload']['employee_training_id'] . "\n";
?>

Notes

ระบบจะตั้งค่า training_log_type เป็น "Manual" อัตโนมัติ

List Trainings - ดึงรายการประวัติการฝึกอบรมทั้งหมด
Get Training - ดึงข้อมูลการฝึกอบรมตาม ID
Update Training - แก้ไขประวัติการฝึกอบรม
Delete Training - ลบประวัติการฝึกอบรม

Add Employee Training

Endpoint

Query Parameters

Request Body

Response Format

Success Response

Error Response

Validation Rules

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs