List Employee Constants

ดึงรายการรายรับ/รายจ่ายคงที่ทั้งหมดของพนักงาน รวมทั้งรายการที่บริษัทมีและสถานะการตั้งค่าของพนักงาน

Endpoint


GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=list-constant

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `list-constant`
`employee_code`	string	Yes	รหัสพนักงาน

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "employee_constant_id": "20260215EC01A2B3C4D5",
      "employee_id": "20260215EM01A2B3C4D5",
      "salary_type_id": "20260215ST01A2B3C4D5",
      "salary_type_name": "ค่าเดินทาง",
      "salary_type_name_en": "Travel Allowance",
      "calculate_type_lv": "1",
      "employee_constant_amt": 5000,
      "employee_constant_start_dt": "2024-01-01",
      "employee_constant_end_dt": "2024-12-31"
    },
    {
      "employee_constant_id": "20260215EC02E3F4A5B6",
      "employee_id": "20260215EM01A2B3C4D5",
      "salary_type_id": "20260215ST02E3F4A5B6",
      "salary_type_name": "ค่าโทรศัพท์",
      "salary_type_name_en": "Phone Allowance",
      "calculate_type_lv": "1",
      "employee_constant_amt": 1000,
      "employee_constant_start_dt": "2024-01-01",
      "employee_constant_end_dt": null
    }
  ]
}

Response Fields

Field	Type	Description
`employee_constant_id`	string	ID รายการคงที่
`employee_id`	string	ID พนักงาน
`salary_type_id`	string	ID ประเภทรายรับ/รายจ่าย
`salary_type_name`	string	ชื่อประเภท (ภาษาไทย)
`salary_type_name_en`	string	ชื่อประเภท (ภาษาอังกฤษ)
`calculate_type_lv`	string	ประเภทการคำนวณ: `1` = รายรับ, `-1` = รายจ่าย
`employee_constant_amt`	number	จำนวนเงิน
`employee_constant_start_dt`	string/null	วันที่เริ่มต้น (YYYY-MM-DD)
`employee_constant_end_dt`	string/null	วันที่สิ้นสุด (YYYY-MM-DD)

Error Response


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found with code: EMP001"
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-constant&employee_code=EMP001" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-constant&employee_code=EMP001',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
console.log('Constants:', data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "list-constant",
    "employee_code": "EMP001"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Found {len(data['payload'])} constants")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-constant&employee_code=EMP001";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo "Found " . count($data['payload']) . " constants\n";
?>

Notes

calculate_type_lv = 1 หมายถึงรายรับคงที่ (เช่น ค่าเดินทาง, ค่าโทรศัพท์, ค่าที่พัก)
calculate_type_lv = -1 หมายถึงรายจ่ายคงที่ (เช่น หักค่าอาหาร, หักค่าเครื่องแบบ)
รายการอาจมีช่วงเวลาที่มีผล (employee_constant_start_dt, employee_constant_end_dt)
แสดงเฉพาะรายการที่มีจำนวนเงินมากกว่า 0

Get Constant - ดึงข้อมูลรายรับ/รายจ่ายคงที่ตาม ID
Add Constant - เพิ่มรายรับ/รายจ่ายคงที่
Update Constant - แก้ไขรายรับ/รายจ่ายคงที่
Delete Constant - ลบรายรับ/รายจ่ายคงที่

List Employee Constants

Endpoint

Query Parameters

Response Format

Success Response

Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs