Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get List Withdraw

ดึงรายการเอกสารคำขอเบิกเงินล่วงหน้าทั้งหมดในระบบ รองรับการกรองข้อมูลตามปี เดือน สถานะเอกสาร และข้อมูลองค์กร

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
req_yearstringYesปีที่ต้องการค้นหา (ค.ศ. 4 หลัก)"2026"

Optional Parameters

ParameterTypeDefaultDescriptionExample
req_monthstring""เดือนที่ค้นหา (01-12)"03"
statusstring""กรองตามสถานะ (Y, N, R, C)"N"
language_codestring"TH"รหัสภาษา (TH, EN)"TH"
company_listsarray[]กรองตามบริษัท[{"id": "..."}]
branch_listsarray[]กรองตามสาขา[{"id": "..."}]
department_listsarray[]กรองตามแผนก[{"id": "..."}]
division_listsarray[]กรองตามฝ่าย[{"id": "..."}]
section_listsarray[]กรองตามแผนกย่อย[{"id": "..."}]
section_lists_lv01array[]กรองตามแผนกย่อย Level 1[{"id": "..."}]
section_lists_lv02array[]กรองตามแผนกย่อย Level 2[{"id": "..."}]
section_lists_lv03array[]กรองตามแผนกย่อย Level 3[{"id": "..."}]
section_lists_lv04array[]กรองตามแผนกย่อย Level 4[{"id": "..."}]
section_lists_lv05array[]กรองตามแผนกย่อย Level 5[{"id": "..."}]
position_listsarray[]กรองตามตำแหน่ง[{"id": "..."}]
employee_listsarray[]กรองเฉพาะกลุ่มพนักงาน[{"code": "..."}]

Request Body Example

{ "req_year": "2026", "req_month": "03", "status": "N", "language_code": "TH", "department_lists": [ { "id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=" } ] }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": [ { "employee_withdraw_doc_id": "20260312WDD00000001", "employee_id": "20260309462FEF65EFCA", "employee_code": "EMP001", "employee_name": "Tawan Raiduen", "withdraw_amt": "2000.00", "withdraw_dt": "2026-03-10", "approve_flag": "Y", "approve_flag_name": "อนุมัติแล้ว", "limit": 8000.00, "department_name": "IT", "position_name": "Software Developer", "created": "2026-03-09 10:00:00" } ], "date_disable": null }

Response Fields

FieldTypeDescription
employee_withdraw_doc_idstringรหัสเอกสาร
employee_idstringรหัสพนักงาน
employee_codestringรหัสพนักงาน (employee code)
employee_namestringชื่อพนักงาน
withdraw_amtstringจำนวนเงินที่ขอเบิก
withdraw_dtstringวันที่ทำรายการเบิก (YYYY-MM-DD)
approve_flagstringรหัสสถานะ (Y, N, R, C)
approve_flag_namestringชื่อสถานะภาษาไทย/อังกฤษ
limitfloatวงเงินโควตา ณ วันที่ทำการเบิก
department_namestringชื่อแผนกของพนักงาน
position_namestringชื่อตำแหน่งของพนักงาน
createdstringวันเวลาที่สร้างเอกสาร

Approve Flag Values

ค่าความหมาย
Nรออนุมัติ
Yอนุมัติแล้ว
Rปฏิเสธ (Rejected)
Cยกเลิกโดยผู้ใช้งาน

Error Response - Missing Year (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": ["'req_year' is required"] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-list" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "req_year": "2026", "req_month": "03", "status": "N", "language_code": "TH" }'

Notes

ข้อควรทราบ:

  • รายการจะเรียงลำดับตามวันที่ทำรายการ (Created) จากใหม่ไปเก่า
  • หากไม่ได้ระบุเดือน ระบบจะคืนค่าข้อมูลทั้งปี ซึ่งอาจทำให้ Response มีขนาดใหญ่ แนะนำให้กรองรายเดือน
  • ค่า id ใน filter lists (เช่น department_lists, branch_lists) ต้องเข้ารหัส Base64
  • Get Detail - ดูรายละเอียดวงเงินเชิงลึกของพนักงาน
  • Approve - อนุมัติเอกสารจากรายการในลิสต์
Last updated on