Skip to Content
🚀 Welcome to Humansoft Open API Documentation

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

ParameterTypeRequiredDescriptionExample
path_actionstringYesระบุเป็น get_individual_settings_summary"get_individual_settings_summary"
employee_codestringYesรหัสพนักงาน"EMP001"
year_monthstringNoรอบเดือนอ้างอิง รูปแบบ YYYY-MM (ค่าเริ่มต้น: เดือนปัจจุบัน) — ดูหมายเหตุด้านล่าง"2026-10"
sectionstringNoหมวดที่ต้องการ (ค่าเริ่มต้น: all) ดูตารางด้านล่าง"general"
language_codestringNoภาษาของข้อความอธิบายและชื่อต่าง ๆ: TH หรือ EN (ค่าเริ่มต้น: TH)"EN"

ค่าของ section

ค่าหมวดที่ได้รับใน payload
allครบทั้ง 8 หมวด
generalgeneral_settings — ตั้งค่าทั่วไป
work_timework_time_settings — ตั้งค่าเวลาการทำงาน
work_cycle_holidaywork_cycle_holiday_settings — กะการทำงานและวันหยุดประจำสัปดาห์
constantconstant_settings — รายรับรายจ่ายคงที่
autoauto_settings — รายรับรายจ่ายอัตโนมัติ
fundfund_settings — กองทุน
taxtax_settings — ลดหย่อนภาษี
debtdebt_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

ข้อมูลพนักงาน

FieldTypeDescription
employee_idstringID ของพนักงาน
employee_codestringรหัสพนักงาน
employee_namestringชื่อ-นามสกุลตาม language_code (ใช้ชื่อภาษาอังกฤษถ้ามี) ต่อท้ายด้วยชื่อเล่นในวงเล็บถ้ามี
employee_type_codestringรหัสประเภทพนักงาน: "01" = รายเดือน, "02" = รายวัน, "03" = พาร์ตไทม์, "04" = เหมาจ่าย
employee_type_namestringชื่อกลุ่มประเภทพนักงานตาม language_code (เป็นค่าว่างเมื่อพนักงานไม่มีกลุ่มประเภท หรือเมื่อเป็น EN และไม่ได้ตั้งชื่อภาษาอังกฤษ)
year_monthstringรอบเดือนที่ส่งมา (หรือเดือนปัจจุบัน)
sectionstringหมวดที่ขอ

general_settings

FieldTypeDescription
days_per_monthstringจำนวนวันต่อเดือนของพนักงาน: "26" / "30" = ตามจำนวนนั้น, "31" = ตามจริง, "0" = ตามการตั้งค่าองค์กร
days_per_month_textstringคำอธิบาย days_per_month ตาม language_code
hours_per_daystringจำนวนชั่วโมงทำงานต่อวัน เช่น "08:00:00", "08:30:00", "09:00:00" — "24:00:00" = ตามกะการทำงาน, "00:00:00" = ตามการตั้งค่าองค์กร
hours_per_day_textstringคำอธิบาย hours_per_day ตาม language_code
round_month_configstringรอบการจ่ายเงินเดือน: "Full" = เต็มเดือน, "Split" = แบ่งงวดจ่าย
round_month_config_textstringคำอธิบาย round_month_config ตาม language_code
holiday_apply_configstringสิทธิ์รับค่าจ้างวันหยุดนักขัตฤกษ์: "Y" = อนุญาต, "N" = ไม่อนุญาต — มีผลกับพนักงานรายวัน เมื่อองค์กรเปิดการจ่ายค่าจ้างวันหยุดนักขัตฤกษ์
holiday_apply_config_textstringคำอธิบาย holiday_apply_config ตาม language_code
approversobjectผู้อนุมัติลำดับที่ 1–5: auth_first, auth_second, auth_third, auth_fourth, auth_fifth — เป็น null เมื่อไม่ได้กำหนดหรือไม่พบข้อมูลผู้อนุมัติ
approvers.*.employee_idstringID ของผู้อนุมัติ
approvers.*.employee_codestringรหัสพนักงานของผู้อนุมัติ
approvers.*.employee_namestringชื่อ-นามสกุลของผู้อนุมัติตาม language_code

