Add Employee Work Insurance
เพิ่มรายการประกันการทำงาน (Work Insurance Log) ให้กับพนักงาน บันทึกการหักเงินประกันการทำงานในแต่ละเดือน
Endpoint
POST /api/v1/open-apis/employee/add-employee-financial?path_action=work-insuranceQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น work-insurance |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน (plain text) |
year_month | string | Yes | เดือนที่หักเงิน (รูปแบบ YYYY-MM) |
log_balance | number | Yes | จำนวนเงิน (ต้องไม่เป็น 0) |
log_source | string | No | แหล่งที่มา: Manual, System, Import (ค่าเริ่มต้น: Manual) |
Response Format
Success Response
{
"code": 200,
"message": "Add Work Insurance Success",
"payload": {
"work_insurance_log_id": "20260121WI01A2B3C4D5",
"employee_id": "20260121EM01A2B3C4D5",
"employee_code": "EMP001",
"master_salary_month": "2026-03",
"log_source": "Manual",
"log_balance": 1500,
"log_datetime": "2026-03-01 08:00:00",
"log_tracking_id": "20260121TM01A2B3C4D5",
"created": "2026-01-22 15:30:00"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
work_insurance_log_id | string | ID ของรายการ (plain text) |
employee_id | string | ID ของพนักงาน (plain text) |
employee_code | string | รหัสพนักงาน |
master_salary_month | string | เดือนที่หักเงิน (YYYY-MM) |
log_source | string | แหล่งที่มา |
log_balance | number | จำนวนเงิน |
log_datetime | datetime | วันเวลาที่บันทึก |
log_tracking_id | string | ID ของ log tracking (plain text) |
created | datetime | วันเวลาที่สร้างรายการ |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing required parameter: 'employee_code'",
"'year_month' must be in YYYY-MM format (e.g., 2026-01)"
]
}Validation Rules
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
year_month | ต้องระบุและต้องอยู่ในรูปแบบ YYYY-MM |
log_balance | ต้องระบุ ต้องเป็นตัวเลข และต้องไม่เป็น 0 |
log_source | ถ้าระบุต้องเป็น Manual, System หรือ Import |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=work-insurance" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"year_month": "2026-03",
"log_balance": 1500,
"log_source": "Manual"
}'Notes
- หากไม่ระบุ
log_sourceระบบจะใช้ค่า default เป็น"Manual" - ระบบจะสร้าง
log_datetimeอัตโนมัติเป็นวันที่ 1 ของเดือนนั้นเวลา 08:00:00 log_balanceสามารถเป็นจำนวนบวกหรือลบได้ แต่ต้องไม่เป็น 0- ระบบจะตรวจสอบว่ามี salary_type “work_insurance” ในระบบก่อนบันทึก
log_sourceมี 3 ประเภท: Manual (บันทึกด้วยตนเอง), System (ระบบสร้างจากการคำนวณเงินเดือน), Import (นำเข้าจากไฟล์)
Related APIs
- List Work Insurance - ดึงรายการประกันการทำงานทั้งหมด
- Get Work Insurance - ดึงข้อมูลประกันการทำงานตาม ID
- Delete Work Insurance - ลบรายการประกันการทำงาน
Last updated on