Approve Adjust

อนุมัติหรือปฏิเสธเอกสารขอเพิ่มเวลาทำงาน รองรับการอนุมัติแบบหลายขั้นตอน (Multi-level Approval)

ใช้ API นี้เพื่ออนุมัติ ปฏิเสธ หรือยกเลิกเอกสารขอเพิ่มเวลาทำงาน ระบบรองรับการอนุมัติแบบหลายขั้นตอนตามสายการอนุมัติที่บริษัทกำหนด

Endpoint


POST /api/v1/open-apis/time-adjust/approve

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`time_adjust_id`	string	Yes	รหัสเอกสาร (Base64)	`MjAyNjAyMTFBMjEyQ0Q0NTZFRg==`
`employee_code`	string	Yes	รหัสพนักงาน (สำหรับตรวจสอบสิทธิ์)	`EMP001`
`approve_flag`	string	Yes	สถานะการอนุมัติ (`02`-`08`)	`02`
`authorize_id`	string	Yes	รหัสผู้อนุมัติ (Base64)	`MjAyNjAyMTFBMjEyQ0Q0NTZFRg==`

Optional Parameters

Parameter	Type	Default	Description
`approve_remark`	string	`""`	หมายเหตุ (บังคับสำหรับการปฏิเสธ)
`authorize_line`	string	`""`	เช็คสายอนุมัติตามลำดับ (`true`/`false`)
`extra_round`	string	`"N"`	งวดพิเศษ (`Y`/`N`)
`no_hr_permission`	boolean	`false`	ระงับสิทธิพิเศษ HR

Option Values for approve_flag

ค่า	สถานะ (TH)	สถานะ (EN)	การทำงาน
`02`	อนุมัติ	Approved	อนุมัติขั้นสุดท้าย — ระบบจะบันทึกเวลาเข้าสู่ระบบอัตโนมัติ
`03`	ไม่อนุมัติ	Not Approved	ปฏิเสธเอกสาร
`04`	หัวหน้าอนุมัติขั้นที่ 1	Manager Approved Step 1	ส่งต่อไปยังขั้นตอนถัดไป
`05`	ยกเลิก	Cancelled	ยกเลิก/ถอนคืนเอกสาร
`06`	หัวหน้าอนุมัติขั้นที่ 2	Manager Approved Step 2	ส่งต่อไปยังขั้นตอนถัดไป
`07`	หัวหน้าอนุมัติขั้นที่ 3	Manager Approved Step 3	ส่งต่อไปยังขั้นตอนถัดไป
`08`	หัวหน้าอนุมัติขั้นที่ 4	Manager Approved Step 4	ส่งต่อไปยังขั้นตอนถัดไป

authorize_line — เมื่อส่ง true ผู้ใช้ที่เป็น HR จะต้องผ่านกระบวนการอนุมัติตามลำดับเหมือนพนักงานทั่วไป (ไม่ bypass สายอนุมัติ)

no_hr_permission — เมื่อส่ง true ระบบจะระงับสิทธิพิเศษ HR ทำให้ต้องตรวจสอบกฎอย่างเคร่งครัด (เช่น cut-off date)

Request Body Example


{
  "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
  "employee_code": "EMP001",
  "approve_flag": "02",
  "authorize_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
  "approve_remark": "อนุมัติ"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "time_adjust_id": "20260218AB123CD456EF",
    "employee_code": "EMP001",
    "time_adjust_dt": "2026-02-18",
    "approve_flag": "02",
    "approve_remark": "อนุมัติ",
    "approved_at": "2026-02-18 15:30:00"
  }
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'time_adjust_id'",
    "'approve_flag' must be 02-08"
  ]
}

Error Response - Remark Required for Rejection (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "'approve_remark' is required when approve_flag is '03'"
  ]
}

Error Response - Document Not Found (HTTP 404)


{
  "code": 404,
  "message": "ไม่สำเร็จ",
  "error": "Time adjust record not found"
}

Error Response - Unauthorized (HTTP 403)


{
  "code": 403,
  "message": "ไม่สำเร็จ",
  "error": "ไม่มีสิทธิ์อนุมัติเอกสารนี้"
}

Error Response - Salary Period Closed (HTTP 400)


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

Error Response - Cut-off Date Exceeded (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "เกินวันที่ cut-off แล้ว"
}

Response Fields

