Update Welfare Employee Multiple

สร้างหรืออัปเดต Welfare Employee Config หลายพนักงานพร้อมกัน (Batch Upsert) ถ้าส่ง welfare_employee_id มาจะ Update ถ้าไม่ส่งจะ Create ใหม่

Endpoint


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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_lists`	array	Yes	รายการพนักงานที่ต้องการตั้งค่า	ดูโครงสร้างด้านล่าง
`salary_type_id`	string (base64)	Yes	รหัสประเภทสวัสดิการ	`"MjAyNjAzMDNTVFlQWDAwMDE="`
`welfare_year`	string	Yes	ปีสวัสดิการ (YYYY)	`"2026"`

Employee Lists Structure

Field	Type	Required	Description	Example
`employee_code`	string	Yes*	รหัสพนักงาน (*ต้องระบุอย่างใดอย่างหนึ่งกับ employee_id)	`"EMP001"`
`employee_id`	string (base64)	Yes*	รหัสพนักงาน (Base64)	`"MjAy..."`
`welfare_quota_amt`	number	Yes	วงเงินสวัสดิการ	`20000.00`
`welfare_employee_id`	string (base64)	No	ถ้าระบุ = Update / ไม่ระบุ = Create	`"MjAy..."`
`welfare_prev_amt`	number	No	ยอดยกมา (default: 0)	`5000.00`

Request Body Example


{
  "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
  "welfare_year": "2026",
  "employee_lists": [
    {
      "employee_code": "EMP001",
      "welfare_quota_amt": 20000.00,
      "welfare_prev_amt": 5000.00
    },
    {
      "employee_code": "EMP002",
      "welfare_quota_amt": 15000.00,
      "welfare_prev_amt": 0
    }
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "แก้ไขข้อมูลสวัสดิการพนักงานสำเร็จ",
  "payload": {
    "salary_type_id": "20260303STYP00001",
    "welfare_year": "2026",
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "welfare_quota_amt": 20000.00,
        "welfare_prev_amt": 5000.00
      }
    ]
  }
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": ["'employee_lists' is required and must be an array"]
}

Code Examples

cURL


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

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_welfare_employee_multiple',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      salary_type_id: 'MjAyNjAzMDNTVFlQWDAwMDE=',
      welfare_year: '2026',
      employee_lists: [
        { employee_code: 'EMP001', welfare_quota_amt: 20000.00, welfare_prev_amt: 5000.00 }
      ]
    })
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_welfare_employee_multiple"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
payload = {
    "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
    "welfare_year": "2026",
    "employee_lists": [
        {"employee_code": "EMP001", "welfare_quota_amt": 20000.00, "welfare_prev_amt": 5000.00}
    ]
}
 
response = requests.post(url, headers=headers, json=payload)
print(response.json())

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_welfare_employee_multiple";
$headers = ["Ocp-Apim-Subscription-Key: YOUR_API_KEY", "Content-Type: application/json"];
$payload = [
    "salary_type_id" => "MjAyNjAzMDNTVFlQWDAwMDE=",
    "welfare_year" => "2026",
    "employee_lists" => [
        ["employee_code" => "EMP001", "welfare_quota_amt" => 20000.00, "welfare_prev_amt" => 5000.00]
    ]
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
print_r(json_decode($response, true));
curl_close($ch);
?>

Notes

ข้อควรทราบ:

salary_type_id ใน request ต้องเข้ารหัส Base64
welfare_employee_id และ employee_id ใน employee_lists ต้องเป็น Base64 encoded
รายการที่ไม่มี welfare_quota_amt จะถูกข้ามโดยไม่ error
รายการที่ employee_code ไม่พบในระบบจะถูกข้ามโดยไม่ error

List By Type - ดูรายการก่อน batch update
Create Config - สร้าง Config รายคน
Excel Import - Import จาก Excel

Update Welfare Employee Multiple

Endpoint

Request Parameters

Required Parameters

Employee Lists Structure

Request Body Example

Response Format

Success Response (HTTP 200)

Error Response - Validation Failed (HTTP 422)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs