Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Month Withdraw

ดึงรายการรอบเดือนเงินเดือนที่พนักงานมีสิทธิ์ส่งคำขอเบิกเงินล่วงหน้าได้ในปัจจุบัน เหมาะสำหรับนำไปแสดงผลเป็น Dropdown ในหน้าจอสร้างคำขอเบิก

Endpoint

GET /api/v1/open-apis/withdraw/get-month POST /api/v1/open-apis/withdraw/get-month

Request Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงานที่ต้องการตรวจสอบสิทธิ์"EMP001"
master_salary_monthstringNoรอบเดือน (ถ้าไม่ส่งจะคืนค่าเดือนที่มีสิทธิ์ทั้งหมด)"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

FieldTypeDescription
master_salary_monthstringรหัสรอบเดือน (YYYY-MM) สำหรับใช้เป็นพารามิเตอร์ใน API อื่นๆ
month_namestringชื่อเดือนและปีที่แสดงผล (แปลภาษาตามการตั้งค่าระบบ)

Error Response - Employee Not Found (HTTP 404)

{ "code": 404, "message": "ไม่พบข้อมูลพนักงาน" }

Code Examples

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”
  • เดือนที่ถูกสรุปยอดหรือปิดงวดไปแล้วจะไม่ถูกนำมาแสดงผล
  • Submit - นำค่า master_salary_month จากลิสต์นี้ไปใช้ในการส่งคำขอเบิก
  • Get Detail - ตรวจสอบวงเงินคงเหลือในแต่ละเดือน
Last updated on