work_time_settings

กฎเวลาทำงานขององค์กรที่เปิดใช้กับประเภทของพนักงานคนนี้ โดยถ้าพนักงานมีการตั้งค่ารายบุคคล ค่าของพนักงานจะใช้แทนค่าขององค์กร (is_individual_override เป็น true) หากไม่มีการตั้งค่าจะได้ array ว่าง

กฎที่ตั้งรายบุคคล (is_individual_override เป็น true) ชื่อกฎภาษาไทยจะมาจากการตั้งค่ารายบุคคล (ถ้าไม่ได้ตั้งชื่อไว้จะใช้ชื่อมาตรฐานของระบบ) ส่วนชื่อภาษาอังกฤษยังใช้ชื่อที่องค์กรตั้งไว้

FieldTypeDescription
receivearrayกฎการได้เงิน เช่น morning (มาเช้า), underlunch (พักไว), after (กลับช้า)
deductarrayกฎการหักเงิน เช่น late (สาย), overlunch (พักเกิน), early (กลับก่อน)
overtimearrayกฎค่าล่วงเวลา OT_1_0, OT_1_5, OT_2_0 ถึง OT_7_0

รายการใน receive และ deduct

FieldTypeDescription
type_codestringรหัสประเภท
type_namestringชื่อที่องค์กรตั้งไว้ — เมื่อ language_code เป็น EN ใช้ชื่อภาษาอังกฤษถ้าตั้งไว้ ไม่เช่นนั้นใช้ชื่อภาษาไทยที่องค์กรตั้ง และถ้าไม่ได้ตั้งชื่อเลยจะใช้ชื่อมาตรฐานของระบบ
is_individual_overridebooleantrue = พนักงานคนนี้มีการตั้งค่ากฎนี้รายบุคคล และใช้ค่านั้นแทนค่าขององค์กร (เป็น true แม้ค่าที่ตั้งจะเท่ากับขององค์กร)
employee_typestringกลุ่มพนักงานของกฎ: EMP_MONTHLY, EMP_DAILY, EMP_PARTTIME, EMP_CONTRACTOR (ตามประเภทของพนักงาน)
employee_type_textstringชื่อกลุ่มพนักงานตาม language_code
action_activebooleantrue = มีการตั้งค่าเกณฑ์การได้เงิน/หักเงินไว้ — พนักงานเหมาจ่าย (EMP_CONTRACTOR) เป็น true เสมอ
calculation_methodstring"A" = ตามอัตราค่าแรง, "B" = อัตราบาทต่อนาที, "C" = ตามสูตรคำนวณ
calculation_method_textstringคำอธิบายวิธีคำนวณตาม language_code (กรณี "B" จะระบุบาทต่อนาทีด้วย)
calculation_valuenumberกรณี "A" = ตัวคูณของอัตราค่าแรง, กรณี "B" = บาทต่อนาที, วิธีตามสูตรคำนวณจะเป็น 0
tax_includebooleanนำยอดเงินไปคำนวณภาษี
sso_includebooleanนำยอดเงินไปคำนวณประกันสังคม
provident_includebooleanนำยอดเงินไปคำนวณกองทุนสำรองเลี้ยงชีพ
emp_welfare_fund_includebooleanนำยอดเงินไปคำนวณกองทุนสงเคราะห์ลูกจ้าง

รายการใน overtime

