Get Individual Settings Summary
ดึงสรุปการตั้งค่าคำนวณเงินเดือนรายบุคคลของพนักงานที่ระบุ ครอบคลุม 8 หมวด ได้แก่ ตั้งค่าทั่วไป เวลาการทำงาน กะการทำงาน-วันหยุด รายรับรายจ่ายคงที่ รายรับรายจ่ายอัตโนมัติ กองทุน ลดหย่อนภาษี และหนี้สินพนักงาน เลือกดึงทั้งหมดหรือเฉพาะหมวดที่ต้องการได้
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_individual_settings_summaryสิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลเงินเดือนทั้งองค์กร (payroll:read:all)
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
path_action | string | Yes | ระบุเป็น get_individual_settings_summary | "get_individual_settings_summary" |
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
year_month | string | No | รอบเดือนอ้างอิง รูปแบบ YYYY-MM (ค่าเริ่มต้น: เดือนปัจจุบัน) — ดูหมายเหตุด้านล่าง | "2026-10" |
section | string | No | หมวดที่ต้องการ (ค่าเริ่มต้น: all) ดูตารางด้านล่าง | "general" |
language_code | string | No | ภาษาของข้อความอธิบายและชื่อต่าง ๆ: TH หรือ EN (ค่าเริ่มต้น: TH) | "EN" |
ค่าของ section
| ค่า | หมวดที่ได้รับใน payload |
|---|---|
all | ครบทั้ง 8 หมวด |
general | general_settings — ตั้งค่าทั่วไป |
work_time | work_time_settings — ตั้งค่าเวลาการทำงาน |
work_cycle_holiday | work_cycle_holiday_settings — กะการทำงานและวันหยุดประจำสัปดาห์ |
constant | constant_settings — รายรับรายจ่ายคงที่ |
auto | auto_settings — รายรับรายจ่ายอัตโนมัติ |
fund | fund_settings — กองทุน |
tax | tax_settings — ลดหย่อนภาษี |
debt | debt_settings — หนี้สินพนักงาน |
section และ language_code ไม่แยกตัวพิมพ์เล็ก-ใหญ่
- ข้อมูลทุกหมวดเป็นการตั้งค่าปัจจุบันของพนักงาน ไม่ได้แยกตามรอบเดือน —
year_monthใช้ตรวจรูปแบบและส่งกลับใน response เท่านั้น tax_settingsคืนข้อมูลลดหย่อนของทุกปีภาษีที่พนักงานมี
Response Format
Success Response
ตัวอย่างเมื่อเรียก section=all (แสดงบางรายการในแต่ละหมวด)
{
"code": 200,
"message": "Success",
"payload": {
"employee_id": "20251127D4573C421639",
"employee_code": "EMP001",
"employee_name": "สมชาย ใจดี (ชาย)",
"employee_type_code": "01",
"employee_type_name": "พนักงานรายเดือน",
"year_month": "2026-10",
"section": "all",
"general_settings": {
"days_per_month": "30",
"days_per_month_text": "30 วัน",
"hours_per_day": "08:00:00",
"hours_per_day_text": "8.00 ชั่วโมง",
"round_month_config": "Full",
"round_month_config_text": "เต็มเดือน",
"holiday_apply_config": "Y",
"holiday_apply_config_text": "อนุญาต",
"approvers": {
"auth_first": {
"employee_id": "20250101AAAA11112222",
"employee_code": "EMP002",
"employee_name": "สมหญิง รักงาน"
},
"auth_second": null,
"auth_third": null,
"auth_fourth": null,
"auth_fifth": null
}
},
"work_time_settings": {
"receive": [
{
"type_code": "morning",
"type_name": "มาเช้า",
"is_individual_override": false,
"employee_type": "EMP_MONTHLY",
"employee_type_text": "พนักงานรายเดือน",
"action_active": true,
"calculation_method": "A",
"calculation_method_text": "ตามเรทค่าแรง",
"calculation_value": 1,
"tax_include": true,
"sso_include": true,
"provident_include": false,
"emp_welfare_fund_include": false
}
],
"deduct": [
{
"type_code": "late",
"type_name": "สาย",
"is_individual_override": true,
"employee_type": "EMP_MONTHLY",
"employee_type_text": "พนักงานรายเดือน",
"action_active": true,
"calculation_method": "B",
"calculation_method_text": "เป็นนาที (2 บาท/นาที)",
"calculation_value": 2,
"tax_include": true,
"sso_include": true,
"provident_include": false,
"emp_welfare_fund_include": false
}
],
"overtime": [
{
"ot_code": "OT_1_5",
"ot_multiplier": 1.5,
"ot_name": "โอที 1.5 เท่า",
"is_individual_override": false,
"use_with": {
"day_type": "A",
"day_type_text": "วันทำงาน",
"time_period": "B",
"time_period_text": "นอกเวลากะ"
},
"lunch_include": true,
"employee_type": "EMP_MONTHLY",
"employee_type_text": "พนักงานรายเดือน",
"calculation_method": "A",
"calculation_method_text": "1.5 เท่าของค่าแรง",
"calculation_value": 1.5,
"max_ot_hours": null,
"tax_include": true,
"sso_include": true,
"provident_include": false,
"emp_welfare_fund_include": false
}
]
},
"work_cycle_holiday_settings": {
"personal_config": false,
"work_cycle_lists": [
{ "day": "Mon", "day_name": "จันทร์", "work_cycle_id": "20250101DDDD77778888", "work_cycle_code": "WC001", "work_start_time": "08:00", "work_end_time": "17:00", "is_active": true },
{ "day": "Tue", "day_name": "อังคาร", "work_cycle_id": "20250101DDDD77778888", "work_cycle_code": "WC001", "work_start_time": "08:00", "work_end_time": "17:00", "is_active": true },
{ "day": "Wed", "day_name": "พุธ", "work_cycle_id": "20250101DDDD77778888", "work_cycle_code": "WC001", "work_start_time": "08:00", "work_end_time": "17:00", "is_active": true },
{ "day": "Thu", "day_name": "พฤหัสบดี", "work_cycle_id": "20250101DDDD77778888", "work_cycle_code": "WC001", "work_start_time": "08:00", "work_end_time": "17:00", "is_active": true },
{ "day": "Fri", "day_name": "ศุกร์", "work_cycle_id": "20250101DDDD77778888", "work_cycle_code": "WC001", "work_start_time": "08:00", "work_end_time": "17:00", "is_active": true },
{ "day": "Sat", "day_name": "เสาร์", "work_cycle_id": "", "work_cycle_code": "", "work_start_time": "", "work_end_time": "", "is_active": false },
{ "day": "Sun", "day_name": "อาทิตย์", "work_cycle_id": "", "work_cycle_code": "", "work_start_time": "", "work_end_time": "", "is_active": false }
],
"holiday_lists": [
{ "day": "Mon", "day_name": "จันทร์", "holiday_code": "00", "holiday_name": "วันทำงาน" },
{ "day": "Tue", "day_name": "อังคาร", "holiday_code": "00", "holiday_name": "วันทำงาน" },
{ "day": "Wed", "day_name": "พุธ", "holiday_code": "00", "holiday_name": "วันทำงาน" },
{ "day": "Thu", "day_name": "พฤหัสบดี", "holiday_code": "00", "holiday_name": "วันทำงาน" },
{ "day": "Fri", "day_name": "ศุกร์", "holiday_code": "00", "holiday_name": "วันทำงาน" },
{ "day": "Sat", "day_name": "เสาร์", "holiday_code": "03", "holiday_name": "วันหยุดพนักงาน" },
{ "day": "Sun", "day_name": "อาทิตย์", "holiday_code": "03", "holiday_name": "วันหยุดพนักงาน" }
]
},
"constant_settings": {
"income": [
{
"employee_constant_id": "20250101BBBB33334444",
"salary_type_id": "20250101CCCC55556666",
"salary_type_code": "ST0002",
"salary_type_name": "ค่าตำแหน่ง",
"calculate_type_lv": 1,
"employee_constant_amt": 3000,
"employee_constant_start_dt": null,
"employee_constant_end_dt": null
},
{
"employee_constant_id": null,
"salary_type_id": "20250101EEEE99990000",
"salary_type_code": "ST0003",
"salary_type_name": "ค่าครองชีพ",
"calculate_type_lv": 1,
"employee_constant_amt": 0,
"employee_constant_start_dt": null,
"employee_constant_end_dt": null
}
],
"expense": []
},
"auto_settings": {
"income": [
{
"salary_type_id": "20250101FFFF11223344",
"salary_type_code": "ST0004",
"salary_type_name": "เบี้ยขยัน",
"calculate_type_lv": 1,
"is_enabled": true
}
],
"expense": [
{
"salary_type_id": "20250101ABCD55667788",
"salary_type_code": "ST0005",
"salary_type_name": "หักค่าอาหาร",
"calculate_type_lv": -1,
"is_enabled": false
}
]
},
"fund_settings": [
{
"fund_id": "20250101BCDE99887766",
"fund_name": "กองทุนสำรองเลี้ยงชีพ",
"salary_type_code": "ST0010",
"is_enrolled": true,
"fund_employee_id": "20250101CDEF44332211",
"fund_employee_no": "PVD-0001",
"fund_employee_date": "2025-01-01",
"fund_employee_type": "01",
"fund_employee_type_text": "คิดเป็น %",
"fund_employee_rate": 5,
"fund_company_type": "01",
"fund_company_type_text": "คิดเป็น %",
"fund_company_rate": 5,
"fund_employee_beneficiary": "นางสมศรี ใจดี",
"fund_employee_remark": "",
"fund_employee_balance": 125000.5,
"fund_employee_status": "A",
"fund_employee_status_text": "ปกติ",
"fund_out_date": null
}
],
"tax_settings": [
{
"tax_year": "2026",
"tax_month_qty": 9,
"tax_month_qty_text": "9 เดือน",
"total_tax_amt": 85000,
"tax_categories": [
{
"tax_category_id": "60",
"tax_category_name": "ผู้มีเงินได้",
"max_amt": 60000,
"tax_amt": 60000,
"child_categories": []
}
]
}
],
"debt_settings": [
{
"employee_loan_id": "20260704A1B2C3D4E5F6",
"employee_loan_desc": "เงินกู้ฉุกเฉิน",
"salary_type_id": "20250101DEFA12121212",
"salary_type_name": "เงินกู้พนักงาน",
"salary_type_code": "ST0020",
"employee_loan_dt": "2026-07-04",
"employee_loan_amt_principle": 10000,
"employee_loan_amt_interest": 0,
"employee_loan_total_amt": 10000,
"employee_loan_period_count": 2,
"employee_loan_status": "N",
"employee_loan_status_text": "กำลังผ่อนชำระ",
"periods": [
{
"employee_loan_period_id": "20260704AAAA11112222",
"employee_loan_period_seq": 1,
"employee_loan_period_month": "2026-07",
"employee_loan_period_principle": 5000,
"employee_loan_period_interest": 0,
"employee_loan_period_amt": 5000,
"is_paid": true
},
{
"employee_loan_period_id": "20260804BBBB33334444",
"employee_loan_period_seq": 2,
"employee_loan_period_month": "2026-08",
"employee_loan_period_principle": 5000,
"employee_loan_period_interest": 0,
"employee_loan_period_amt": 5000,
"is_paid": false
}
]
}
]
}
}เมื่อเรียกเฉพาะหมวด (เช่น section=general) payload จะมีข้อมูลพนักงานด้านบนและเฉพาะหมวดนั้น
Response Fields
ข้อมูลพนักงาน
| Field | Type | Description |
|---|---|---|
employee_id | string | ID ของพนักงาน |
employee_code | string | รหัสพนักงาน |
employee_name | string | ชื่อ-นามสกุลตาม language_code (ใช้ชื่อภาษาอังกฤษถ้ามี) ต่อท้ายด้วยชื่อเล่นในวงเล็บถ้ามี |
employee_type_code | string | รหัสประเภทพนักงาน: "01" = รายเดือน, "02" = รายวัน, "03" = พาร์ตไทม์, "04" = เหมาจ่าย |
employee_type_name | string | ชื่อกลุ่มประเภทพนักงานตาม language_code (เป็นค่าว่างเมื่อพนักงานไม่มีกลุ่มประเภท หรือเมื่อเป็น EN และไม่ได้ตั้งชื่อภาษาอังกฤษ) |
year_month | string | รอบเดือนที่ส่งมา (หรือเดือนปัจจุบัน) |
section | string | หมวดที่ขอ |
general_settings
| Field | Type | Description |
|---|---|---|
days_per_month | string | จำนวนวันต่อเดือนของพนักงาน: "26" / "30" = ตามจำนวนนั้น, "31" = ตามจริง, "0" = ตามการตั้งค่าองค์กร |
days_per_month_text | string | คำอธิบาย days_per_month ตาม language_code |
hours_per_day | string | จำนวนชั่วโมงทำงานต่อวัน เช่น "08:00:00", "08:30:00", "09:00:00" — "24:00:00" = ตามกะการทำงาน, "00:00:00" = ตามการตั้งค่าองค์กร |
hours_per_day_text | string | คำอธิบาย hours_per_day ตาม language_code |
round_month_config | string | รอบการจ่ายเงินเดือน: "Full" = เต็มเดือน, "Split" = แบ่งงวดจ่าย |
round_month_config_text | string | คำอธิบาย round_month_config ตาม language_code |
holiday_apply_config | string | สิทธิ์รับค่าจ้างวันหยุดนักขัตฤกษ์: "Y" = อนุญาต, "N" = ไม่อนุญาต — มีผลกับพนักงานรายวัน เมื่อองค์กรเปิดการจ่ายค่าจ้างวันหยุดนักขัตฤกษ์ |
holiday_apply_config_text | string | คำอธิบาย holiday_apply_config ตาม language_code |
approvers | object | ผู้อนุมัติลำดับที่ 1–5: auth_first, auth_second, auth_third, auth_fourth, auth_fifth — เป็น null เมื่อไม่ได้กำหนดหรือไม่พบข้อมูลผู้อนุมัติ |
approvers.*.employee_id | string | ID ของผู้อนุมัติ |
approvers.*.employee_code | string | รหัสพนักงานของผู้อนุมัติ |
approvers.*.employee_name | string | ชื่อ-นามสกุลของผู้อนุมัติตาม language_code |
work_time_settings
กฎเวลาทำงานขององค์กรที่เปิดใช้กับประเภทของพนักงานคนนี้ โดยถ้าพนักงานมีการตั้งค่ารายบุคคล ค่าของพนักงานจะใช้แทนค่าขององค์กร (is_individual_override เป็น true) หากไม่มีการตั้งค่าจะได้ array ว่าง
กฎที่ตั้งรายบุคคล (is_individual_override เป็น true) ชื่อกฎภาษาไทยจะมาจากการตั้งค่ารายบุคคล (ถ้าไม่ได้ตั้งชื่อไว้จะใช้ชื่อมาตรฐานของระบบ) ส่วนชื่อภาษาอังกฤษยังใช้ชื่อที่องค์กรตั้งไว้
| Field | Type | Description |
|---|---|---|
receive | array | กฎการได้เงิน เช่น morning (มาเช้า), underlunch (พักไว), after (กลับช้า) |
deduct | array | กฎการหักเงิน เช่น late (สาย), overlunch (พักเกิน), early (กลับก่อน) |
overtime | array | กฎค่าล่วงเวลา OT_1_0, OT_1_5, OT_2_0 ถึง OT_7_0 |
รายการใน receive และ deduct
| Field | Type | Description |
|---|---|---|
type_code | string | รหัสประเภท |
type_name | string | ชื่อที่องค์กรตั้งไว้ — เมื่อ language_code เป็น EN ใช้ชื่อภาษาอังกฤษถ้าตั้งไว้ ไม่เช่นนั้นใช้ชื่อภาษาไทยที่องค์กรตั้ง และถ้าไม่ได้ตั้งชื่อเลยจะใช้ชื่อมาตรฐานของระบบ |
is_individual_override | boolean | true = พนักงานคนนี้มีการตั้งค่ากฎนี้รายบุคคล และใช้ค่านั้นแทนค่าขององค์กร (เป็น true แม้ค่าที่ตั้งจะเท่ากับขององค์กร) |
employee_type | string | กลุ่มพนักงานของกฎ: EMP_MONTHLY, EMP_DAILY, EMP_PARTTIME, EMP_CONTRACTOR (ตามประเภทของพนักงาน) |
employee_type_text | string | ชื่อกลุ่มพนักงานตาม language_code |
action_active | boolean | true = มีการตั้งค่าเกณฑ์การได้เงิน/หักเงินไว้ — พนักงานเหมาจ่าย (EMP_CONTRACTOR) เป็น true เสมอ |
calculation_method | string | "A" = ตามอัตราค่าแรง, "B" = อัตราบาทต่อนาที, "C" = ตามสูตรคำนวณ |
calculation_method_text | string | คำอธิบายวิธีคำนวณตาม language_code (กรณี "B" จะระบุบาทต่อนาทีด้วย) |
calculation_value | number | กรณี "A" = ตัวคูณของอัตราค่าแรง, กรณี "B" = บาทต่อนาที, วิธีตามสูตรคำนวณจะเป็น 0 |
tax_include | boolean | นำยอดเงินไปคำนวณภาษี |
sso_include | boolean | นำยอดเงินไปคำนวณประกันสังคม |
provident_include | boolean | นำยอดเงินไปคำนวณกองทุนสำรองเลี้ยงชีพ |
emp_welfare_fund_include | boolean | นำยอดเงินไปคำนวณกองทุนสงเคราะห์ลูกจ้าง |
รายการใน overtime
| Field | Type | Description |
|---|---|---|
ot_code | string | รหัสโอที เช่น "OT_1_5" |
ot_multiplier | number | ตัวคูณโอทีตามรหัส เช่น 1.5 |
ot_name | string | ชื่อที่องค์กรตั้งไว้ (กติกาเดียวกับ type_name) — ชื่อมาตรฐานของระบบเป็นรูปแบบ เช่น "โอที 1.5 เท่า", "โอที 2 เท่า" (EN: "OT 1.5x") |
is_individual_override | boolean | true = พนักงานคนนี้มีการตั้งค่าโอทีนี้รายบุคคล และใช้ค่านั้นแทนค่าขององค์กร (เป็น true แม้ค่าที่ตั้งจะเท่ากับขององค์กร) |
use_with.day_type | string | วันที่ใช้: "A" = วันทำงาน, "B" = วันหยุด, "C" = วันทำงานและวันหยุด |
use_with.day_type_text | string | คำอธิบาย day_type ตาม language_code |
use_with.time_period | string | ช่วงเวลา: "A" = ในเวลากะ, "B" = นอกเวลากะ, "C" = ในและนอกเวลากะ (รวมกรณีที่ไม่ได้กำหนดช่วงเวลา) — เมื่อ day_type เป็น "A" จะเป็น "B" เสมอ |
use_with.time_period_text | string | คำอธิบาย time_period ตาม language_code |
lunch_include | boolean | true = นับรวมเวลาพักกลางวัน — เมื่อ day_type เป็น "A" จะเป็น true เสมอ |
employee_type | string | กลุ่มพนักงานของกฎ (ตามประเภทของพนักงาน) |
employee_type_text | string | ชื่อกลุ่มพนักงานตาม language_code |
calculation_method | string | วิธีคำนวณค่าโอที: "A" = อัตราค่าแรง × calculation_value, "B" = บาทต่อนาที, "C" = ตามสูตรคำนวณ, "D" = แปลงเวลาโอทีเป็นวันหยุด |
calculation_method_text | string | คำอธิบายวิธีคำนวณตาม language_code เช่น "1.5 เท่าของค่าแรง", "นาทีละ 2 บาท", "แปลงเป็นวันหยุดพิเศษ" |
calculation_value | number | ค่าที่ใช้คำนวณ เช่น 1.5 — กรณี "D" คืออัตราแปลงชั่วโมงโอทีเป็นชั่วโมงวันหยุด |
max_ot_hours | integer | null | ชั่วโมงโอทีสูงสุดที่ตั้งไว้ (null = ไม่ได้กำหนด ระบบจะจำกัดตามชั่วโมงทำงานของกะ) |
tax_include | boolean | นำค่าโอทีไปคำนวณภาษี |
sso_include | boolean | นำค่าโอทีไปคำนวณประกันสังคม |
provident_include | boolean | นำค่าโอทีไปคำนวณกองทุนสำรองเลี้ยงชีพ |
emp_welfare_fund_include | boolean | นำค่าโอทีไปคำนวณกองทุนสงเคราะห์ลูกจ้าง |
work_cycle_holiday_settings
| Field | Type | Description |
|---|---|---|
personal_config | boolean | true = พนักงานใช้ตารางกะและวันหยุดเฉพาะบุคคล, false = ใช้ตามองค์กร/แผนก |
work_cycle_lists | array | กะการทำงานประจำสัปดาห์ 7 รายการ (จันทร์–อาทิตย์) |
work_cycle_lists[].day | string | รหัสวัน: Mon, Tue, Wed, Thu, Fri, Sat, Sun |
work_cycle_lists[].day_name | string | ชื่อวันตาม language_code |
work_cycle_lists[].work_cycle_id | string | ID ของกะการทำงาน (ค่าว่างเมื่อไม่ได้กำหนดกะในวันนั้น) |
work_cycle_lists[].work_cycle_code | string | รหัสกะการทำงาน |
work_cycle_lists[].work_start_time | string | เวลาเข้างานของกะ (กะแบบควบกะใช้เวลาเข้าของช่วงแรก) |
work_cycle_lists[].work_end_time | string | เวลาออกงานของกะ (กะแบบควบกะใช้เวลาออกของช่วงหลัง) |
work_cycle_lists[].is_active | boolean | true = มีการกำหนดกะในวันนั้น |
holiday_lists | array | วันทำงาน/วันหยุดประจำสัปดาห์ 7 รายการ (จันทร์–อาทิตย์) |
holiday_lists[].day | string | รหัสวัน |
holiday_lists[].day_name | string | ชื่อวันตาม language_code |
holiday_lists[].holiday_code | string | "00" = วันทำงาน (รวมวันที่ไม่ได้ตั้งค่า), "03" = วันหยุดพนักงาน |
holiday_lists[].holiday_name | string | คำอธิบาย holiday_code ตาม language_code |
constant_settings
แสดงประเภทรายรับรายจ่ายคงที่ทุกประเภทขององค์กร พร้อมค่าที่ตั้งให้พนักงาน — ประเภทที่ไม่ได้ตั้งให้พนักงานจะมี employee_constant_id เป็น null และยอดเป็น 0
| Field | Type | Description |
|---|---|---|
income | array | รายรับคงที่ |
expense | array | รายจ่ายคงที่ |
*[].employee_constant_id | string | null | ID ของรายการที่ตั้งให้พนักงาน (null = ไม่ได้ตั้ง) |
*[].salary_type_id | string | ID ของประเภทรายรับรายจ่าย |
*[].salary_type_code | string | รหัสประเภท |
*[].salary_type_name | string | ชื่อประเภทตาม language_code (ใช้ชื่อภาษาอังกฤษถ้ามี) |
*[].calculate_type_lv | integer | 1 = รายรับ, -1 = รายจ่าย |
*[].employee_constant_amt | number | จำนวนเงินต่อเดือน |
*[].employee_constant_start_dt | string | null | วันที่เริ่มมีผลที่บันทึกไว้ รูปแบบ YYYY-MM-DD HH:mm:ss (null = ไม่ได้ระบุ) |
*[].employee_constant_end_dt | string | null | วันที่สิ้นสุดที่บันทึกไว้ รูปแบบ YYYY-MM-DD HH:mm:ss (null = ไม่ได้ระบุ) |
auto_settings
แสดงประเภทรายรับรายจ่ายอัตโนมัติทุกประเภทขององค์กร พร้อมสถานะว่าพนักงานคนนี้ถูกเลือกไว้หรือไม่
| Field | Type | Description |
|---|---|---|
income / expense | array | รายรับ / รายจ่ายอัตโนมัติ |
*[].salary_type_id | string | ID ของประเภท |
*[].salary_type_code | string | รหัสประเภท |
*[].salary_type_name | string | ชื่อประเภทตาม language_code |
*[].calculate_type_lv | integer | 1 = รายรับ, -1 = รายจ่าย |
*[].is_enabled | boolean | true = พนักงานถูกเลือกไว้ในรายการนี้ — มีผลกับประเภทที่กำหนดให้ใช้เฉพาะพนักงานที่เลือก ส่วนประเภทอื่นค่า false ไม่ได้หมายความว่ารายการนั้นไม่ถูกนำไปคำนวณ |
fund_settings
แสดงกองทุนทุกกองขององค์กร พร้อมข้อมูลสมาชิกของพนักงาน — กองทุนที่พนักงานไม่ได้เป็นสมาชิกจะมีอัตราและยอดเงินเป็น 0 และวิธีคิดเป็น "01"
| Field | Type | Description |
|---|---|---|
fund_id | string | ID ของกองทุน |
fund_name | string | ชื่อกองทุนตาม language_code |
salary_type_code | string | รหัสประเภทรายจ่ายของกองทุน |
is_enrolled | boolean | true = พนักงานเป็นสมาชิกกองทุนนี้อยู่ในปัจจุบัน |
fund_employee_id | string | null | ID ของข้อมูลสมาชิก (null เมื่อไม่ได้เป็นสมาชิก) |
fund_employee_no | string | เลขที่สมาชิก |
fund_employee_date | string | null | วันที่เข้าเป็นสมาชิก |
fund_employee_type | string | วิธีคิดเงินสะสมของพนักงาน: "01" = เป็น %, "02" = เป็นบาท, ค่าอื่น = ตามสูตร |
fund_employee_type_text | string | คำอธิบาย fund_employee_type ตาม language_code |
fund_employee_rate | number | อัตราเงินสะสมของพนักงาน |
fund_company_type | string | วิธีคิดเงินสมทบของนายจ้าง (ค่าเหมือน fund_employee_type) |
fund_company_type_text | string | คำอธิบาย fund_company_type ตาม language_code |
fund_company_rate | number | อัตราเงินสมทบของนายจ้าง |
fund_employee_beneficiary | string | ผู้รับผลประโยชน์ |
fund_employee_remark | string | หมายเหตุ |
fund_employee_balance | number | ยอดเงินสะสมของพนักงาน |
fund_employee_status | string | สถานะสมาชิก: "A" = ปกติ, "P" = ระงับ, "N" = ไม่ได้เป็นสมาชิกในปัจจุบัน (รวมผู้ที่ออกจากกองทุนแล้ว ซึ่ง fund_out_date จะมีค่า), "O" = เป็นสมาชิกและมีวันที่ออกจากกองทุนบันทึกไว้ |
fund_employee_status_text | string | คำอธิบายสถานะตาม language_code |
fund_out_date | string | null | วันที่ออกจากกองทุนที่บันทึกไว้ (อาจมีค่าแม้ is_enrolled เป็น false) |
tax_settings
| Field | Type | Description |
|---|---|---|
tax_year | string | ปีภาษี (ค.ศ.) |
tax_month_qty | integer | จำนวนเดือนในปีที่มีข้อมูลภาษีจากการคำนวณเงินเดือน |
tax_month_qty_text | string | คำอธิบาย tax_month_qty ตาม language_code |
total_tax_amt | number | ยอดลดหย่อนรวมโดยประมาณของปีภาษี รวมประมาณการกองทุนสำรองเลี้ยงชีพและประกันสังคมถึงสิ้นปี — อาจไม่เท่ากับผลรวม tax_amt ใน tax_categories |
tax_categories | array | หมวดลดหย่อนทุกหมวดของปี รวมหมวดที่ยอดเป็น 0 |
tax_categories[].tax_category_id | string | ID ของหมวดลดหย่อน |
tax_categories[].tax_category_name | string | ชื่อหมวดตาม language_code |
tax_categories[].max_amt | number | วงเงินลดหย่อนสูงสุดของหมวด |
tax_categories[].tax_amt | number | ผลรวมยอดลดหย่อนที่บันทึกไว้ของพนักงานในหมวดนี้ |
tax_categories[].child_categories | array | หมวดย่อย (โครงสร้างเดียวกัน ไม่มี child_categories) |
debt_settings
แสดงสัญญาเงินกู้ของพนักงานทุกสถานะ
| Field | Type | Description |
|---|---|---|
employee_loan_id | string | ID ของสัญญาเงินกู้ |
employee_loan_desc | string | รายละเอียดสัญญา |
salary_type_id | string | ID ของประเภทรายจ่ายที่ใช้หักชำระ |
salary_type_name | string | ชื่อประเภทตาม language_code (เมื่อเป็น EN และไม่ได้ตั้งชื่อภาษาอังกฤษ จะเป็นค่าว่าง) |
salary_type_code | string | รหัสประเภท |
employee_loan_dt | string | null | วันที่ทำสัญญา |
employee_loan_amt_principle | number | เงินต้น |
employee_loan_amt_interest | number | ดอกเบี้ยรวม |
employee_loan_total_amt | number | ยอดชำระรวมทุกงวด (เงินต้น + ดอกเบี้ย) |
employee_loan_period_count | integer | จำนวนงวด |
employee_loan_status | string | สถานะ: "N" = กำลังผ่อนชำระ, "Y" = ชำระครบแล้ว, "C" = ปิดบัญชี (ยกเลิก) |
employee_loan_status_text | string | คำอธิบายสถานะตาม language_code |
periods | array | งวดผ่อนชำระเรียงตามลำดับงวด |
periods[].employee_loan_period_id | string | ID ของงวด |
periods[].employee_loan_period_seq | integer | ลำดับงวด |
periods[].employee_loan_period_month | string | เดือนที่หักชำระ (YYYY-MM) |
periods[].employee_loan_period_principle | number | เงินต้นของงวด |
periods[].employee_loan_period_interest | number | ดอกเบี้ยของงวด |
periods[].employee_loan_period_amt | number | ยอดชำระของงวด |
periods[].is_paid | boolean | true = ชำระแล้ว |
Error Response
Parameter ไม่ถูกต้อง (400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": [
"กรุณาระบุ 'employee_code' สำหรับ path_action 'get_individual_settings_summary'"
]
}ข้อความใน errors | สาเหตุ |
|---|---|
กรุณาระบุ 'employee_code' สำหรับ path_action 'get_individual_settings_summary' | ไม่ได้ส่ง employee_code |
'year_month' ไม่ถูกต้อง ต้องเป็นรูปแบบ YYYY-MM เช่น 2026-08 | รูปแบบไม่ใช่ YYYY-MM หรือเดือนไม่อยู่ในช่วง 01–12 |
'section' ไม่ถูกต้อง ต้องเป็นหนึ่งใน: all, general, work_time, work_cycle_holiday, constant, auto, fund, tax, debt | ค่า section ไม่รองรับ |
'language_code' ไม่ถูกต้อง ต้องเป็นหนึ่งใน: TH, EN | ค่า language_code ไม่รองรับ |
เมื่อส่ง employee_code มาแล้ว หากผิดหลายข้อ errors จะมีครบทุกข้อในครั้งเดียว (กรณีไม่ส่ง employee_code จะได้เฉพาะข้อความนั้น)
ไม่พบพนักงาน (400)
{
"code": 400,
"message": "ไม่พบข้อมูลพนักงานสำหรับรหัส: EMP001"
}ไม่มีสิทธิ์ (403)
{
"code": 403,
"message": "Forbidden: Insufficient permissions",
"error": {
"type": "PERMISSION_DENIED",
"required_permission": "payroll:read:all",
"resource": "payroll:read:all"
}
}| HTTP Status | Description |
|---|---|
400 | Parameter ไม่ถูกต้อง หรือไม่พบพนักงานตาม employee_code |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
403 | API Key ไม่มีสิทธิ์ payroll:read:all |
500 | ระบบขัดข้อง |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_individual_settings_summary&employee_code=EMP001§ion=all&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ข้อความอธิบาย (field ที่ลงท้ายด้วย
_text), ชื่อวัน, ชื่อประเภท และชื่อพนักงานเปลี่ยนตามlanguage_code— ชื่อภาษาอังกฤษจะใช้เมื่อมีการตั้งไว้ ไม่เช่นนั้นใช้ชื่อภาษาไทย (ยกเว้นemployee_type_nameและชื่อประเภทในdebt_settingsซึ่งจะเป็นค่าว่าง) - ค่า ID ใน response เป็น plain text ไม่ได้เข้ารหัส Base64
- กฎเวลาทำงานแสดงเฉพาะกฎที่เปิดใช้กับประเภทของพนักงานคนนี้ เป็นการตั้งค่าปัจจุบัน (รวมค่าที่ตั้งรายบุคคล) ไม่ใช่ค่าที่บันทึกไว้กับรอบเงินเดือน
Related APIs
- Get Organization Settings Summary - ดูสรุปการตั้งค่าระดับองค์กร
- Get Employee Loan List - ดูรายการเงินกู้พนักงาน