Field	Type	Description
`time_adjust_id`	string	รหัสเอกสาร
`employee_code`	string	รหัสพนักงาน
`time_adjust_dt`	string	วันที่ขอเพิ่มเวลา (YYYY-MM-DD)
`approve_flag`	string	สถานะการอนุมัติ
`approve_remark`	string	หมายเหตุการอนุมัติ
`approved_at`	string	วันเวลาที่อนุมัติ (YYYY-MM-DD HH:MM:SS)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "employee_code": "EMP001",
    "approve_flag": "02",
    "authorize_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "approve_remark": "อนุมัติ"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      time_adjust_id: 'MjAyNjAyMTFBMjEyQ0Q0NTZFRg==',
      employee_code: 'EMP001',
      approve_flag: '02',
      authorize_id: 'MjAyNjAyMTFBMjEyQ0Q0NTZFRg==',
      approve_remark: 'อนุมัติ'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.time_adjust_id)
  console.log('สถานะ:', data.payload.approve_flag)
  console.log('อนุมัติเมื่อ:', data.payload.approved_at)
} else {
  console.error('Error:', data.errors || data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "employee_code": "EMP001",
    "approve_flag": "02",
    "authorize_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "approve_remark": "อนุมัติ"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('อนุมัติสำเร็จ:', data['payload']['time_adjust_id'])
    print('สถานะ:', data['payload']['approve_flag'])
    print('อนุมัติเมื่อ:', data['payload']['approved_at'])
else:
    print('Error:', data.get('errors') or data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "time_adjust_id" => "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "employee_code" => "EMP001",
    "approve_flag" => "02",
    "authorize_id" => "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "approve_remark" => "อนุมัติ"
];
 
$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_adjust_id'] . "\n";
    echo "สถานะ: " . $data['payload']['approve_flag'] . "\n";
    echo "อนุมัติเมื่อ: " . $data['payload']['approved_at'];
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['error']);
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`time_adjust_id`	ต้องระบุและเป็น string	`Missing required parameter: 'time_adjust_id'`
`employee_code`	ต้องระบุและเป็น string	`Missing required parameter: 'employee_code'`
`approve_flag`	ต้องระบุและเป็น `02`-`08`	`'approve_flag' must be 02-08`
`authorize_id`	ต้องระบุและเป็น string	`Missing required parameter: 'authorize_id'`
`approve_remark`	บังคับเมื่อ `approve_flag` = `03` (ปฏิเสธ)	`'approve_remark' is required when approve_flag is '03'`
`time_adjust_id`	ต้องมีอยู่ในระบบ	`Time adjust record not found`

Business Rules

ข้อจำกัดการอนุมัติ:

ระบบคำนวณขั้นตอนถัดไปอัตโนมัติตามสายการอนุมัติที่กำหนด
เมื่ออนุมัติขั้นสุดท้าย (approve_flag = 02) ระบบจะบันทึกเวลาเข้าสู่ระบบอัตโนมัติ
การปฏิเสธ (approve_flag = 03) ต้องระบุ approve_remark เสมอ
HR สามารถข้ามการตรวจสอบ cut-off date ได้ (ยกเว้น no_hr_permission = true)
ต้องไม่อยู่ในงวดเงินเดือนที่ปิดแล้ว
ต้องมีสิทธิ์อนุมัติเอกสาร
ระบบจะส่งการแจ้งเตือนอัตโนมัติ

Error Handling

Error	Cause	Solution
`Missing required parameter: 'time_adjust_id'`	ไม่ได้ส่ง time_adjust_id	ตรวจสอบ request body
`Missing required parameter: 'approve_flag'`	ไม่ได้ส่ง approve_flag	ตรวจสอบ request body
`'approve_flag' must be 02-08`	ค่า approve_flag ไม่ถูกต้อง	ใช้ค่า `02`-`08` ตามตาราง Option Values
`'approve_remark' is required when approve_flag is '03'`	ปฏิเสธโดยไม่ระบุหมายเหตุ	ส่ง `approve_remark` เมื่อ `approve_flag` = `03`
`Time adjust record not found`	ไม่พบเอกสาร	ตรวจสอบ `time_adjust_id`
`ไม่มีสิทธิ์อนุมัติเอกสารนี้`	ไม่มีสิทธิ์อนุมัติ	ตรวจสอบสิทธิ์ผู้อนุมัติ (`authorize_id`)
`ไม่สามารถบันทึกได้ งวดเงินเดือนปิดแล้ว`	งวดเงินเดือนปิดแล้ว	เลือกเอกสารในงวดที่เปิดอยู่
`เกินวันที่ cut-off แล้ว`	เกินวัน cut-off	ติดต่อ HR หรือส่ง `no_hr_permission` = `false`

Notes

Use Cases

หัวหน้าอนุมัติคำขอ - อนุมัติเอกสารขอเพิ่มเวลาของพนักงานในสายงาน
HR อนุมัติหรือปฏิเสธเอกสาร - อนุมัติหรือปฏิเสธเอกสารในฐานะ HR
อนุมัติแบบหลายขั้นตอน - ส่ง approve_flag = 04-08 เพื่ออนุมัติในแต่ละขั้นตอน
ยกเลิกเอกสาร - ส่ง approve_flag = 05 เพื่อยกเลิก/ถอนคืนเอกสาร

Approval Flow

04 -> 06 -> 07 -> 08 -> 02 (ตามสายการอนุมัติที่กำหนด)
ระบบจะคำนวณขั้นตอนถัดไปอัตโนมัติ ไม่จำเป็นต้องส่ง approve_flag ถัดไปเอง
หากเป็นขั้นตอนสุดท้าย ระบบจะเปลี่ยนสถานะเป็น 02 (Approved) อัตโนมัติ

HR Special Permission

โดยปกติ HR สามารถข้ามการตรวจสอบ cut-off date ได้
หากต้องการให้ HR ปฏิบัติตามกฎเดียวกับพนักงานทั่วไป ให้ส่ง authorize_line = true และ/หรือ no_hr_permission = true

Submit Adjust - ยื่นเอกสารขอเพิ่มเวลา
Get Adjust Detail - ดึงรายละเอียดเอกสาร (ตรวจสอบข้อมูลก่อนอนุมัติ)
Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา
Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
Delete Adjust - ลบเอกสารขอเพิ่มเวลา