Update Petty Cash Type

API สำหรับแก้ไขชื่อประเภทเงินสดย่อย (ทั้งภาษาไทยและภาษาอังกฤษ) หรือปรับเปลี่ยนสถานะการใช้งานของหมวดหมู่เดิม ต้องส่งอย่างน้อย 1 ฟิลด์จาก petty_cash_type_name, petty_cash_type_name_en, enable_flag — ฟิลด์ที่ไม่ได้ส่งระบบจะคงค่าเดิมไว้

Endpoint


POST /api/v1/open-apis/petty-cash/update-type

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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`petty_cash_type_id`	string	Yes	ID ของประเภทที่ต้องการแก้ไข (Base64) ดูได้จาก API List Types	`"MjAyNjAzMDNBMUIyQzNENEU1RjY="`

Optional Parameters

Parameter	Type	Required	Description	Example
`petty_cash_type_name`	string	No	ชื่อประเภท (ภาษาไทย)	`"ค่าเดินทาง (ปรับปรุง)"`
`petty_cash_type_name_en`	string	No	ชื่อประเภท (ภาษาอังกฤษ)	`"Travel (Revised)"`
`enable_flag`	string	No	สถานะการใช้งาน: `Y` = เปิดใช้งาน, `N` = ปิดใช้งาน — ระบบไม่ได้ตรวจค่า ควรส่ง `Y` หรือ `N` เท่านั้น	`"N"`
`lang`	string	No	ภาษาของข้อความตอบกลับ: `TH` (ค่าเริ่มต้น) หรือ `EN`	`"EN"`

Response Format

Success Response


{
  "code": 200,
  "message": "แก้ไขประเภทเงินสดย่อยสำเร็จ",
  "payload": {
    "petty_cash_type_id": "20260303A1B2C3D4E5F6",
    "petty_cash_type_name": "ค่าเดินทาง (ปรับปรุง)",
    "petty_cash_type_name_en": "Travel Expense",
    "petty_cash_type_code": "00002",
    "enable_flag": "Y"
  }
}

Response Fields

payload คือข้อมูลของประเภทหลังแก้ไข

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

Error Response

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


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

ไม่พบประเภท (404)

ระบบตรวจก่อนแก้ไข หากไม่พบประเภท ข้อมูลจะไม่ถูกเปลี่ยนแปลง


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

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

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/update-type" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "petty_cash_type_id": "MjAyNjAzMDNBMUIyQzNENEU1RjY=",
    "petty_cash_type_name": "ค่าเดินทาง (ปรับปรุง)",
    "enable_flag": "Y"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/update-type',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      petty_cash_type_id: 'MjAyNjAzMDNBMUIyQzNENEU1RjY=',
      petty_cash_type_name: 'ค่าเดินทาง (ปรับปรุง)',
      enable_flag: 'Y'
    })
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/update-type"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
payload = {
    "petty_cash_type_id": "MjAyNjAzMDNBMUIyQzNENEU1RjY=",
    "petty_cash_type_name": "ค่าเดินทาง (ปรับปรุง)",
    "enable_flag": "Y"
}
 
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/update-type";
$headers = [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
$data = [
    "petty_cash_type_id" => "MjAyNjAzMDNBMUIyQzNENEU1RjY=",
    "petty_cash_type_name" => "ค่าเดินทาง (ปรับปรุง)",
    "enable_flag" => "Y"
];
 
$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

ส่งเฉพาะฟิลด์ที่ต้องการแก้ไข — ฟิลด์ที่ไม่ได้ส่งมาจะคงค่าเดิมไว้ ส่วนฟิลด์ที่ส่งเป็นค่าว่าง ("") จะถูกบันทึกเป็นค่าว่าง
ระบบแก้ไขเฉพาะ petty_cash_type_name, petty_cash_type_name_en และ enable_flag — parameter อื่นที่ส่งมาจะถูกละเว้น
ชื่อประเภทที่แก้ไขจะแสดงในเอกสารเดิมที่ใช้ประเภทนี้ด้วย เพราะ Get Detail แสดงชื่อประเภทตามข้อมูลปัจจุบัน
ข้อความ message เป็นภาษาตาม parameter lang (ค่าเริ่มต้น TH) — API นี้ไม่ได้ใช้ language_code

พารามิเตอร์ petty_cash_type_id ต้องส่งเป็น Base64-encoded — ค่าที่ได้จาก List Types เป็น raw ต้อง encode ก่อนส่ง

List Types - ดูรายการประเภทค่าใช้จ่าย
Create Type - สร้างประเภทค่าใช้จ่ายใหม่
Delete Type - ลบประเภทค่าใช้จ่าย