Get Adjust Detail
ดึงรายละเอียดเอกสารขอเพิ่มเวลาทำงานรายการเดียว โดยระบุ time_adjust_id ของเอกสารที่ต้องการ
ใช้ API นี้เพื่อแสดงรายละเอียดเอกสาร ตรวจสอบข้อมูลก่อนอนุมัติ/แก้ไข หรือตรวจสอบสถานะการอนุมัติ สามารถส่ง authorize_id เพื่อตรวจสอบว่าผู้ใช้มีสิทธิ์อนุมัติเอกสารนี้หรือไม่ (authorize_flag)
Endpoint
GET /api/v1/open-apis/time-adjust/get-detailสิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)
Request Parameters
Required Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
time_adjust_id | string | Yes | รหัสเอกสาร (Base64) |
Optional Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
authorize_id | string | - | ID ผู้ใช้ที่ต้องการตรวจสิทธิ์อนุมัติ (Base64) ใช้คำนวณ authorize_flag |
authorize_line | string | - | ส่ง true เพื่อให้ authorize_flag พิจารณาเฉพาะสายการอนุมัติของผู้ใช้ตาม authorize_id (ไม่นับสิทธิ์ HR ของผู้เรียก API) หากไม่ต้องการ ให้ละ parameter นี้ไว้ |
language_code | string | TH | ภาษาของชื่อในข้อมูล เช่น ชื่อพนักงาน ประเภทเอกสาร และสถานะ (TH หรือ EN) |
การส่ง authorize_line=false จะให้ผลเหมือนส่ง true หากไม่ต้องการตรวจตามสายการอนุมัติ ให้ละ authorize_line ออกจาก request
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"time_adjust_id": "20251127D4573C421639",
"employee_id": "20251127D4573C421639",
"employee_code": "EMP001",
"employee_name": "สมชาย",
"employee_last_name": "ใจดี",
"employee_nickname": "ชาย",
"employee_name_en": "Somchai",
"employee_last_name_en": "Jaidee",
"photograph": "https://cdn.humansoft.co.th/.../images/userPlaceHolder.png",
"time_adjust_dt": "2026-02-25",
"time_adjust_flag_lv": "01",
"flag_name": "ลืมลงเวลา",
"flag_name_en": "Forget to enter time",
"time_adjust_desc": "ลืมรูดบัตรเข้างาน",
"image_url": "https://cdn.humansoft.co.th/.../image/a1B2c3D4e5F6.png",
"time_adjust_list": [
{
"time_adjust_list_id": "20251127D4573C421639",
"time_adjust_list_dt": "2026-02-25 08:00:00"
}
],
"header": "สมชาย ใจดี (ชาย) ยื่นขอ \"ลืมลงเวลา\"",
"detail": "ขอวันที่ 25/02/2026 เวลา 08:00\nหมายเหตุ : ลืมรูดบัตรเข้างาน\n",
"approve_flag": "01",
"approve_flag_name": "รออนุมัติ",
"approve_by": "สมหญิง มากมาย",
"approve_remark": null,
"read_only_flag": "N",
"authorize_flag": true,
"company_name": "บริษัท ABC",
"branch_name": "สำนักงานใหญ่",
"department_name": "แผนกขาย",
"position_name": "พนักงาน",
"work_cycle_code": "A",
"work_cycle_time": "08:00 - 12:00 - 13:00 - 17:00",
"time": [
{ "type": "new", "value": "2026-02-25 08:00:00" },
{ "type": "old", "value": "2026-02-25 17:02:00" }
],
"created": "2026-02-25 11:36:06",
"created_format": "25/02/2026 11:36"
}
}Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "ไม่สำเร็จ",
"errors": [
"Missing required parameter: 'time_adjust_id'"
]
}Error Response - Document Not Found (HTTP 404)
{
"code": 404,
"message": "ไม่พบข้อมูลเอกสาร"
}Error Response - Failed (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "<รายละเอียดข้อผิดพลาด>"
}Response Fields
Document Info
| Field | Type | Nullable | Description |
|---|---|---|---|
time_adjust_id | string | No | รหัสเอกสาร |
time_adjust_dt | string | No | วันที่เอกสาร (รูปแบบ YYYY-MM-DD) |
time_adjust_flag_lv | string | No | รหัสประเภทเอกสาร (ดู Get Adjust Types) |
flag_name | string | No | ชื่อประเภทเอกสาร ตามภาษาที่ระบุใน language_code |
flag_name_en | string | No | ชื่อประเภทเอกสาร (ภาษาอังกฤษ) |
time_adjust_desc | string | Yes | คำอธิบายเพิ่มเติม |
image_url | string | Yes | URL ของไฟล์แนบ, null หากไม่มีไฟล์แนบ |
time_adjust_list | array | No | รายการเวลาที่ขอเพิ่มในเอกสาร (สูงสุด 4 รายการ เรียงตามเวลา) |
header | string | No | หัวข้อเอกสาร (ชื่อพนักงานและประเภทเอกสาร ตามภาษา) |
detail | string | No | รายละเอียดเอกสาร (วันที่ เวลาที่ขอ และหมายเหตุ ตามภาษา) |
time_adjust_list Object Elements
| Field | Type | Nullable | Description |
|---|---|---|---|
time_adjust_list_id | string | No | รหัสรายการเวลา |
time_adjust_list_dt | string | No | วันเวลาที่ขอเพิ่ม (รูปแบบ YYYY-MM-DD HH:mm:ss) |
Approval Info
| Field | Type | Nullable | Description |
|---|---|---|---|
approve_flag | string | No | รหัสสถานะการอนุมัติ 01-08 ตามจริงของเอกสาร (ดูความหมายที่ Get Adjust List) |
approve_flag_name | string | No | ชื่อสถานะการอนุมัติ ตามภาษา |
approve_by | string | No | ชื่อผู้ใช้ที่บันทึกเป็นผู้ดำเนินการล่าสุดของเอกสาร — ผ่าน Open API คือผู้ใช้ตาม authorize_id ที่ส่งตอนยื่น แก้ไข หรืออนุมัติ (ค่าว่างหากไม่มี) |
approve_remark | string | Yes | หมายเหตุจากผู้อนุมัติ |
read_only_flag | string | No | สถานะงวดเงินเดือนที่ครอบคลุม time_adjust_dt: Y = งวดเป็นแบบอ่านอย่างเดียว, N = ไม่ใช่ (เป็น N เมื่อไม่พบงวด หรือวันที่อยู่ในรอบ OT/รอบเวลาทำงานที่ยังเปิดอยู่) |
authorize_flag | boolean | No | ผู้ใช้ตาม authorize_id มีสิทธิ์อนุมัติเอกสารนี้หรือไม่ (ดู authorize_line) |
Employee Info
| Field | Type | Nullable | Description |
|---|---|---|---|
employee_id | string | No | ID ของพนักงาน |
employee_code | string | No | รหัสพนักงาน (รหัสประจำตัว) |
employee_name | string | No | ชื่อพนักงาน ตามภาษาที่ระบุใน language_code |
employee_last_name | string | No | นามสกุลพนักงาน ตามภาษา |
employee_nickname | string | Yes | ชื่อเล่น ตามภาษา |
employee_name_en | string | Yes | ชื่อพนักงาน (ภาษาอังกฤษ) |
employee_last_name_en | string | Yes | นามสกุล (ภาษาอังกฤษ) |
photograph | string | Yes | URL รูปโปรไฟล์พนักงาน |
Organization Info
| Field | Type | Nullable | Description |
|---|---|---|---|
company_name | string | Yes | ชื่อบริษัท ตามภาษา (ไม่มี field นี้หากไม่พบข้อมูลบริษัทของพนักงาน) |
branch_name | string | Yes | ชื่อสาขา ตามภาษา |
department_name | string | Yes | ชื่อแผนก ตามภาษา |
division_name | string | Yes | ชื่อส่วนงาน (ภาษาไทย) |
section_name | string | Yes | ชื่อฝ่าย (ภาษาไทย) |
position_name | string | Yes | ชื่อตำแหน่ง ตามภาษา |
Work & Time Info
| Field | Type | Nullable | Description |
|---|---|---|---|
work_cycle_code | string | Yes | รหัสกะการทำงานของวันที่เอกสาร (ไม่มี field นี้หากไม่มีข้อมูลกะของวันนั้น) |
work_cycle_time | string | Yes | เวลาเข้างาน - เริ่มพัก - สิ้นสุดพัก - เวลาออกงาน (เช่น 08:00 - 12:00 - 13:00 - 17:00) ไม่มี field นี้หากไม่มีข้อมูลกะของวันนั้น |
time | array | No | เวลาที่บันทึกไว้แล้วของวันนั้น รวมกับเวลาที่ขอเพิ่มในเอกสาร เรียงตามเวลา |
created | string | No | วันเวลาที่สร้างเอกสาร (รูปแบบ YYYY-MM-DD HH:mm:ss) |
created_format | string | No | วันเวลาที่สร้างเอกสาร (แสดงผล เช่น 25/02/2026 11:36) |
time Object Elements
| Field | Type | Nullable | Description |
|---|---|---|---|
type | string | No | old = เวลาที่บันทึกในระบบลงเวลาแล้ว, new = เวลาที่ขอเพิ่มในเอกสาร (หากเวลาตรงกันจะแสดงเป็น new) |
value | string | No | ค่าเวลา (รูปแบบ YYYY-MM-DD HH:mm:ss) |
Code Examples
cURL
# ดึงรายละเอียดเอกสาร
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-detail?time_adjust_id=MjAyNTExMjdENDU3M0M0MjE2Mzk=" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
# ดึงรายละเอียดพร้อมตรวจสอบสิทธิ์อนุมัติตามสายการอนุมัติ
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-detail?time_adjust_id=MjAyNTExMjdENDU3M0M0MjE2Mzk=&authorize_id=MjAyNjA0MzBVU0VSMDAwMDAx&authorize_line=true" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Error Handling
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | API Key ไม่ถูกต้องหรือหมดอายุ | ตรวจสอบ Ocp-Apim-Subscription-Key header |
| 404 Not Found | ไม่พบเอกสารตาม time_adjust_id ที่ระบุ หรือเอกสารถูกลบแล้ว | ตรวจสอบ time_adjust_id ว่าถูกต้องและเข้ารหัส Base64 แล้ว |
| 422 Validation Failed | ไม่ส่ง time_adjust_id | ตรวจสอบ required parameters |
| 400 Failed | เกิดข้อผิดพลาดระหว่างดึงข้อมูล (รายละเอียดอยู่ใน error) | ลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน |
| 500 System Error | เกิดข้อผิดพลาดภายในระบบ | ลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน |
Notes
- ค่า
time_adjust_idได้จากdoc_idใน API Get Adjust List หรือจาก response ของ Submit Adjust ซึ่งเป็นค่า raw ต้องเข้ารหัส Base64 ก่อนส่ง authorize_flagคำนวณจากผู้ใช้ตามauthorize_idควรส่งauthorize_idเพื่อให้ค่านี้สะท้อนสิทธิ์ของผู้ใช้ที่ต้องการตรวจ- หากไม่ส่ง
authorize_lineระบบจะนับสิทธิ์ HR ของผู้เรียก API ด้วย ทำให้authorize_flagอาจเป็นtrueแม้ผู้ใช้ไม่อยู่ในสายการอนุมัติ หากส่งauthorize_line=trueจะพิจารณาเฉพาะสายการอนุมัติ
Use Cases
- แสดงรายละเอียดเอกสาร - ใช้แสดงข้อมูลครบถ้วนของเอกสารขอเพิ่มเวลา เช่น ประเภทเอกสาร, รายการเวลา, ไฟล์แนบ, สถานะการอนุมัติ
- ตรวจสอบก่อนอนุมัติ - ผู้อนุมัติดูรายละเอียดเอกสารก่อนตัดสินใจอนุมัติหรือปฏิเสธ โดยส่ง
authorize_id(และauthorize_line=trueหากต้องการตรวจตามสายการอนุมัติ) เพื่อตรวจสอบสิทธิ์ - ตรวจสอบสถานะ - ใช้ฟิลด์
approve_flagและapprove_flag_nameเพื่อแสดงสถานะการอนุมัติปัจจุบัน - เตรียมข้อมูลก่อนแก้ไข - ใช้
time_adjust_listเป็นรายการเวลาเดิมเมื่อเรียก Update Adjust
Related APIs
- Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา (ใช้เพื่อหา
time_adjust_id) - Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
- Approve Adjust - อนุมัติหรือปฏิเสธเอกสาร
- Delete Adjust - ลบเอกสารขอเพิ่มเวลา
Last updated on