Submit Petty Cash Request

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

Endpoint


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

Request Body

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการสร้างเอกสาร	`"EMP001"`
`request_topic`	string	Yes	หัวข้อหรือชื่อภารกิจการเบิก	`"เบิกค่าที่พักออกตรวจงานต่างจังหวัด"`
`req_dt`	string	Yes	วันที่ยื่นคำขอ (YYYY-MM-DD)	`"2026-03-25"`
`authorize_id`	string (base64)	Yes	ID ของผู้ใช้ที่ทำรายการ (Base64 encoded)	`"MjAyNTAzMDM..."`

Response Format

Success Response


{
  "code": 200,
  "message": "บันทึกข้อมูลสำเร็จ",
  "payload": {
    "req_dt": "2026-03-25",
    "employee_id": "20260309462FEF65EFCA",
    "employee_name": "สมชาย ใจดี",
    "position_name": "IT Support",
    "company_name": "HumanSoft Co., Ltd.",
    "request_topic": "เบิกค่าเดินทางไปพบลูกค้า",
    "document_flow_lv": "01",
    "petty_cash_type_lv": "01",
    "approve_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "approve_upd": "2026-03-25 11:45:00",
    "petty_cash_id": "20260325PCD00000001"
  }
}

Response Fields

Field	Type	Nullable	Description
`petty_cash_id`	string	No	รหัสเอกสารเบิกเงินสดย่อยที่ถูกสร้างขึ้น
`employee_id`	string	No	ID ของพนักงาน
`employee_name`	string	No	ชื่อพนักงาน
`position_name`	string	No	ตำแหน่งพนักงาน
`company_name`	string	No	ชื่อบริษัท
`request_topic`	string	No	หัวข้อการเบิกที่บันทึกไว้
`petty_cash_type_lv`	string	No	สถานะเอกสาร (`01` = Pending)
`req_dt`	string	No	วันที่ยื่นคำขอ

Error Response


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


{
  "code": 400,
  "message": "จำนวนเอกสารเกินโควตาที่กำหนดในรอบเดือนนี้"
}

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/submit" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "request_topic": "เบิกค่าเดินทางไปพบลูกค้า",
    "req_dt": "2026-03-25",
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/submit',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      request_topic: 'เบิกค่าเดินทางไปพบลูกค้า',
      req_dt: '2026-03-25',
      authorize_id: 'MjAyNTAzMDM1MUIwQTJDQ0JEOUM='
    })
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/submit"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
payload = {
    "employee_code": "EMP001",
    "request_topic": "เบิกค่าเดินทางไปพบลูกค้า",
    "req_dt": "2026-03-25",
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM="
}
 
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/submit";
$headers = [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
$data = [
    "employee_code" => "EMP001",
    "request_topic" => "เบิกค่าเดินทางไปพบลูกค้า",
    "req_dt" => "2026-03-25",
    "authorize_id" => "MjAyNTAzMDM1MUIwQTJDQ0JEOUM="
];
 
$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

เมื่อสร้างเอกสารด้วย API นี้แล้ว เอกสารจะยังไม่มีมูลค่าเงินรวม ต้องเรียก API Add Item เพื่อเพิ่มรายการค่าใช้จ่าย

ค่า req_dt สัมพันธ์กับรอบโควตา Petty Cash หากบริษัทมีการจำกัดจำนวนครั้งในการเบิก หากพนักงานเบิกเกินจำนวนครั้งที่กำหนดในรอบเดือน ระบบจะไม่อนุญาตให้สร้างเอกสาร

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded

Add Item - เพิ่มรายการค่าใช้จ่ายเข้าไปในเอกสาร
Get List - ตรวจสอบรายการเอกสารทั้งหมดของพนักงาน
Get Detail - ดูรายละเอียดเอกสาร