Create Extra Round
สร้างงวดพิเศษใหม่สำหรับการจ่ายเงินนอกรอบปกติ เช่น โบนัส ค่าคอมมิชชัน หรือรายรับรายจ่ายพิเศษอื่นๆ
Endpoint
POST /api/v1/open-apis/salary/add-data-filter?path_action=create_extra_roundRequest Body
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year_month | string | Yes | เดือนที่ต้องการสร้างงวดพิเศษ (YYYY-MM) | "2026-03" |
extra_round_name | string | Yes | ชื่องวดพิเศษ (ห้ามมีเครื่องหมายจุด .) | "โบนัสไตรมาส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
| Field | Type | Description |
|---|---|---|
master_salary_xtra_report_id | string | รหัสงวดพิเศษที่สร้างใหม่ (plain text) |
master_salary_report_id | string | รหัสรอบเงินเดือนหลักของเดือนนั้น |
master_salary_month | string | เดือนของงวดพิเศษ (YYYY-MM) |
master_salary_xtra_seq | number | ลำดับงวดพิเศษในเดือนนั้น (สร้างอัตโนมัติ) |
master_salary_xtra_name | string | ชื่องวดพิเศษ |
Error Responses
{
"code": 400,
"message": "ValidationException: year_month ไม่ถูกต้อง ต้องเป็นรูปแบบ YYYY-MM",
"payload": []
}{
"code": 500,
"message": "ไม่พบรอบการจ่ายเงินเดือนสำหรับเดือน 2026-03",
"payload": []
}Code Examples
cURL
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 เพื่อบันทึกข้อมูลรายรับรายจ่ายของพนักงาน
Related APIs
- Save Extra Round - บันทึกข้อมูลรายรับรายจ่ายของพนักงาน
- Get Extra Round Detail - ดูรายละเอียดงวดพิเศษที่สร้าง
- Delete Extra Round - ลบงวดพิเศษที่สร้างผิด
Last updated on