List Petty Cash Types

API สำหรับเรียกดูข้อมูลหมวดหมู่การเบิกเงินสดย่อยที่องค์กรกำหนดไว้ (เช่น ค่าเดินทาง, ค่าอุปกรณ์สำนักงาน, ค่าน้ำมัน) เพื่อนำรหัสประเภท (petty_cash_type_id) ไปใช้ในการเพิ่มรายการค่าใช้จ่ายผ่าน API Add Item

Endpoint


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

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

Request Parameters

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes	ID ของผู้ใช้ที่ทำรายการ (Base64)	`"MjAyNTAzMDM1MUIwQTJDQ0JEOUM="`
`enable_flag`	string	No	กรองตามสถานะการใช้งาน: `Y` = เปิดใช้งาน, `N` = ปิดใช้งาน — หากไม่ส่ง จะได้ทุกประเภททั้งที่เปิดและปิดใช้งาน	`"Y"`
`lang`	string	No	ภาษาของข้อความตอบกลับ: `TH` (ค่าเริ่มต้น) หรือ `EN`	`"EN"`

Response Format

Success Response


{
  "code": 200,
  "message": "ดึงรายการประเภทเงินสดย่อยสำเร็จ",
  "payload": [
    {
      "petty_cash_type_id": "20260301C3D4E5F6A1B2",
      "petty_cash_type_code": "00001",
      "petty_cash_type_name": "อื่นๆ",
      "petty_cash_type_name_en": "Other",
      "enable_flag": "Y"
    },
    {
      "petty_cash_type_id": "20260303A1B2C3D4E5F6",
      "petty_cash_type_code": "00002",
      "petty_cash_type_name": "ค่าเดินทาง",
      "petty_cash_type_name_en": "Travel Expense",
      "enable_flag": "Y"
    }
  ]
}

Response Fields

Field	Type	Nullable	Description
`petty_cash_type_id`	string	No	รหัสประเภทค่าใช้จ่าย
`petty_cash_type_code`	string	No	รหัสประเภท 5 หลัก (ผลลัพธ์เรียงตามรหัสนี้)
`petty_cash_type_name`	string	Yes	ชื่อประเภท (ภาษาไทย)
`petty_cash_type_name_en`	string	Yes	ชื่อประเภท (ภาษาอังกฤษ)
`enable_flag`	string	No	สถานะการใช้งาน (`Y` = เปิดใช้งาน, `N` = ปิดใช้งาน)

Error Response

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


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

HTTP Status	Description
`400`	เกิดข้อผิดพลาดระหว่างดึงข้อมูล (`message` เป็น `ล้มเหลว`)
`403`	API Key ไม่มีสิทธิ์ `document:manage`
`422`	ไม่ได้ส่ง `authorize_id`

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  authorize_id: 'MjAyNTAzMDM1MUIwQTJDQ0JEOUM=',
  enable_flag: 'Y'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/list-type?${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/list-type"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "authorize_id": "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "enable_flag": "Y"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()

PHP


<?php
$params = http_build_query([
    "authorize_id" => "MjAyNTAzMDM1MUIwQTJDQ0JEOUM=",
    "enable_flag" => "Y"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/list-type?" . $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

petty_cash_type_id ที่ได้จาก API นี้ เป็นค่าสำคัญที่ต้องนำไปใช้ในการเรียก API Add Item — ต้อง encode เป็น Base64 ก่อนส่ง

ข้อมูลที่ดึงออกมาจะขึ้นอยู่กับการตั้งค่าขององค์กร และไม่รวมประเภทที่ถูกลบแล้ว
หากองค์กรยังไม่เคยมีประเภทรหัส 00001 ระบบจะสร้างประเภท “อื่นๆ” (Other) รหัส 00001 ให้อัตโนมัติเมื่อเรียก API นี้
ข้อความ message เป็นภาษาตาม parameter lang (ค่าเริ่มต้น TH) — API นี้ไม่ได้ใช้ language_code

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

Add Item - เพิ่มรายการค่าใช้จ่ายในเอกสาร
Create Type - สร้างประเภทค่าใช้จ่ายใหม่
Update Type - แก้ไขประเภทค่าใช้จ่าย
Delete Type - ลบประเภทค่าใช้จ่าย