FieldTypeDescription
ot_codestringรหัสโอที เช่น "OT_1_5"
ot_multipliernumberตัวคูณโอทีตามรหัส เช่น 1.5
ot_namestringชื่อที่องค์กรตั้งไว้ (กติกาเดียวกับ type_name) — ชื่อมาตรฐานของระบบเป็นรูปแบบ เช่น "โอที 1.5 เท่า", "โอที 2 เท่า" (EN: "OT 1.5x")
is_individual_overridebooleantrue = พนักงานคนนี้มีการตั้งค่าโอทีนี้รายบุคคล และใช้ค่านั้นแทนค่าขององค์กร (เป็น true แม้ค่าที่ตั้งจะเท่ากับขององค์กร)
use_with.day_typestringวันที่ใช้: "A" = วันทำงาน, "B" = วันหยุด, "C" = วันทำงานและวันหยุด
use_with.day_type_textstringคำอธิบาย day_type ตาม language_code
use_with.time_periodstringช่วงเวลา: "A" = ในเวลากะ, "B" = นอกเวลากะ, "C" = ในและนอกเวลากะ (รวมกรณีที่ไม่ได้กำหนดช่วงเวลา) — เมื่อ day_type เป็น "A" จะเป็น "B" เสมอ
use_with.time_period_textstringคำอธิบาย time_period ตาม language_code
lunch_includebooleantrue = นับรวมเวลาพักกลางวัน — เมื่อ day_type เป็น "A" จะเป็น true เสมอ
employee_typestringกลุ่มพนักงานของกฎ (ตามประเภทของพนักงาน)
employee_type_textstringชื่อกลุ่มพนักงานตาม language_code
calculation_methodstringวิธีคำนวณค่าโอที: "A" = อัตราค่าแรง × calculation_value, "B" = บาทต่อนาที, "C" = ตามสูตรคำนวณ, "D" = แปลงเวลาโอทีเป็นวันหยุด
calculation_method_textstringคำอธิบายวิธีคำนวณตาม language_code เช่น "1.5 เท่าของค่าแรง", "นาทีละ 2 บาท", "แปลงเป็นวันหยุดพิเศษ"
calculation_valuenumberค่าที่ใช้คำนวณ เช่น 1.5 — กรณี "D" คืออัตราแปลงชั่วโมงโอทีเป็นชั่วโมงวันหยุด
max_ot_hoursinteger | nullชั่วโมงโอทีสูงสุดที่ตั้งไว้ (null = ไม่ได้กำหนด ระบบจะจำกัดตามชั่วโมงทำงานของกะ)
tax_includebooleanนำค่าโอทีไปคำนวณภาษี
sso_includebooleanนำค่าโอทีไปคำนวณประกันสังคม
provident_includebooleanนำค่าโอทีไปคำนวณกองทุนสำรองเลี้ยงชีพ
emp_welfare_fund_includebooleanนำค่าโอทีไปคำนวณกองทุนสงเคราะห์ลูกจ้าง

work_cycle_holiday_settings

FieldTypeDescription
personal_configbooleantrue = พนักงานใช้ตารางกะและวันหยุดเฉพาะบุคคล, false = ใช้ตามองค์กร/แผนก
work_cycle_listsarrayกะการทำงานประจำสัปดาห์ 7 รายการ (จันทร์–อาทิตย์)
work_cycle_lists[].daystringรหัสวัน: Mon, Tue, Wed, Thu, Fri, Sat, Sun
work_cycle_lists[].day_namestringชื่อวันตาม language_code
work_cycle_lists[].work_cycle_idstringID ของกะการทำงาน (ค่าว่างเมื่อไม่ได้กำหนดกะในวันนั้น)
work_cycle_lists[].work_cycle_codestringรหัสกะการทำงาน
work_cycle_lists[].work_start_timestringเวลาเข้างานของกะ (กะแบบควบกะใช้เวลาเข้าของช่วงแรก)
work_cycle_lists[].work_end_timestringเวลาออกงานของกะ (กะแบบควบกะใช้เวลาออกของช่วงหลัง)
work_cycle_lists[].is_activebooleantrue = มีการกำหนดกะในวันนั้น
holiday_listsarrayวันทำงาน/วันหยุดประจำสัปดาห์ 7 รายการ (จันทร์–อาทิตย์)
holiday_lists[].daystringรหัสวัน
holiday_lists[].day_namestringชื่อวันตาม language_code
holiday_lists[].holiday_codestring"00" = วันทำงาน (รวมวันที่ไม่ได้ตั้งค่า), "03" = วันหยุดพนักงาน
holiday_lists[].holiday_namestringคำอธิบาย holiday_code ตาม language_code

constant_settings

