Add Welfare Usage Log
เพิ่มบันทึกการใช้สวัสดิการของพนักงาน รองรับการอัพโหลดเอกสารแนบ
Endpoint
POST /api/v1/open-apis/employee/add-employee-financial?path_action=welfare-logQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น welfare-log |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes* | รหัสพนักงาน (ไม่ต้อง encode Base64) |
employee_id | string | Yes* | ID พนักงาน (ต้อง encode Base64) |
employee_welfare_year | string | Yes | ปีสวัสดิการ (YYYY) |
salary_type_id | string | Yes | ID ประเภทสวัสดิการ (ต้อง encode Base64) |
year_month | string | Yes | เดือนที่ใช้สวัสดิการ (YYYY-MM) |
welfare_amt | number | Yes | จำนวนเงินที่ใช้ (> 0) |
welfare_dt | string | No | วันที่ใช้สวัสดิการ (YYYY-MM-DD) |
welfare_desc | string | No | รายละเอียดการใช้สวัสดิการ |
welfare_doc | file | No | เอกสารแนบ (ต้องใช้ multipart/form-data) |
- ต้องระบุ
employee_codeหรือemployee_idอย่างใดอย่างหนึ่ง - Request parameters
employee_idและsalary_type_idต้อง encode เป็น Base64 - การอัพโหลดไฟล์ต้องใช้
multipart/form-datacontent type - ไม่สามารถเพิ่ม log ได้หากรอบเงินเดือนถูกปิดแล้ว
Response Format
Success Response
{
"code": 200,
"message": "Add Welfare Log Success",
"payload": {
"employee_welfare_year": "2026",
"salary_type_id": "20260121ST01A2B3C4D5",
"employee_id": "20260121EM01A2B3C4D5",
"master_salary_month": "2026-01",
"welfare_dt": "2026-01-15",
"welfare_desc": "ค่ารักษาพยาบาล",
"log_source": "Manual",
"log_balance": 1000,
"welfare_doc": "https://openapi.humansoft.co.th/files/employee/welfare/abc123def456.pdf",
"log_datetime": "NOW()",
"master_salary_report_id": "20260121MS01A2B3C4D5"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
code | number | รหัสสถานะ (200 = สำเร็จ) |
message | string | ข้อความตอบกลับ |
payload | object | ข้อมูลที่สร้างสำเร็จ |
payload.employee_welfare_year | string | ปีสวัสดิการ |
payload.salary_type_id | string | ID ประเภทสวัสดิการ (Plain text) |
payload.employee_id | string | ID พนักงาน (Plain text) |
payload.master_salary_month | string | เดือนที่ใช้สวัสดิการ |
payload.welfare_dt | string | วันที่ใช้สวัสดิการ |
payload.welfare_desc | string | รายละเอียด |
payload.log_source | string | แหล่งที่มา (Manual) |
payload.log_balance | number | จำนวนเงินที่ใช้ |
payload.welfare_doc | string | URL เอกสารแนบ (ถ้ามี) |
payload.master_salary_report_id | string | ID รายงานเงินเดือน (Plain text) |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing required parameter: 'year_month'",
"'welfare_amt' must be numeric and > 0"
]
}Master Salary Month is Read-Only
{
"code": 400,
"message": "Cannot add welfare log: Master salary month is read-only"
}Validation Rules
| Field | Rule |
|---|---|
employee_code or employee_id | ต้องระบุอย่างใดอย่างหนึ่ง |
employee_welfare_year | ต้องระบุ ต้องเป็นรูปแบบปี (YYYY) |
salary_type_id | ต้องระบุ ต้อง encode Base64 |
year_month | ต้องระบุ ต้องเป็นรูปแบบ YYYY-MM |
welfare_amt | ต้องระบุ ต้องเป็นตัวเลขและ > 0 |
Code Examples
cURL
# JSON Request (without file upload)
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=welfare-log" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"employee_welfare_year": "2026",
"salary_type_id": "MjAyNjAxMjFTVDAxQTJCM0M0RDU=",
"year_month": "2026-01",
"welfare_amt": 1000,
"welfare_dt": "2026-01-15",
"welfare_desc": "ค่ารักษาพยาบาล"
}'
# Multipart Form Data (with file upload)
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=welfare-log" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-F "employee_code=EMP001" \
-F "employee_welfare_year=2026" \
-F "salary_type_id=MjAyNjAxMjFTVDAxQTJCM0M0RDU=" \
-F "year_month=2026-01" \
-F "welfare_amt=1000" \
-F "welfare_dt=2026-01-15" \
-F "welfare_desc=ค่ารักษาพยาบาล" \
-F "welfare_doc=@/path/to/document.pdf"Notes
log_sourceจะถูกตั้งค่าเป็น “Manual” อัตโนมัติ- ระบบรองรับการแนบเอกสาร
- Response fields ที่ลงท้ายด้วย
_idเป็น Plain text ไม่ได้ encode Base64
Related APIs
- List Welfare - ดึงรายการสวัสดิการทั้งหมด
- Get Welfare - ดึงข้อมูลสวัสดิการตาม ID
- Add Welfare - เพิ่มสวัสดิการ
- Save Welfare - แก้ไขสวัสดิการ
- Delete Welfare - ลบสวัสดิการ
- Delete Welfare Log - ลบบันทึกการใช้สวัสดิการ
Last updated on