Get List Petty Cash

API สำหรับดึงรายการเอกสารคำขอเบิกเงินสดย่อยของพนักงาน 1 คน (ระบุด้วย authorize_id หรือ employee_code) สามารถกรองข้อมูลตามปี เดือน สถานะเอกสาร และวันที่พิจารณาได้ ระบบจะดึงรายการย่อย (Items) ของแต่ละเอกสารออกมาให้อัตโนมัติ พร้อมคำนวณยอดรวมเงินเบิกและจำนวนรายการของแต่ละเอกสาร

Endpoint


GET /api/v1/open-apis/petty-cash/get-list

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes*	ID ของผู้ใช้ (Base64) — ดึงเอกสารของพนักงานที่ผูกกับผู้ใช้นี้ ต้องระบุอย่างน้อยหนึ่ง field	`"MjAyNTAzMDM1MUIwQTJDQ0JEOUM="`
`employee_code`	string	Yes*	รหัสพนักงานที่ต้องการดูเอกสาร — ใช้เมื่อไม่ได้ส่ง `authorize_id` หรือผู้ใช้นั้นไม่ได้ผูกกับพนักงาน ต้องระบุอย่างน้อยหนึ่ง field	`"EMP001"`

ต้องระบุ authorize_id หรือ employee_code อย่างน้อยหนึ่งตัว หากส่งทั้งคู่และ authorize_id ผูกกับพนักงาน ระบบจะใช้พนักงานตาม authorize_id

Optional Parameters

Parameter	Type	Required	Description	Example
`req_year`	string	No	ปีที่ยื่นขอ (YYYY)	`"2026"`
`req_month`	string	No	เดือนที่ยื่นขอ (MM) — มีผลเฉพาะเมื่อส่ง `req_year` ด้วย	`"03"`
`petty_cash_type_lv`	string	No	กรองตามสถานะเอกสาร	`"01"`
`approve_dt`	string	No	กรองเอกสารที่มีวันที่พิจารณาครั้งล่าสุด (`approve_dt`) ตรงกับวันที่ระบุ (YYYY-MM-DD)	`"2026-03-24"`
`lang`	string	No	ภาษาของข้อความ `message`: `TH` (ค่าเริ่มต้น) หรือ `EN`	`"EN"`

Option Values: `petty_cash_type_lv`

Value	Description (EN)	คำอธิบาย
`01`	Pending	รออนุมัติ
`02`	Withdrawing	กำลังตั้งเบิก (อนุมัติขั้นสุดท้ายแล้ว)
`03`	Not Approved	ไม่อนุมัติ
`04`	Withdrew	ตั้งเบิกแล้ว
`05`	Received	ได้รับเงินแล้ว
`06`	Recheck	ตรวจสอบอีกครั้ง
`07`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 1)
`08`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 2)
`09`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 3)
`10`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 4)
`11`	Manager Approved	หัวหน้าอนุมัติ (หัวหน้าลำดับสุดท้ายในสายอนุมัติ รอฝ่ายบุคคลอนุมัติ)
`12`	Approved	อนุมัติ (บันทึกเข้างวดเงินเดือน)

Response Format

Success Response


{
  "code": 200,
  "message": "ดึงรายการเอกสารเงินสดย่อยสำเร็จ",
  "payload": [
    {
      "petty_cash_id": "20251127D4573C421639",
      "employee_id": "20260309462FEF65EFCA",
      "employee_name": "นายสมชาย ใจดี (ชาย)",
      "request_topic": "เบิกค่าเดินทางไปพบลูกค้า",
      "petty_cash_type_lv": "01",
      "req_dt": "2026-03-25",
      "req_amt": 500,
      "item_count": 1,
      "item_list": [
        {
          "petty_cash_item_id": "20260325A1B2C3D4E5F6",
          "petty_cash_id": "20251127D4573C421639",
          "petty_cash_item_name": "ค่าน้ำมันรถ",
          "petty_cash_type_id": "20260303A1B2C3D4E5F6",
          "petty_cash_type_name": "",
          "req_amt": "500.00",
          "attach_file": [
            "https://cdn.humansoft.co.th/.../files/a1B2c3D4e5F6.jpg"
          ],
          "created": "2026-03-25 10:15:00"
        }
      ]
    }
  ]
}

