Create Petty Cash Type
API สำหรับเพิ่มหมวดหมู่หรือประเภทการเบิกเงินสดย่อยใหม่เข้าสู่ระบบขององค์กร ประเภทที่สร้างขึ้นใหม่จะปรากฏในผลลัพธ์ของ API List Types ทันที
Endpoint
POST /api/v1/open-apis/petty-cash/submit-typeสิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)
Request Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
petty_cash_type_name | string | Yes* | ชื่อประเภท (ภาษาไทย) (*ต้องระบุอย่างน้อย 1 ใน petty_cash_type_name หรือ petty_cash_type_name_en) | "ค่าที่พัก" |
petty_cash_type_name_en | string | Yes* | ชื่อประเภท (ภาษาอังกฤษ) (*ต้องระบุอย่างน้อย 1 ใน petty_cash_type_name หรือ petty_cash_type_name_en) | "Accommodation" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
enable_flag | string | No | สถานะการใช้งาน: Y = เปิดใช้งาน, N = ปิดใช้งาน | "Y" |
lang | string | No | ภาษาของข้อความตอบกลับ: TH (ค่าเริ่มต้น) หรือ EN | "EN" |
Response Format
Success Response
{
"code": 200,
"message": "สร้างประเภทเงินสดย่อยสำเร็จ",
"payload": {
"petty_cash_type_name": "ค่าที่พัก",
"petty_cash_type_name_en": "Accommodation",
"petty_cash_type_code": "00003",
"petty_cash_type_id": "20260305B7C8D9E0F1A2"
}
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
petty_cash_type_id | string | No | รหัสประเภทที่สร้างขึ้นใหม่ |
petty_cash_type_name | string | No | ชื่อประเภท (ภาษาไทย) ตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง |
petty_cash_type_name_en | string | No | ชื่อประเภท (ภาษาอังกฤษ) ตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง |
petty_cash_type_code | string | No | รหัสประเภท 5 หลักที่ระบบกำหนดให้อัตโนมัติ |
enable_flag | string | No | สถานะการใช้งานตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง |
Error Response
ข้อมูลไม่ผ่านการตรวจสอบ (422)
{
"code": 422,
"message": "การตรวจสอบข้อมูลล้มเหลว",
"errors": ["At least one of 'petty_cash_type_name' or 'petty_cash_type_name_en' is required"]
}| HTTP Status | Description |
|---|---|
400 | สร้างประเภทไม่สำเร็จ |
403 | API Key ไม่มีสิทธิ์ document:manage |
422 | ไม่ได้ส่งชื่อประเภททั้งภาษาไทยและภาษาอังกฤษ |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/petty-cash/submit-type" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"petty_cash_type_name": "ค่าที่พัก",
"petty_cash_type_name_en": "Accommodation"
}'Notes
แนะนำให้ระบุชื่อภาษาอังกฤษ (petty_cash_type_name_en) เพื่อรองรับผู้ใช้งานหลากหลายภาษา
- ระบบกำหนด
petty_cash_type_codeเป็นเลขลำดับ 5 หลัก (เช่น00003) ที่ไม่ซ้ำกับรหัสเดิมขององค์กรให้อัตโนมัติ - ระบบไม่ได้ตรวจสอบชื่อประเภทซ้ำ
- ข้อความ
messageเป็นภาษาตาม parameterlang(ค่าเริ่มต้น TH) ไม่ได้ใช้language_code
Related APIs
- List Types - ดูรายการประเภทค่าใช้จ่าย
- Update Type - แก้ไขประเภทค่าใช้จ่าย
- Delete Type - ลบประเภทค่าใช้จ่าย
Last updated on