Delete Time Adjust

ลบเอกสารขอเพิ่มเวลาทำงาน

ใช้ API นี้เพื่อลบเอกสารขอเพิ่มเวลาทำงานที่ยื่นผิดพลาดหรือไม่ต้องการแล้ว เอกสารที่ลบจะไม่แสดงในรายการอีกต่อไป

Endpoint


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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`time_adjust_id`	string	Yes	รหัสเอกสารที่ต้องการลบ (base64)	`MjAyNjAyMTFBMjEyQ0Q0NTZFRg==`

Optional Parameters

Parameter	Type	Default	Description
`employee_code`	string	-	รหัสพนักงาน (สำหรับตรวจสอบสิทธิ์)

Request Body Example


{
  "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
  "employee_code": "EMP001"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "time_adjust_id": "20260218AB123CD456EF",
    "employee_code": "EMP001",
    "time_adjust_dt": "2026-02-18",
    "deleted_at": "2026-02-18 14:30:00"
  }
}

Error Response - Not Found (HTTP 400)


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

Error Response - Already Deleted (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Time adjust record already deleted"
}

Error Response - Salary Period Closed (HTTP 400)


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

Error Response - Unauthorized (HTTP 403)


{
  "code": 403,
  "message": "ไม่สำเร็จ",
  "error": "Unauthorized to delete this record"
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'time_adjust_id'"
  ]
}

Response Fields

Field	Type	Description
`time_adjust_id`	string	รหัสเอกสารที่ถูกลบ
`employee_code`	string	รหัสพนักงาน
`time_adjust_dt`	string	วันที่เอกสาร
`deleted_at`	string	วันเวลาที่ลบ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/delete" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "employee_code": "EMP001"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/delete',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      time_adjust_id: 'MjAyNjAyMTFBMjEyQ0Q0NTZFRg==',
      employee_code: 'EMP001'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('ลบสำเร็จ:', data.payload.time_adjust_id)
  console.log('ลบเมื่อ:', data.payload.deleted_at)
} else {
  console.error('Error:', data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/delete"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "time_adjust_id": "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "employee_code": "EMP001"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('ลบสำเร็จ:', data['payload']['time_adjust_id'])
    print('ลบเมื่อ:', data['payload']['deleted_at'])
else:
    print('Error:', data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/delete";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "time_adjust_id" => "MjAyNjAyMTFBMjEyQ0Q0NTZFRg==",
    "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']['time_adjust_id'] . "\n";
    echo "ลบเมื่อ: " . $data['payload']['deleted_at'];
} else {
    echo "Error: " . $data['error'];
}
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`time_adjust_id`	ต้องระบุและเป็น string	`Missing required parameter: 'time_adjust_id'`
`time_adjust_id`	ต้องมีอยู่ในระบบ	`Time adjust record not found`
`employee_code`	ต้องเป็นเจ้าของเอกสาร (ถ้าระบุ)	`Unauthorized to delete this record`

Business Rules

ข้อจำกัดการลบ:

เอกสารที่ลบจะไม่แสดงในรายการอีกต่อไป
รายการเวลาที่เกี่ยวข้องจะถูกลบด้วย
การแจ้งเตือนที่เกี่ยวข้องจะถูกอัปเดตอัตโนมัติ
ไม่สามารถลบเอกสารที่ลบไปแล้ว
ไม่สามารถลบเอกสารในงวดเงินเดือนที่ปิดแล้ว (ยกเว้น HR)
ต้องเป็นเจ้าของเอกสารจึงจะสามารถลบได้

Error Handling

Error	Cause	Solution
`Missing required parameter: 'time_adjust_id'`	ไม่ได้ส่ง time_adjust_id	ตรวจสอบ request body
`Time adjust record not found`	ไม่พบเอกสาร	ตรวจสอบ time_adjust_id
`Time adjust record already deleted`	เอกสารถูกลบไปแล้ว	ไม่ต้องดำเนินการ
`Unauthorized to delete this record`	ไม่มีสิทธิ์ลบเอกสารนี้	ตรวจสอบ employee_code หรือสิทธิ์การใช้งาน
`ไม่สามารถลบได้ งวดเงินเดือนปิดแล้ว`	งวดเงินเดือนปิดแล้ว	ติดต่อ HR

Notes

Use Cases

ยกเลิกคำขอผิดพลาด - ลบเอกสารที่ยื่นผิดวันหรือผิดประเภท
ทำความสะอาดข้อมูล - ลบเอกสารที่ไม่ต้องการแล้ว
แก้ไขข้อมูล - ลบเอกสารเดิมก่อนสร้างใหม่ (กรณีไม่สามารถ update ได้)

หา time_adjust_id

ใช้ Get Adjust List เพื่อดู time_adjust_id ของเอกสารที่ต้องการลบ

Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา
Submit Adjust - ยื่นเอกสารขอเพิ่มเวลาใหม่
Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา

Delete Time Adjust

Endpoint

Request Parameters

Required Parameters

Optional Parameters

Request Body Example

Response Format

Success Response (HTTP 200)

Error Response - Not Found (HTTP 400)

Error Response - Already Deleted (HTTP 400)

Error Response - Salary Period Closed (HTTP 400)

Error Response - Unauthorized (HTTP 403)

Error Response - Validation Failed (HTTP 422)

Response Fields

Code Examples

cURL

JavaScript

Python

PHP

Validation Rules

Business Rules

Error Handling

Notes

Use Cases

หา time_adjust_id

Related APIs