Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Salary Auto Checked

เพิ่มรายการรายรับ/รายจ่ายอัตโนมัติให้กับพนักงาน (เพิ่มทีละรายการ)

Endpoint

POST /api/v1/open-apis/employee/add-employee-financial?path_action=salary-auto-checked

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น salary-auto-checked

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน (plain text)
salary_type_idstringYesID ประเภทรายรับ/รายจ่ายอัตโนมัติ (Base64 encoded)

Response Format

Success Response

{ "code": 200, "message": "Add Auto Checked Success", "payload": { "employee_auto_checked_id": "20260215EA01A2B3C4D5", "employee_id": "20260215EM01A2B3C4D5", "salary_type_id": "20260215ST01A2B3C4D5" } }

Response Fields

FieldTypeDescription
employee_auto_checked_idstringID รายการอัตโนมัติ (plain text)
employee_idstringID พนักงาน (plain text)
salary_type_idstringID ประเภทรายรับ/รายจ่าย (plain text)

Error Response

{ "code": 400, "message": "Validation failed", "errors": [ "Missing required parameter: 'employee_code'" ] }

Validation Rules

FieldRule
employee_codeต้องระบุและต้องมีพนักงานในระบบ
salary_type_idต้องระบุ ต้อง encode เป็น Base64 และต้องมีในระบบ
Duplicate Checkพนักงานไม่สามารถมี salary_type_id ซ้ำได้
Auto Type Onlysalary_type ต้องมี salary_cal_type_lv = 'Auto'

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=salary-auto-checked" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "salary_type_id": "MjAyNjAyMTVTVDAxQTJCM0M0RDU=" }'

Notes

  • API นี้เพิ่มทีละรายการ หากต้องการบันทึกหลายรายการพร้อมกันให้ใช้ Save Salary Auto Checked แทน
  • salary_type_id ที่ส่งใน request ต้อง encode เป็น Base64
  • ฟิลด์ _id ใน response เป็น plain text ไม่ได้ encode Base64
  • พนักงานไม่สามารถมี salary_type เดียวกันซ้ำได้ หากมีอยู่แล้วจะได้ error
  • รายการที่เพิ่มจะถูกคำนวณอัตโนมัติในงวดเงินเดือนถัดไป

Last updated on