Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Adjust Detail

ดึงรายละเอียดเอกสารขอเพิ่มเวลาทำงานรายการเดียว โดยระบุ time_adjust_id ของเอกสารที่ต้องการ

ใช้ API นี้เพื่อแสดงรายละเอียดเอกสาร ตรวจสอบข้อมูลก่อนอนุมัติ/แก้ไข หรือตรวจสอบสถานะการอนุมัติ สามารถส่ง authorize_line เพื่อตรวจสอบว่าผู้ใช้ปัจจุบันมีสิทธิ์อนุมัติเอกสารนี้หรือไม่

Endpoint

GET /api/v1/open-apis/time-adjust/get-detail

Request Parameters

Required Parameters

ParameterTypeRequiredDescription
time_adjust_idstringYesรหัสเอกสาร (base64)

Optional Parameters

ParameterTypeDefaultDescription
authorize_linestring"false"ตรวจสอบสายการอนุมัติ ("true" / "false")

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": { "time_adjust_id": "20260225BF89285583CF", "employee_id": "20260121FC89F3BB9120", "employee_code": "EMP001", "employee_name": "ธารวิน", "employee_last_name": "ศศิพฤกษ์กุล", "employee_nickname": "วิน", "employee_name_en": "Tharawin", "employee_last_name_en": "Sasiprukkun", "photograph": "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": "ลืมรูดบัตรเข้างาน", "header": "ธารวิน ศศิพฤกษ์กุล (วิน) ยื่นขอ \"ลืมลงเวลา\"", "detail": "ขอวันที่ 25/02/2026 เวลา 08:00,17: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": "พนักงาน", "day_status": "วันทำงาน", "work_cycle_code": "WC002", "work_cycle_time": "09:00 - 12:00 - 13:00 - 18:00", "time": [ { "type": "new", "value": "2026-02-25 08:00:00" }, { "type": "new", "value": "2026-02-25 17:00:00" } ], "created": "2026-02-25 11:36:06", "created_format": "25/02/2026 11:36" } }

Response Fields

Document Info

FieldTypeNullableDescription
time_adjust_idstringNoรหัสเอกสาร
time_adjust_dtstringNoวันที่เอกสาร (รูปแบบ YYYY-MM-DD)
time_adjust_flag_lvstringNoรหัสประเภทเหตุผล (01-06)
flag_namestringNoชื่อประเภทเหตุผล (ภาษาไทย)
flag_name_enstringNoชื่อประเภทเหตุผล (ภาษาอังกฤษ)
time_adjust_descstringYesคำอธิบายเพิ่มเติม
time_adjust_pathstringYesURL รูปภาพแนบ (ถ้ามี)
headerstringNoหัวข้อเอกสาร
detailstringNoรายละเอียดเอกสาร

Approval Info

FieldTypeNullableDescription
approve_flagstringNoรหัสสถานะการอนุมัติ (ดูรหัสได้ที่ Overview)
approve_flag_namestringNoชื่อสถานะการอนุมัติ
approve_bystringYesชื่อผู้อนุมัติ
approve_remarkstringYesหมายเหตุจากผู้อนุมัติ
read_only_flagstringNoเอกสารห้ามแก้ไข (Y) หรือแก้ไขได้ (N)
authorize_flagbooleanNoผู้ใช้ปัจจุบันมีสิทธิ์อนุมัติหรือไม่ (ต้องส่ง authorize_line=true)

Employee Info

FieldTypeNullableDescription
employee_idstringNoรหัสพนักงาน
employee_codestringNoรหัสพนักงาน (รหัสประจำตัว)
employee_namestringNoชื่อพนักงาน (ภาษาไทย)
employee_last_namestringNoนามสกุลพนักงาน (ภาษาไทย)
employee_nicknamestringYesชื่อเล่น (ภาษาไทย)
employee_name_enstringYesชื่อพนักงาน (ภาษาอังกฤษ)
employee_last_name_enstringYesนามสกุล (ภาษาอังกฤษ)
photographstringYesรูปภาพโปรไฟล์

Organization Info

FieldTypeNullableDescription
company_namestringNoชื่อบริษัท
branch_namestringYesชื่อสาขา
department_namestringYesชื่อแผนก
division_namestringYesชื่อส่วนงาน
section_namestringYesชื่อฝ่าย
position_namestringYesชื่อตำแหน่ง

Work & Time Info

FieldTypeNullableDescription
day_statusstringNoประเภทวัน (เช่น วันทำงาน, วันหยุด)
work_cycle_codestringNoรหัสกะการทำงาน
work_cycle_timestringNoคาบเวลาทำงาน (เช่น 09:00 - 12:00 - 13:00 - 18:00)
timearrayNoรายการเวลาเดิมและเวลาใหม่
createdstringNoวันเวลาที่สร้างเอกสาร (รูปแบบ YYYY-MM-DD HH:mm:ss)
created_formatstringNoวันเวลาที่สร้างเอกสาร (แสดงผล เช่น 25/02/2026 11:36)

time Object Elements

FieldTypeNullableDescription
typestringNoold = เวลาเดิม, new = เวลาใหม่ที่ขอปรับ
valuestringNoค่าเวลา (รูปแบบ YYYY-MM-DD HH:mm:ss)

Code Examples

# ดึงรายละเอียดเอกสาร curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-detail?time_adjust_id=20260225BF89285583CF" \ -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=20260225BF89285583CF&authorize_line=true" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Error Handling

ErrorCauseSolution
401 UnauthorizedAPI Key ไม่ถูกต้องหรือหมดอายุตรวจสอบ Ocp-Apim-Subscription-Key header
404 Not Foundไม่พบเอกสารตาม time_adjust_id ที่ระบุตรวจสอบ time_adjust_id ว่าถูกต้อง
422 Validation Failedข้อมูลไม่ถูกต้อง เช่น ไม่ส่ง time_adjust_idตรวจสอบ required parameters
500 System Errorเกิดข้อผิดพลาดภายในระบบลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน

Notes

  • ค่า time_adjust_id ได้จาก API Get Adjust List หรือจาก response ของ Submit Adjust
  • หากต้องการตรวจสอบสิทธิ์อนุมัติ ต้องส่ง authorize_line=true มิฉะนั้น authorize_flag จะเป็น false เสมอ
  • ฟิลด์ read_only_flag ใช้ตรวจสอบว่าเอกสารสามารถแก้ไขได้หรือไม่ ก่อนเรียก API Update Adjust

Use Cases

  1. แสดงรายละเอียดเอกสาร - ใช้แสดงข้อมูลครบถ้วนของเอกสารขอเพิ่มเวลา เช่น ประเภทเหตุผล, รายการเวลา, สถานะการอนุมัติ
  2. ตรวจสอบก่อนอนุมัติ - ผู้อนุมัติดูรายละเอียดเอกสารก่อนตัดสินใจอนุมัติหรือปฏิเสธ โดยส่ง authorize_line=true เพื่อตรวจสอบสิทธิ์
  3. ตรวจสอบสถานะ - ใช้ฟิลด์ approve_flag และ approve_flag_name เพื่อแสดงสถานะการอนุมัติปัจจุบัน
  4. ตรวจสอบก่อนแก้ไข - ตรวจสอบ read_only_flag ว่าเอกสารยังแก้ไขได้หรือไม่ ก่อนเรียก API แก้ไข
  • Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา (ใช้เพื่อหา time_adjust_id)
  • Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
  • Approve Adjust - อนุมัติหรือปฏิเสธเอกสาร
  • Delete Adjust - ลบเอกสารขอเพิ่มเวลา
Last updated on