Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Setting

Router สำหรับเพิ่มข้อมูลการตั้งค่าพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter

API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทการตั้งค่าที่ต้องการเพิ่ม

Endpoint

POST /api/v1/open-apis/employee/add-employee-setting

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesประเภทข้อมูลที่ต้องการเพิ่ม

Base Parameters

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน

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

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID

  • Response จะ return raw string ID (เช่น 20260121FC89F3BB9120)
  • เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน

Supported Actions

path_actionDescriptionRequired Params
userเพิ่มบัญชีผู้ใช้งานใหม่employee_code
actual-quotaเพิ่มโควตาการลาจริงemployee_code, quota_id, work_date, leave_value
facialเพิ่มใบหน้าสำหรับลงเวลาemployee_code, image64

Action Details

1. user - เพิ่มบัญชีผู้ใช้งานใหม่

สร้างบัญชีผู้ใช้งานใหม่ให้กับพนักงาน

Request Body:

ParameterTypeRequiredDescription
user_namestringYesชื่อผู้ใช้

Auto Actions:

  • Normalize Username (แปลงเป็นตัวพิมพ์เล็ก)
  • Set User Type = ‘hrs’
  • Set First Sign-in Flag = ‘Y’
  • Assign Default User Group

Response:

{ "code": 200, "message": "Add User Success", "payload": { "user_id": "20260121PS01B2C3D4E5", "user_name": "somchai.j", "employee_code": "EMP001", "user_type": "hrs", "first_singin_flag": "Y" } }

พนักงาน 1 คนมีได้ 1 บัญชี ถ้ามีอยู่แล้วให้ใช้ reset_username หรือ reset_password แทน


2. actual-quota - เพิ่มโควตาการลาจริง

เพิ่มจำนวนวันลาที่ใช้จริงของพนักงาน

Request Body:

ParameterTypeRequiredDescriptionExample
quota_idstringYesID ของโควตา (Base64)"MjAyNjAxMTVRVDAxQTJCM0M0RDU="
work_datestringYesวันที่ลา (YYYY-MM-DD)"2026-06-15"
leave_valuestringYesจำนวนวันลา"1"
remarkstringNoหมายเหตุ"ลาป่วยเพิ่มเติม"

Response:

{ "code": 200, "message": "Add Actual Quota Success", "payload": { "actual_quota_id": "20260121PS01B2C3D4E5", "quota_id": "QT001", "work_date": "2024-06-15", "leave_value": "1" } }

3. facial - เพิ่มใบหน้าสำหรับลงเวลา

เพิ่มรูปใบหน้าพนักงานสำหรับระบบลงเวลา

Request Body:

ParameterTypeRequiredDescription
image64stringYesรูปภาพ Base64 encoded

Response:

{ "code": 200, "message": "Add Facial Success", "payload": { "employee_facial_id": "20260121PS01B2C3D4E5", "employee_code": "EMP001", "documents_path": "https://openapi.humansoft.co.th/files/employee/facial/aBcDeFgHiJkLmNoPqRsTuVwXyZ1234.jpg" } }

รูปภาพควรเห็นใบหน้าชัดเจน หันตรง แสงสว่างเพียงพอ


Error Response

{ "code": 400, "message": "ข้อมูลไม่ถูกต้อง", "errors": [ "กรุณาระบุ 'path_action'", "กรุณาระบุ 'employee_code'" ] }

Code Examples

# เพิ่มบัญชีผู้ใช้งานใหม่ curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=user" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "user_name": "somchai.j" }' # เพิ่มโควตาการลาจริง curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=actual-quota" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "quota_id": "MjAyNjAxMTVRVDAxQTJCM0M0RDU=", "work_date": "2026-06-15", "leave_value": "1", "remark": "ลาป่วยเพิ่มเติม" }' # เพิ่มใบหน้าสำหรับลงเวลา curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=facial" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "image64": "data:image/jpeg;base64,/9j/4AAQ..." }'

Troubleshooting

ErrorSolution
กรุณาระบุ ‘path_action’ต้องระบุ path_action ใน query parameter
กรุณาระบุ ‘employee_code’ต้องระบุ employee_code
ไม่พบไฟล์สำหรับ actionตรวจสอบว่า path_action ตรงกับรายการที่รองรับ

Last updated on