แสดงประเภทรายรับรายจ่ายคงที่ทุกประเภทขององค์กร พร้อมค่าที่ตั้งให้พนักงาน — ประเภทที่ไม่ได้ตั้งให้พนักงานจะมี employee_constant_id เป็น null และยอดเป็น 0

FieldTypeDescription
incomearrayรายรับคงที่
expensearrayรายจ่ายคงที่
*[].employee_constant_idstring | nullID ของรายการที่ตั้งให้พนักงาน (null = ไม่ได้ตั้ง)
*[].salary_type_idstringID ของประเภทรายรับรายจ่าย
*[].salary_type_codestringรหัสประเภท
*[].salary_type_namestringชื่อประเภทตาม language_code (ใช้ชื่อภาษาอังกฤษถ้ามี)
*[].calculate_type_lvinteger1 = รายรับ, -1 = รายจ่าย
*[].employee_constant_amtnumberจำนวนเงินต่อเดือน
*[].employee_constant_start_dtstring | nullวันที่เริ่มมีผลที่บันทึกไว้ รูปแบบ YYYY-MM-DD HH:mm:ss (null = ไม่ได้ระบุ)
*[].employee_constant_end_dtstring | nullวันที่สิ้นสุดที่บันทึกไว้ รูปแบบ YYYY-MM-DD HH:mm:ss (null = ไม่ได้ระบุ)

auto_settings

แสดงประเภทรายรับรายจ่ายอัตโนมัติทุกประเภทขององค์กร พร้อมสถานะว่าพนักงานคนนี้ถูกเลือกไว้หรือไม่

FieldTypeDescription
income / expensearrayรายรับ / รายจ่ายอัตโนมัติ
*[].salary_type_idstringID ของประเภท
*[].salary_type_codestringรหัสประเภท
*[].salary_type_namestringชื่อประเภทตาม language_code
*[].calculate_type_lvinteger1 = รายรับ, -1 = รายจ่าย
*[].is_enabledbooleantrue = พนักงานถูกเลือกไว้ในรายการนี้ — มีผลกับประเภทที่กำหนดให้ใช้เฉพาะพนักงานที่เลือก ส่วนประเภทอื่นค่า false ไม่ได้หมายความว่ารายการนั้นไม่ถูกนำไปคำนวณ

fund_settings

แสดงกองทุนทุกกองขององค์กร พร้อมข้อมูลสมาชิกของพนักงาน — กองทุนที่พนักงานไม่ได้เป็นสมาชิกจะมีอัตราและยอดเงินเป็น 0 และวิธีคิดเป็น "01"

FieldTypeDescription
fund_idstringID ของกองทุน
fund_namestringชื่อกองทุนตาม language_code
salary_type_codestringรหัสประเภทรายจ่ายของกองทุน
is_enrolledbooleantrue = พนักงานเป็นสมาชิกกองทุนนี้อยู่ในปัจจุบัน
fund_employee_idstring | nullID ของข้อมูลสมาชิก (null เมื่อไม่ได้เป็นสมาชิก)
fund_employee_nostringเลขที่สมาชิก
fund_employee_datestring | nullวันที่เข้าเป็นสมาชิก
fund_employee_typestringวิธีคิดเงินสะสมของพนักงาน: "01" = เป็น %, "02" = เป็นบาท, ค่าอื่น = ตามสูตร
fund_employee_type_textstringคำอธิบาย fund_employee_type ตาม language_code
fund_employee_ratenumberอัตราเงินสะสมของพนักงาน
fund_company_typestringวิธีคิดเงินสมทบของนายจ้าง (ค่าเหมือน fund_employee_type)
fund_company_type_textstringคำอธิบาย fund_company_type ตาม language_code
fund_company_ratenumberอัตราเงินสมทบของนายจ้าง
fund_employee_beneficiarystringผู้รับผลประโยชน์
fund_employee_remarkstringหมายเหตุ
fund_employee_balancenumberยอดเงินสะสมของพนักงาน
fund_employee_statusstringสถานะสมาชิก: "A" = ปกติ, "P" = ระงับ, "N" = ไม่ได้เป็นสมาชิกในปัจจุบัน (รวมผู้ที่ออกจากกองทุนแล้ว ซึ่ง fund_out_date จะมีค่า), "O" = เป็นสมาชิกและมีวันที่ออกจากกองทุนบันทึกไว้
fund_employee_status_textstringคำอธิบายสถานะตาม language_code
fund_out_datestring | nullวันที่ออกจากกองทุนที่บันทึกไว้ (อาจมีค่าแม้ is_enrolled เป็น false)

