Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Employee Financial Data

ดึงข้อมูลทางการเงินทั้งหมดของพนักงาน

Endpoint

GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=all-financial

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น all-financial
employee_codestringYesรหัสพนักงาน

ใช้ employee_code เพื่อระบุพนักงาน

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID

  • Response จะ return raw string ID (เช่น 20260121FC89F3BB9120)
  • เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": { "constant": [ { "employee_constant_id": "20260121EC01A2B3C4D5", "constant_type": "INCOME", "constant_code": "ALW001", "constant_name": "เบี้ยเลี้ยง", "amount": 3000, "effective_date": "2026-01-01", "end_date": null }, { "employee_constant_id": "20260121EC02A2B3C4D5", "constant_type": "EXPENSE", "constant_code": "DED001", "constant_name": "หักค่าประกัน", "amount": 500, "effective_date": "2026-01-01", "end_date": null } ], "fund": [ { "employee_fund_id": "20260121FD01A2B3C4D5", "fund_code": "PVD001", "fund_name": "กองทุนสำรองเลี้ยงชีพ ABC", "employee_rate": 5, "company_rate": 5, "start_date": "2025-01-01", "status": "ACTIVE" } ], "salary_auto_checked": [ { "employee_salary_auto_checked_id": "20260121SA01A2B3C4D5", "check_type": "MIN_SALARY", "check_value": 15000, "is_active": true } ], "welfare": [ { "employee_welfare_id": "20260121WE01A2B3C4D5", "welfare_code": "MED001", "welfare_name": "ค่ารักษาพยาบาล", "quota_amount": 30000, "used_amount": 5000, "balance": 25000 } ], "work_insurance": [ { "employee_work_insurance_id": "20260121WI01A2B3C4D5", "insurance_code": "SSO001", "insurance_type": "SOCIAL_SECURITY", "hospital_name": "โรงพยาบาลรามาธิบดี", "start_date": "2025-01-01", "status": "ACTIVE" } ] } }

Response Fields

SectionDescription
constantรายการรายรับ/รายจ่ายคงที่
fundรายการกองทุนสำรองเลี้ยงชีพ
salary_auto_checkedรายการตรวจสอบเงินเดือนอัตโนมัติ
welfareรายการสวัสดิการพนักงาน
work_insuranceรายการประกันสังคม

Constant Types

TypeDescription
INCOMEรายรับ (เช่น เบี้ยเลี้ยง, ค่าตำแหน่ง)
EXPENSEรายจ่าย (เช่น หักค่าประกัน, หักค่าเช่า)

Fund Status

StatusDescription
ACTIVEกำลังใช้งาน
PAUSEDหยุดพักชั่วคราว
PULLED_BACKถอนออกแล้ว
TERMINATEDสิ้นสุด

Code Examples

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

Last updated on