Delete Petty Cash

API สำหรับลบเอกสารคำขอเบิกเงินสดย่อย ระบบจะไม่อนุญาตให้ลบเอกสารที่อยู่ในสถานะ 02 (กำลังตั้งเบิก) ส่วนเอกสารในสถานะอื่นสามารถลบได้

การลบเอกสารไม่สามารถกู้คืนได้ เอกสารที่ลบแล้วจะไม่แสดงในผลลัพธ์ของ Get List และ Search List อีก

Endpoint


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

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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`petty_cash_id`	string	Yes	รหัสเอกสารเบิกเงินสดย่อยที่ต้องการลบ (Base64)	`"MjAyNTExMjdENDU3M0M0MjE2Mzk="`

Optional Parameters

Parameter	Type	Required	Description	Example
`lang`	string	No	ภาษาของข้อความตอบกลับ: `TH` (ค่าเริ่มต้น) หรือ `EN`	`"EN"`

Response Format

Success Response


{
  "code": 200,
  "message": "ลบเอกสารเงินสดย่อยสำเร็จ",
  "payload": {
    "petty_cash_id": "20251127D4573C421639",
    "petty_cash_type_lv": "01",
    "request_topic": "เบิกค่าเดินทางไปพบลูกค้า",
    "employee_id": "20250115B4C5D6E7F8A9",
    "employee_name": "นายสมชาย ใจดี",
    "req_dt": "2025-11-27",
    "approve_dt": null,
    "send_doc_dt": null,
    "receive_dt": null,
    "approve_id": "2025030351B0A2CCBD9C"
  }
}

Response Fields

payload คือข้อมูลของเอกสาร ณ ก่อนถูกลบ

Field	Type	Nullable	Description
`petty_cash_id`	string	No	รหัสเอกสารที่ถูกลบ
`petty_cash_type_lv`	string	No	สถานะของเอกสารก่อนถูกลบ (ดูความหมายใน Overview)
`request_topic`	string	No	หัวข้อการเบิก
`employee_id`	string	No	ID ของพนักงานเจ้าของเอกสาร
`employee_name`	string	No	ชื่อพนักงานเจ้าของเอกสาร
`req_dt`	string	No	วันที่ยื่นคำขอ (YYYY-MM-DD)
`approve_dt`	string	Yes	วันที่พิจารณาเอกสารครั้งล่าสุด (YYYY-MM-DD) — บันทึกเมื่อดำเนินการผ่าน Approve หรือเมื่อ Update Status เปลี่ยนเป็น `02`/`03`
`send_doc_dt`	string	Yes	วันที่ตั้งเบิก (YYYY-MM-DD) — บันทึกเมื่อเอกสารเปลี่ยนเป็น `04` ผ่าน Update Status หรือเมื่อ Approve เปลี่ยนเอกสาร `02` เป็น `04`
`receive_dt`	string	Yes	วันที่รับเงิน (YYYY-MM-DD) — บันทึกเมื่อเอกสารเปลี่ยนเป็น `05` ผ่าน Update Status
`approve_id`	string	Yes	ID ของผู้ใช้ที่ทำรายการกับเอกสารล่าสุด

Error Response

ข้อมูลไม่ผ่านการตรวจสอบ (422)


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

เอกสารอยู่ในสถานะที่ลบไม่ได้ (422) — กรณีนี้ errors เป็น object


{
  "code": 422,
  "message": "การตรวจสอบข้อมูลล้มเหลว",
  "errors": {
    "petty_cash_type_lv": "cannot delete an approved petty cash document"
  }
}

ไม่พบเอกสาร (404)


{
  "code": 404,
  "message": "ไม่พบรายการ"
}

HTTP Status	Description
`400`	ลบไม่สำเร็จ (`เกิดข้อผิดพลาดของระบบ`)
`403`	API Key ไม่มีสิทธิ์ `document:manage`
`404`	ไม่พบเอกสารตาม `petty_cash_id` หรือเอกสารถูกลบไปแล้ว
`422`	ไม่ได้ส่ง `petty_cash_id` หรือเอกสารอยู่ในสถานะ `02`

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/delete" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "petty_cash_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/delete',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      petty_cash_id: 'MjAyNTExMjdENDU3M0M0MjE2Mzk='
    })
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/delete"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
payload = {
    "petty_cash_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
}
 
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/delete";
$headers = [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
$data = [
    "petty_cash_id" => "MjAyNTExMjdENDU3M0M0MjE2Mzk="
];
 
$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

ระบบตรวจสอบสถานะเฉพาะ 02 เท่านั้น เอกสารในสถานะอื่น เช่น 04, 05 หรือ 12 จะถูกลบได้ ควรตรวจสอบสถานะเอกสารผ่าน Get Detail ก่อนลบ
การลบเอกสารสถานะ 12 (บันทึกเข้างวดเงินเดือนแล้ว) ไม่ได้นำยอดออกจากงวดเงินเดือน ควรหลีกเลี่ยงการลบเอกสารในสถานะนี้
เอกสารที่ลบแล้วจะไม่แสดงใน Get List และ Get List Search แต่ยังเรียกดูผ่าน Get Detail ได้
ข้อความ message เป็นภาษาตาม parameter lang (ค่าเริ่มต้น TH) — API นี้ไม่ได้ใช้ language_code

พารามิเตอร์ petty_cash_id ต้องส่งเป็น Base64-encoded

ระบบจะบันทึก ประวัติการลบเอกสาร ให้อัตโนมัติ และนำฟีดแจ้งเตือนของเอกสารนี้ออกทั้งฝั่งพนักงานและ HR

Delete Item - ลบเฉพาะรายการค่าใช้จ่ายในเอกสาร
Get Detail - ดูรายละเอียดเอกสาร
Submit - สร้างเอกสารคำขอเบิกเงินสดย่อย