tax_settings

FieldTypeDescription
tax_yearstringปีภาษี (ค.ศ.)
tax_month_qtyintegerจำนวนเดือนในปีที่มีข้อมูลภาษีจากการคำนวณเงินเดือน
tax_month_qty_textstringคำอธิบาย tax_month_qty ตาม language_code
total_tax_amtnumberยอดลดหย่อนรวมโดยประมาณของปีภาษี รวมประมาณการกองทุนสำรองเลี้ยงชีพและประกันสังคมถึงสิ้นปี — อาจไม่เท่ากับผลรวม tax_amt ใน tax_categories
tax_categoriesarrayหมวดลดหย่อนทุกหมวดของปี รวมหมวดที่ยอดเป็น 0
tax_categories[].tax_category_idstringID ของหมวดลดหย่อน
tax_categories[].tax_category_namestringชื่อหมวดตาม language_code
tax_categories[].max_amtnumberวงเงินลดหย่อนสูงสุดของหมวด
tax_categories[].tax_amtnumberผลรวมยอดลดหย่อนที่บันทึกไว้ของพนักงานในหมวดนี้
tax_categories[].child_categoriesarrayหมวดย่อย (โครงสร้างเดียวกัน ไม่มี child_categories)

debt_settings

แสดงสัญญาเงินกู้ของพนักงานทุกสถานะ

FieldTypeDescription
employee_loan_idstringID ของสัญญาเงินกู้
employee_loan_descstringรายละเอียดสัญญา
salary_type_idstringID ของประเภทรายจ่ายที่ใช้หักชำระ
salary_type_namestringชื่อประเภทตาม language_code (เมื่อเป็น EN และไม่ได้ตั้งชื่อภาษาอังกฤษ จะเป็นค่าว่าง)
salary_type_codestringรหัสประเภท
employee_loan_dtstring | nullวันที่ทำสัญญา
employee_loan_amt_principlenumberเงินต้น
employee_loan_amt_interestnumberดอกเบี้ยรวม
employee_loan_total_amtnumberยอดชำระรวมทุกงวด (เงินต้น + ดอกเบี้ย)
employee_loan_period_countintegerจำนวนงวด
employee_loan_statusstringสถานะ: "N" = กำลังผ่อนชำระ, "Y" = ชำระครบแล้ว, "C" = ปิดบัญชี (ยกเลิก)
employee_loan_status_textstringคำอธิบายสถานะตาม language_code
periodsarrayงวดผ่อนชำระเรียงตามลำดับงวด
periods[].employee_loan_period_idstringID ของงวด
periods[].employee_loan_period_seqintegerลำดับงวด
periods[].employee_loan_period_monthstringเดือนที่หักชำระ (YYYY-MM)
periods[].employee_loan_period_principlenumberเงินต้นของงวด
periods[].employee_loan_period_interestnumberดอกเบี้ยของงวด
periods[].employee_loan_period_amtnumberยอดชำระของงวด
periods[].is_paidbooleantrue = ชำระแล้ว

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 StatusDescription
400Parameter ไม่ถูกต้อง หรือไม่พบพนักงานตาม employee_code
401API Key ไม่ถูกต้องหรือไม่ได้ส่ง
403API Key ไม่มีสิทธิ์ payroll:read:all
500ระบบขัดข้อง

Code Examples

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&section=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
  • กฎเวลาทำงานแสดงเฉพาะกฎที่เปิดใช้กับประเภทของพนักงานคนนี้ เป็นการตั้งค่าปัจจุบัน (รวมค่าที่ตั้งรายบุคคล) ไม่ใช่ค่าที่บันทึกไว้กับรอบเงินเดือน

Last updated on