Response Fields

Field	Type	Nullable	Description
`petty_cash_id`	string	No	รหัสเอกสาร
`employee_id`	string	No	ID ของพนักงาน
`employee_name`	string	No	ชื่อพนักงาน (คำนำหน้า ชื่อ นามสกุล และชื่อเล่นในวงเล็บ)
`request_topic`	string	No	หัวข้อการเบิก
`petty_cash_type_lv`	string	No	รหัสสถานะเอกสาร
`req_dt`	string	No	วันที่ยื่นคำขอ (YYYY-MM-DD)
`req_amt`	number	No	ยอดเงินรวมของเอกสาร (ผลรวม `req_amt` ของทุกรายการ, `0` หากยังไม่มีรายการ)
`item_count`	number	No	จำนวนรายการย่อยในเอกสาร
`item_list`	array	No	รายละเอียดรายการย่อย — โครงสร้างเดียวกับ `item_list` ใน Get Detail ยกเว้น `petty_cash_type_name` ที่ API นี้คืนเป็นค่าว่าง

Error Response

ระบุพนักงานไม่ได้ (422) — ไม่ได้ส่งทั้ง authorize_id และ employee_code หรือหาพนักงานจากค่าที่ส่งไม่พบ


{
  "code": 422,
  "message": "การตรวจสอบข้อมูลล้มเหลว",
  "errors": ["'employee_code' is required when 'authorize_id' is not provided"]
}

เกิดข้อผิดพลาดระหว่างดึงข้อมูล (400)


{
  "code": 400,
  "message": "ล้มเหลว",
  "error": "รายละเอียดข้อผิดพลาด"
}

HTTP Status	Description
`400`	เกิดข้อผิดพลาดระหว่างดึงข้อมูล
`403`	API Key ไม่มีสิทธิ์ `document:manage`
`422`	ระบุพนักงานจาก `authorize_id` หรือ `employee_code` ไม่ได้

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/get-list?authorize_id=MjAyNTAzMDM1MUIwQTJDQ0JEOUM=&req_year=2026&req_month=03" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  authorize_id: 'MjAyNTAzMDM1MUIwQTJDQ0JEOUM=',
  req_year: '2026',
  req_month: '03'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/get-list?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/get-list"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "req_year": "2026",
    "req_month": "03"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()

PHP


<?php
$params = http_build_query([
    "authorize_id" => "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "req_year" => "2026",
    "req_month" => "03"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/get-list?" . $params;
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
?>

Notes

รายการที่ดึงมาเป็นเอกสารของพนักงานคนเดียวตาม authorize_id หรือ employee_code เท่านั้น หากต้องการค้นหาเอกสารของพนักงานหลายคน ให้ใช้ API Search List
item_list[].petty_cash_type_name ใน API นี้เป็นค่าว่าง — ดูชื่อประเภทค่าใช้จ่ายได้จาก Get Detail หรือนำ petty_cash_type_id ไปเทียบกับ List Types
item_list[].attach_file คืนเป็น URL ของไฟล์แนบ (ถ้ามี)
API นี้ไม่ได้จำกัดสิทธิ์รายผู้ใช้ — ส่ง employee_code ของพนักงานใดในองค์กรก็ได้ หากต้องจำกัดการเข้าถึง ให้ตรวจสอบที่ระบบของคุณ

หากต้องการกรองด้วยเดือน (req_month) จำเป็นต้องระบุปี (req_year) มาด้วยเสมอ — ถ้าส่ง req_month อย่างเดียว ระบบจะไม่กรองตามเดือน

Get Detail - ดูรายละเอียดเอกสาร
Search List - ค้นหาเอกสารสำหรับ HR/ผู้อนุมัติ
Submit - สร้างเอกสารคำขอเบิกเงินสดย่อย