Get Month Withdraw
ดึงรายการรอบเดือนเงินเดือนที่พนักงานมีสิทธิ์ส่งคำขอเบิกเงินล่วงหน้าได้ในปัจจุบัน เหมาะสำหรับนำไปแสดงผลเป็น Dropdown ในหน้าจอสร้างคำขอเบิก
Endpoint
GET /api/v1/open-apis/withdraw/get-month
POST /api/v1/open-apis/withdraw/get-monthRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงานที่ต้องการตรวจสอบสิทธิ์ | "EMP001" |
master_salary_month | string | No | รอบเดือน (ถ้าไม่ส่งจะคืนค่าเดือนที่มีสิทธิ์ทั้งหมด) | "2026-03" |
Request Body Example
{
"employee_code": "EMP001"
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"master_salary_month": "2026-03",
"month_name": "มีนาคม 2026"
},
{
"master_salary_month": "2026-04",
"month_name": "เมษายน 2026"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
master_salary_month | string | รหัสรอบเดือน (YYYY-MM) สำหรับใช้เป็นพารามิเตอร์ใน API อื่นๆ |
month_name | string | ชื่อเดือนและปีที่แสดงผล (แปลภาษาตามการตั้งค่าระบบ) |
Error Response - Employee Not Found (HTTP 404)
{
"code": 404,
"message": "ไม่พบข้อมูลพนักงาน"
}Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-month?employee_code=EMP001" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
ข้อควรทราบ:
- หาก
payloadคืนค่าเป็นอาเรย์ว่าง[]แสดงว่าปัจจุบันพนักงานไม่มีรอบเดือนที่สามารถเบิกเงินล่วงหน้าได้ (อาจเพราะปิดงวดหมดแล้ว หรือยังไม่ได้ให้ความยินยอม) month_nameจะมีการจัดรูปแบบตาม Locale ของระบบ เช่น “March 2026” หรือ “มีนาคม 2026”- เดือนที่ถูกสรุปยอดหรือปิดงวดไปแล้วจะไม่ถูกนำมาแสดงผล
Related APIs
- Submit - นำค่า
master_salary_monthจากลิสต์นี้ไปใช้ในการส่งคำขอเบิก - Get Detail - ตรวจสอบวงเงินคงเหลือในแต่ละเดือน
Last updated on