Submit Leave

ยื่นคำขอลาใหม่

ใช้ API นี้เพื่อสร้างคำขอลาใหม่ ระบบจะตรวจสอบข้อมูลและส่งเข้าสู่ขั้นตอนการอนุมัติอัตโนมัติ

Endpoint


POST /api/v1/open-apis/time-leave/submit

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`EMP001`
`absence_flag_lv`	string	Yes	ประเภทการลา (`absence-01` หรือ `01`)	`absence-01`
`effective_hour`	string	Yes	เวลาเริ่มต้น (YYYY-MM-DD HH:MM:SS)	`2026-01-15 08:00:00`
`expire_hour`	string	Yes	เวลาสิ้นสุด (YYYY-MM-DD HH:MM:SS)	`2026-01-15 17:00:00`

Optional Parameters

Parameter	Type	Required	Description	Example
`time_leave_desc`	string	No	รายละเอียด/เหตุผล	`ไม่สบาย มีไข้`
`image_content`	string	No	ไฟล์แนบ (Base64 encoded)	`data:image/png;base64,...`

Request Body Example


{
  "employee_code": "EMP001",
  "absence_flag_lv": "absence-01",
  "effective_hour": "2026-01-15 08:00:00",
  "expire_hour": "2026-01-15 17:00:00",
  "time_leave_desc": "ไม่สบาย มีไข้"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "time_leave_id": "VExWMDAxMjM=",
    "employee_id": "RU1QMDE=",
    "employee_code": "EMP001",
    "type": "01",
    "start_dt": "2026-01-15 08:00:00",
    "end_dt": "2026-01-15 17:00:00",
    "description": "ไม่สบาย มีไข้",
    "approve_flag": "01",
    "created": "2026-01-13 09:00:00"
  }
}

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'",
    "'effective_hour' must be in format YYYY-MM-DD HH:MM:SS"
  ]
}

Error Response - Employee Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found"
}

Error Response - Duplicate Leave (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "มีการลาซ้ำซ้อนกับเอกสารที่มีอยู่แล้ว"
}

Error Response - Document Limit (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "ไม่สามารถขอเอกสารเกิน 2 ฉบับ ต่อวัน"
}

Error Response - Salary Period Closed (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว"
}

Response Fields

Field	Type	Description
`time_leave_id`	string	ID ของคำขอที่สร้าง
`employee_id`	string	ID ของพนักงาน
`employee_code`	string	รหัสพนักงาน
`type`	string	ประเภทการลา
`start_dt`	datetime	เวลาเริ่มต้น
`end_dt`	datetime	เวลาสิ้นสุด
`description`	string	รายละเอียด
`approve_flag`	string	สถานะการอนุมัติ
`created`	datetime	วันเวลาที่สร้าง

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/submit" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_code": "EMP001",
    "absence_flag_lv": "absence-01",
    "effective_hour": "2026-01-15 08:00:00",
    "expire_hour": "2026-01-15 17:00:00",
    "time_leave_desc": "ไม่สบาย มีไข้"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/submit',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      absence_flag_lv: 'absence-01',
      effective_hour: '2026-01-15 08:00:00',
      expire_hour: '2026-01-15 17:00:00',
      time_leave_desc: 'ไม่สบาย มีไข้'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('สร้างคำขอสำเร็จ:', data.payload.time_leave_id)
} else {
  console.error('Error:', data.errors || data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/submit"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "employee_code": "EMP001",
    "absence_flag_lv": "absence-01",
    "effective_hour": "2026-01-15 08:00:00",
    "expire_hour": "2026-01-15 17:00:00",
    "time_leave_desc": "ไม่สบาย มีไข้"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('สร้างคำขอสำเร็จ:', data['payload']['time_leave_id'])
else:
    print('Error:', data.get('errors') or data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/submit";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "employee_code" => "EMP001",
    "absence_flag_lv" => "absence-01",
    "effective_hour" => "2026-01-15 08:00:00",
    "expire_hour" => "2026-01-15 17:00:00",
    "time_leave_desc" => "ไม่สบาย มีไข้"
];
 
$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']['time_leave_id'];
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['error']);
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`employee_code`	ต้องระบุและเป็น string	`Missing required parameter: 'employee_code'`
`absence_flag_lv`	ต้องระบุและเป็น `01`-`08` หรือ `10`-`20`	`'absence_flag_lv' must be 01 to 08 or 10 to 20`
`effective_hour`	ต้องระบุและรูปแบบ YYYY-MM-DD HH:MM:SS	`'effective_hour' must be in format YYYY-MM-DD HH:MM:SS`
`expire_hour`	ต้องระบุและรูปแบบ YYYY-MM-DD HH:MM:SS	`'expire_hour' must be in format YYYY-MM-DD HH:MM:SS`
`expire_hour`	ต้อง >= effective_hour	`'expire_hour' must be greater than or equal to 'effective_hour'`

Business Rules

ข้อจำกัดการยื่นคำขอ:

ไม่สามารถยื่นคำขอในงวดเงินเดือนที่ปิดแล้ว
เวลาสิ้นสุดต้องมากกว่าหรือเท่ากับเวลาเริ่มต้น
ไม่สามารถยื่นเอกสารซ้ำซ้อนกับช่วงเวลาที่มีอยู่แล้ว
จำกัดการยื่นเอกสารไม่เกิน 2 ฉบับต่อวัน
ต้องตรวจสอบว่าพนักงานมีอยู่ในระบบ

Error Handling

Error	Cause	Solution
`Missing required parameter: 'employee_code'`	ไม่ได้ส่ง employee_code	ตรวจสอบ request body
`Employee not found`	ไม่พบพนักงาน	ตรวจสอบ employee_code
`มีการลาซ้ำซ้อนกับเอกสารที่มีอยู่แล้ว`	ช่วงเวลาซ้ำกับคำขอที่มีอยู่	ตรวจสอบช่วงเวลา
`ไม่สามารถขอเอกสารเกิน 2 ฉบับ ต่อวัน`	เกินจำนวนเอกสารต่อวัน	รอวันถัดไป
`ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว`	งวดเงินเดือนปิดแล้ว	เลือกวันที่ในงวดที่เปิดอยู่

Notes

Use Cases

พนักงานยื่นคำขอลา - สร้างคำขอผ่าน Self-service
HR สร้างคำขอแทน - สร้างคำขอให้พนักงานที่ไม่มี access
Import ข้อมูลจากระบบภายนอก - นำเข้าข้อมูลการลาจากระบบอื่น

Time Format

effective_hour และ expire_hour ใช้รูปแบบ YYYY-MM-DD HH:MM:SS
ตัวอย่าง: 2026-01-15 08:00:00

File Attachment

ส่งไฟล์แนบเป็น Base64 encoded string ใน image_content
รองรับไฟล์รูปภาพ (PNG, JPG, etc.)

Get Leave Types - ดึงรายการประเภทการลา
Get Leave List - ดึงรายการคำขอลา
Update Leave - แก้ไขคำขอลา
Delete Leave - ลบคำขอลา

Submit Leave

Endpoint

Request Parameters

Required Parameters

Optional Parameters

Request Body Example

Response Format

Success Response (HTTP 200)

Error Response - Validation Failed (HTTP 400)

Error Response - Employee Not Found (HTTP 400)

Error Response - Duplicate Leave (HTTP 400)

Error Response - Document Limit (HTTP 400)

Error Response - Salary Period Closed (HTTP 400)

Response Fields

Code Examples

cURL

JavaScript

Python

PHP

Validation Rules

Business Rules

Error Handling

Notes

Use Cases

Time Format

File Attachment

Related APIs