Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Create Welfare Employee Config

สร้างการตั้งค่าสวัสดิการสำหรับพนักงาน กำหนดวงเงินสวัสดิการรายปี จำเป็นต้องมี Config นี้ก่อนพนักงานจึงจะสามารถเบิกสวัสดิการได้

Endpoint

POST /api/v1/open-apis/welfare/submit_welfare_employee

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
salary_type_idstring (base64)Yesรหัสประเภทสวัสดิการ"MjAyNjAzMDNTVFlQWDAwMDE="
welfare_yearstringYesปีสวัสดิการ (YYYY)"2026"

Optional Parameters

ParameterTypeRequiredDescriptionExample
welfare_quota_amtnumberNoวงเงินสวัสดิการ (บาท) (default: 0)20000.00
welfare_prev_amtnumberNoยอดยกมาจากปีก่อน (บาท) (default: 0)5000.00

Request Body Example

{ "employee_code": "EMP001", "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "welfare_year": "2026", "welfare_quota_amt": 20000.00, "welfare_prev_amt": 5000.00 }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สร้างข้อมูลสวัสดิการพนักงานสำเร็จ", "payload": { "welfare_employee_id": "20260303WEMP00001", "employee_id": "20260309462FEF65EFCA", "salary_type_id": "20260303STYP00001", "welfare_year": "2026", "welfare_quota_amt": "20000.00", "welfare_prev_amt": "5000.00" } }

Response Fields

FieldTypeDescription
welfare_employee_idstringรหัส Welfare Employee Config
employee_idstringรหัสพนักงาน
salary_type_idstringรหัสประเภทสวัสดิการ
welfare_yearstringปีสวัสดิการ
welfare_quota_amtstringวงเงินสวัสดิการ
welfare_prev_amtstringยอดยกมา

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": ["Missing required parameter: salary_type_id"] }

Error Response - Create Failed (HTTP 400)

{ "code": 400, "message": "Failed to create welfare employee" }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/submit_welfare_employee" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "welfare_year": "2026", "welfare_quota_amt": 20000.00, "welfare_prev_amt": 5000.00 }'

Notes

ข้อควรทราบ:

  • salary_type_id ใน request ต้องเข้ารหัส Base64
  • ID ทั้งหมดใน response เป็น plain text
  • ต้องมี Config นี้ก่อน พนักงานถึงจะเบิกสวัสดิการได้
  • welfare_employee_id ที่ได้จาก response ใช้ใน API อื่น (ต้อง encode Base64 ก่อนส่ง)
  • Update Config - แก้ไข Config ที่สร้างแล้ว
  • Delete Config - ลบ Config
  • Get Config - ดูรายละเอียด Config
  • Update Multiple - สร้าง/อัปเดตหลายพนักงานพร้อมกัน
Last updated on