Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Create Extra Round

สร้างงวดพิเศษใหม่สำหรับการจ่ายเงินนอกรอบปกติ เช่น โบนัส ค่าคอมมิชชัน หรือรายรับรายจ่ายพิเศษอื่นๆ

Endpoint

POST /api/v1/open-apis/salary/add-data-filter?path_action=create_extra_round

Request Body

ParameterTypeRequiredDescriptionExample
year_monthstringYesเดือนที่ต้องการสร้างงวดพิเศษ (YYYY-MM)"2026-03"
extra_round_namestringYesชื่องวดพิเศษ (ห้ามมีเครื่องหมายจุด .)"โบนัสไตรมาส1"
  • เดือนที่ระบุต้องมีการตั้งค่ารอบการจ่ายเงินเดือนไว้แล้ว มิฉะนั้นจะไม่สามารถสร้างได้
  • ชื่องวดพิเศษห้ามมีเครื่องหมายจุด (.)

Response Format

Success Response

{ "code": 200, "message": "Extra Round Created Successfully", "payload": { "master_salary_xtra_report_id": "20260323XYZ789", "master_salary_report_id": "20241225ABCD1234", "master_salary_month": "2026-03", "master_salary_xtra_seq": 1, "master_salary_xtra_name": "โบนัสไตรมาส1" } }

Response Fields

FieldTypeDescription
master_salary_xtra_report_idstringรหัสงวดพิเศษที่สร้างใหม่ (plain text)
master_salary_report_idstringรหัสรอบเงินเดือนหลักของเดือนนั้น
master_salary_monthstringเดือนของงวดพิเศษ (YYYY-MM)
master_salary_xtra_seqnumberลำดับงวดพิเศษในเดือนนั้น (สร้างอัตโนมัติ)
master_salary_xtra_namestringชื่องวดพิเศษ

Error Responses

{ "code": 400, "message": "ValidationException: year_month ไม่ถูกต้อง ต้องเป็นรูปแบบ YYYY-MM", "payload": [] }
{ "code": 500, "message": "ไม่พบรอบการจ่ายเงินเดือนสำหรับเดือน 2026-03", "payload": [] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/add-data-filter?path_action=create_extra_round" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "year_month": "2026-03", "extra_round_name": "โบนัสพิเศษประจำปี" }'

Notes

  • ลำดับงวดพิเศษ (master_salary_xtra_seq) จะถูกสร้างอัตโนมัติ เช่น งวดที่ 1, 2, 3 ตามลำดับ
  • หลังจากสร้างงวดแล้ว ให้ใช้ Save Extra Round เพื่อบันทึกข้อมูลรายรับรายจ่ายของพนักงาน

  • Save Extra Round - บันทึกข้อมูลรายรับรายจ่ายของพนักงาน
  • Get Extra Round Detail - ดูรายละเอียดงวดพิเศษที่สร้าง
  • Delete Extra Round - ลบงวดพิเศษที่สร้างผิด
Last updated on