Add Employee Constant
เพิ่มหรือแก้ไขรายรับ/รายจ่ายคงที่ของพนักงาน (Upsert by salary_type) ถ้ามีอยู่แล้วจะแก้ไข ถ้าไม่มีจะเพิ่มใหม่
Endpoint
POST /api/v1/open-apis/employee/add-employee-financial?path_action=constantQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น constant |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
salary_type_id | string | Yes | ID ประเภทรายรับ/รายจ่าย (Base64 encoded) |
employee_constant_amt | number | No | จำนวนเงิน (ถ้าเป็น 0 หรือไม่ส่งจะลบรายการ) |
employee_constant_start_dt | string | No | วันที่เริ่มต้น (YYYY-MM-DD) |
employee_constant_end_dt | string | No | วันที่สิ้นสุด (YYYY-MM-DD) |
- API นี้ทำงานแบบ Upsert: ถ้ายังไม่มีรายการจะเพิ่มใหม่ ถ้ามีรายการแล้วจะแก้ไข (ลบเดิมแล้วสร้างใหม่)
salary_type_idต้องเป็น Base64 encoded เมื่อส่งใน request แต่ค่าที่ได้รับใน response จะเป็น plain text- ถ้าตั้งค่า
employee_constant_amtเป็น 0 จะเป็นการลบรายการ
Response Format
Success Response (Add/Update)
{
"code": 200,
"message": "Add Constant Success",
"payload": {
"employee_constant_id": "20260215EC01A2B3C4D5",
"employee_id": "20260215EM01A2B3C4D5",
"salary_type_id": "20260215ST01A2B3C4D5",
"employee_constant_amt": 5000,
"employee_constant_start_dt": "2024-01-01",
"employee_constant_end_dt": "2024-12-31"
}
}Success Response (Delete by amt = 0)
{
"code": 200,
"message": "Update Constant Success",
"payload": {
"employee_id": "20260215EM01A2B3C4D5",
"salary_type_id": "20260215ST01A2B3C4D5",
"employee_constant_amt": 0,
"deleted": true
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_constant_id | string | ID รายการคงที่ |
employee_id | string | ID พนักงาน |
salary_type_id | string | ID ประเภทรายรับ/รายจ่าย |
employee_constant_amt | number | จำนวนเงิน |
employee_constant_start_dt | string | วันที่เริ่มต้น (YYYY-MM-DD) |
employee_constant_end_dt | string | วันที่สิ้นสุด (YYYY-MM-DD) |
deleted | boolean | สถานะการลบ (มีเฉพาะเมื่อ amt = 0) |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing required parameter: 'employee_code'"
]
}Validation Rules
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
salary_type_id | ต้องระบุ, ต้องเป็น Base64 encoded, ต้องมีอยู่ในระบบ |
employee_constant_amt | ถ้าระบุต้องเป็นตัวเลขและ >= 0 |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=constant" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"salary_type_id": "MjAyNjAyMTVTVDAxQTJCM0M0RDU=",
"employee_constant_amt": 5000,
"employee_constant_start_dt": "2024-01-01",
"employee_constant_end_dt": "2024-12-31"
}'Notes
- การเปลี่ยนแปลงจะมีผลกับการคำนวณเงินเดือนงวดถัดไป
- รองรับทั้งรายรับ (
calculate_type_lv = 1) และรายจ่าย (calculate_type_lv = -1) - สามารถกำหนดช่วงเวลาที่มีผลได้ผ่าน
employee_constant_start_dtและemployee_constant_end_dt
Related APIs
- List Constants - ดึงรายการรายรับ/รายจ่ายคงที่ทั้งหมด
- Get Constant - ดึงข้อมูลรายรับ/รายจ่ายคงที่ตาม ID
- Update Constant - แก้ไขรายรับ/รายจ่ายคงที่
- Delete Constant - ลบรายรับ/รายจ่ายคงที่
Last updated on