Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Welfare Usage Log

เพิ่มบันทึกการใช้สวัสดิการของพนักงาน รองรับการอัพโหลดเอกสารแนบ

Endpoint

POST /api/v1/open-apis/employee/add-employee-financial?path_action=welfare-log

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น welfare-log

Request Body

ParameterTypeRequiredDescription
employee_codestringYes*รหัสพนักงาน (ไม่ต้อง encode Base64)
employee_idstringYes*ID พนักงาน (ต้อง encode Base64)
employee_welfare_yearstringYesปีสวัสดิการ (YYYY)
salary_type_idstringYesID ประเภทสวัสดิการ (ต้อง encode Base64)
year_monthstringYesเดือนที่ใช้สวัสดิการ (YYYY-MM)
welfare_amtnumberYesจำนวนเงินที่ใช้ (> 0)
welfare_dtstringNoวันที่ใช้สวัสดิการ (YYYY-MM-DD)
welfare_descstringNoรายละเอียดการใช้สวัสดิการ
welfare_docfileNoเอกสารแนบ (ต้องใช้ multipart/form-data)
  • ต้องระบุ employee_code หรือ employee_id อย่างใดอย่างหนึ่ง
  • Request parameters employee_id และ salary_type_id ต้อง encode เป็น Base64
  • การอัพโหลดไฟล์ต้องใช้ multipart/form-data content 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

FieldTypeDescription
codenumberรหัสสถานะ (200 = สำเร็จ)
messagestringข้อความตอบกลับ
payloadobjectข้อมูลที่สร้างสำเร็จ
payload.employee_welfare_yearstringปีสวัสดิการ
payload.salary_type_idstringID ประเภทสวัสดิการ (Plain text)
payload.employee_idstringID พนักงาน (Plain text)
payload.master_salary_monthstringเดือนที่ใช้สวัสดิการ
payload.welfare_dtstringวันที่ใช้สวัสดิการ
payload.welfare_descstringรายละเอียด
payload.log_sourcestringแหล่งที่มา (Manual)
payload.log_balancenumberจำนวนเงินที่ใช้
payload.welfare_docstringURL เอกสารแนบ (ถ้ามี)
payload.master_salary_report_idstringID รายงานเงินเดือน (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

FieldRule
employee_code or employee_idต้องระบุอย่างใดอย่างหนึ่ง
employee_welfare_yearต้องระบุ ต้องเป็นรูปแบบปี (YYYY)
salary_type_idต้องระบุ ต้อง encode Base64
year_monthต้องระบุ ต้องเป็นรูปแบบ YYYY-MM
welfare_amtต้องระบุ ต้องเป็นตัวเลขและ > 0

Code Examples

# 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

  • List Welfare - ดึงรายการสวัสดิการทั้งหมด
  • Get Welfare - ดึงข้อมูลสวัสดิการตาม ID
  • Add Welfare - เพิ่มสวัสดิการ
  • Save Welfare - แก้ไขสวัสดิการ
  • Delete Welfare - ลบสวัสดิการ
  • Delete Welfare Log - ลบบันทึกการใช้สวัสดิการ
Last updated on