Approve Petty Cash

API สำหรับดำเนินการกับเอกสารเบิกเงินสดย่อยในขั้นตอนการอนุมัติ ผู้อนุมัติสามารถเลือกที่จะ “อนุมัติ” หรือ “ไม่อนุมัติ” พร้อมระบุเหตุผลได้ ระบบจะส่งการแจ้งเตือนไปยังเจ้าของเอกสารทันทีที่สถานะเปลี่ยนแปลง

Endpoint


POST /api/v1/open-apis/petty-cash/approve

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`petty_cash_id`	string (base64)	Yes	รหัสเอกสารที่ต้องการดำเนินการ	`"MjAy..."`
`petty_cash_type_lv`	string	Yes	สถานะใหม่ที่ต้องการเปลี่ยน (ดู Option Values)	`"12"`
`authorize_line`	string	Yes	ตรวจสอบสายการบังคับบัญชาของผู้อนุมัติ	`"true"`
`approve_dt`	string	Yes	วันที่ดำเนินการ (YYYY-MM-DD)	`"2026-03-25"`
`authorize_id`	string (base64)	Yes	ID ของผู้ดำเนินการ	`"MjAy..."`

Optional Parameters

Parameter	Type	Required	Description	Example
`approve_remark`	string	No	หมายเหตุหรือเหตุผลการพิจารณา	`"อนุมัติให้ตามระเบียบ"`
`signature_id`	string (base64)	No	ID ลายเซ็นดิจิทัล	`"U0lHT..."`
`petty_cash_in_calculation`	boolean	No	นำยอดเงินเข้าไปคำนวณในระบบการเงินหลักหรือไม่	`true`

Option Values: `petty_cash_type_lv`

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

Response Format

Success Response


{
  "code": 200,
  "message": "อนุมัติเรียบร้อยแล้ว",
  "payload": {
    "petty_cash_id": "20260325PCD00000001",
    "petty_cash_type_lv": "12",
    "approve_dt": "2026-03-25",
    "send_doc_dt": null,
    "receive_dt": null,
    "approve_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "approve_flag": "12"
  }
}

Response Fields

Field	Type	Nullable	Description
`petty_cash_id`	string	No	รหัสเอกสาร
`petty_cash_type_lv`	string	No	สถานะใหม่ของเอกสาร
`approve_dt`	string	No	วันที่อนุมัติ
`send_doc_dt`	string	Yes	วันที่ส่งเอกสาร
`receive_dt`	string	Yes	วันที่รับเงิน
`approve_id`	string	No	ID ผู้อนุมัติ
`approve_flag`	string	No	สถานะการอนุมัติ

Error Response


{
  "code": 401,
  "message": "ผู้อนุมัติไม่มีสิทธิ์ในเอกสารฉบับนี้"
}


{
  "code": 400,
  "message": "เอกสารอยู่ในสถานะที่ไม่สามารถเปลี่ยนเป็นสถานะที่ระบุได้"
}

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/approve" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "petty_cash_id": "MjAyNjAzMjVQQ0QwMDAwMDAwMQ==",
    "petty_cash_type_lv": "12",
    "authorize_line": "true",
    "approve_dt": "2026-03-25",
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "approve_remark": "เบิกจ่ายได้ตามปกติ",
    "signature_id": "U2lnbmF0dXJlXzEyMw=="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/approve',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      petty_cash_id: 'MjAyNjAzMjVQQ0QwMDAwMDAwMQ==',
      petty_cash_type_lv: '12',
      authorize_line: 'true',
      approve_dt: '2026-03-25',
      authorize_id: 'MjAyNTAzMDM1MUIwQTJDQ0JEOUM=',
      approve_remark: 'เบิกจ่ายได้ตามปกติ',
      signature_id: 'U2lnbmF0dXJlXzEyMw=='
    })
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/approve"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
payload = {
    "petty_cash_id": "MjAyNjAzMjVQQ0QwMDAwMDAwMQ==",
    "petty_cash_type_lv": "12",
    "authorize_line": "true",
    "approve_dt": "2026-03-25",
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "approve_remark": "เบิกจ่ายได้ตามปกติ",
    "signature_id": "U2lnbmF0dXJlXzEyMw=="
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/approve";
$headers = [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
$data = [
    "petty_cash_id" => "MjAyNjAzMjVQQ0QwMDAwMDAwMQ==",
    "petty_cash_type_lv" => "12",
    "authorize_line" => "true",
    "approve_dt" => "2026-03-25",
    "authorize_id" => "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "approve_remark" => "เบิกจ่ายได้ตามปกติ",
    "signature_id" => "U2lnbmF0dXJlXzEyMw=="
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
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

ระบบจะบันทึกประวัติผู้อนุมัติลงในระบบอัตโนมัติ หากเป็นสถานะ 12 (Approved) จะถือว่าคำขอนี้เสร็จสมบูรณ์และพร้อมสำหรับการตั้งเบิกหรือจ่ายเงิน

พารามิเตอร์ petty_cash_id, signature_id และ authorize_id ต้องส่งเป็น Base64-encoded

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