Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Actual Leave

เพิ่มยอดลาจริงของพนักงาน (ยอดลาจริงคือการบันทึกการลาที่เกิดขึ้นจริงเพื่อหักจากโควตา)

Endpoint

POST /api/v1/open-apis/employee/add-employee-setting?path_action=quota-actual-leave

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น quota-actual-leave

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
leave_type_idstringYesID ของประเภทการลา
leave_datestringYesวันที่ลา (รูปแบบ: YYYY-MM-DD)
leave_daysnumberYesจำนวนวันลา (เช่น 1, 0.5)

ใช้ employee_code เพื่อระบุพนักงาน


Response Format

Success Response

{ "code": 200, "message": "Add Actual Leave Success", "payload": { "actual_leave_id": "20260121AQ01A2B3C4D5", "employee_id": "20260121EM01A2B3C4D5", "leave_type_id": "20260121LT01A2B3C4D5", "leave_type_name": "ลาป่วย", "leave_date": "2567-03-15", "leave_days": 1 } }

Response Fields

FieldTypeDescription
actual_leave_idstringID ของยอดลาจริงที่สร้าง
employee_idstringID ของพนักงาน
leave_type_idstringID ของประเภทการลา
leave_type_namestringชื่อประเภทการลา
leave_datestringวันที่ลา
leave_daysnumberจำนวนวันลา

Error Response

{ "code": 400, "message": "ไม่สำเร็จ", "errors": [ "Missing required parameter: 'leave_date'", "Missing required parameter: 'leave_days'" ] }

Validation Rules

FieldRule
employee_codeต้องระบุและต้องมีพนักงานในระบบ
leave_type_idต้องระบุและต้องเป็นประเภทการลาที่มีอยู่ในระบบ
leave_dateต้องระบุในรูปแบบ YYYY-MM-DD
leave_daysต้องเป็นตัวเลขมากกว่า 0 (รองรับทศนิยม เช่น 0.5 สำหรับลาครึ่งวัน)

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=quota-actual-leave" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "leave_type_id": "MjAyNjAxMjFMVDAxQTJCM0M0RDU=", "leave_date": "2567-03-15", "leave_days": 1 }'

Notes

  • ยอดลาจริงจะถูกหักจากโควตาการลาโดยอัตโนมัติ
  • สามารถระบุลาครึ่งวันได้ โดยใช้ leave_days: 0.5
  • ระบบจะเก็บ actual_leave_id สำหรับใช้อ้างอิงในการลบภายหลัง

Last updated on