Create Welfare Employee Config
สร้างการตั้งค่าสวัสดิการสำหรับพนักงาน กำหนดวงเงินสวัสดิการรายปี จำเป็นต้องมี Config นี้ก่อนพนักงานจึงจะสามารถเบิกสวัสดิการได้
Endpoint
POST /api/v1/open-apis/welfare/submit_welfare_employeeRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
salary_type_id | string (base64) | Yes | รหัสประเภทสวัสดิการ | "MjAyNjAzMDNTVFlQWDAwMDE=" |
welfare_year | string | Yes | ปีสวัสดิการ (YYYY) | "2026" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
welfare_quota_amt | number | No | วงเงินสวัสดิการ (บาท) (default: 0) | 20000.00 |
welfare_prev_amt | number | No | ยอดยกมาจากปีก่อน (บาท) (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
| Field | Type | Description |
|---|---|---|
welfare_employee_id | string | รหัส Welfare Employee Config |
employee_id | string | รหัสพนักงาน |
salary_type_id | string | รหัสประเภทสวัสดิการ |
welfare_year | string | ปีสวัสดิการ |
welfare_quota_amt | string | วงเงินสวัสดิการ |
welfare_prev_amt | string | ยอดยกมา |
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
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 ก่อนส่ง)
Related APIs
- Update Config - แก้ไข Config ที่สร้างแล้ว
- Delete Config - ลบ Config
- Get Config - ดูรายละเอียด Config
- Update Multiple - สร้าง/อัปเดตหลายพนักงานพร้อมกัน
Last updated on