Get Welfare Employee Config

ดึงรายละเอียดการตั้งค่าสวัสดิการของพนักงาน 1 รายการ

Endpoint


GET /api/v1/open-apis/welfare/get-welfare-employee

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`welfare_employee_id`	string (base64)	Yes	รหัส Welfare Employee Config	`"MjAyNjAzMDNXRU1QMDAwMDE="`

Request Example


GET /api/v1/open-apis/welfare/get-welfare-employee?welfare_employee_id=MjAyNjAzMDNXRU1QMDAwMDE%3D

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",
    "welfare_claim_limit_amt": "2000.00",
    "created": "2026-03-01 08:00:00",
    "last_upd": "2026-03-15 10:30:00"
  }
}

Response Fields

Field	Type	Description
`welfare_employee_id`	string	รหัส Config
`employee_id`	string	รหัสพนักงาน
`salary_type_id`	string	รหัสประเภทสวัสดิการ
`welfare_year`	string	ปีสวัสดิการ
`welfare_quota_amt`	string	วงเงินสวัสดิการ
`welfare_prev_amt`	string	ยอดยกมาจากปีก่อน
`welfare_claim_limit_amt`	string \| null	วงเงินต่อการเบิก 1 ฉบับ (`null` = ไม่จำกัด)
`created`	string	วันเวลาที่สร้าง
`last_upd`	string	วันเวลาแก้ไขล่าสุด

Error Response - Not Found (HTTP 404)


{
  "code": 404,
  "message": "ไม่พบข้อมูล"
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/get-welfare-employee?welfare_employee_id=MjAyNjAzMDNXRU1QMDAwMDE%3D" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  welfare_employee_id: 'MjAyNjAzMDNXRU1QMDAwMDE='
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/welfare/get-welfare-employee?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/get-welfare-employee"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "welfare_employee_id": "MjAyNjAzMDNXRU1QMDAwMDE="
}
 
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP


<?php
$params = http_build_query([
    "welfare_employee_id" => "MjAyNjAzMDNXRU1QMDAwMDE="
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/get-welfare-employee?{$params}";
 
$headers = ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
print_r(json_decode($response, true));
curl_close($ch);
?>

Notes

ข้อควรทราบ:

welfare_employee_id ใน request ต้องเข้ารหัส Base64
ID ทั้งหมดใน response เป็น plain text

Update Config - แก้ไข Config นี้
Delete Config - ลบ Config นี้
List By Type - ดูรายการทั้งหมด

Get Welfare Employee Config

Endpoint

Request Parameters

Required Parameters

Request Example

Response Format

Success Response (HTTP 200)

Response Fields

Error Response - Not Found (HTTP 404)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs