Skip to Content
🚀 Welcome to Humansoft Open API Documentation

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

ParameterTypeRequiredDescriptionExample
petty_cash_type_namestringYes*ชื่อประเภท (ภาษาไทย) (*ต้องระบุอย่างน้อย 1 ใน petty_cash_type_name หรือ petty_cash_type_name_en)"ค่าที่พัก"
petty_cash_type_name_enstringYes*ชื่อประเภท (ภาษาอังกฤษ) (*ต้องระบุอย่างน้อย 1 ใน petty_cash_type_name หรือ petty_cash_type_name_en)"Accommodation"

Optional Parameters

ParameterTypeRequiredDescriptionExample
enable_flagstringNoสถานะการใช้งาน: Y = เปิดใช้งาน, N = ปิดใช้งาน"Y"
langstringNoภาษาของข้อความตอบกลับ: 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

FieldTypeNullableDescription
petty_cash_type_idstringNoรหัสประเภทที่สร้างขึ้นใหม่
petty_cash_type_namestringNoชื่อประเภท (ภาษาไทย) ตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง
petty_cash_type_name_enstringNoชื่อประเภท (ภาษาอังกฤษ) ตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง
petty_cash_type_codestringNoรหัสประเภท 5 หลักที่ระบบกำหนดให้อัตโนมัติ
enable_flagstringNoสถานะการใช้งานตามที่ส่งมา — ไม่มีฟิลด์นี้หากไม่ได้ส่ง

Error Response

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

{ "code": 422, "message": "การตรวจสอบข้อมูลล้มเหลว", "errors": ["At least one of 'petty_cash_type_name' or 'petty_cash_type_name_en' is required"] }
HTTP StatusDescription
400สร้างประเภทไม่สำเร็จ
403API Key ไม่มีสิทธิ์ document:manage
422ไม่ได้ส่งชื่อประเภททั้งภาษาไทยและภาษาอังกฤษ

Code Examples

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 เป็นภาษาตาม parameter lang (ค่าเริ่มต้น TH) ไม่ได้ใช้ language_code

  • List Types - ดูรายการประเภทค่าใช้จ่าย
  • Update Type - แก้ไขประเภทค่าใช้จ่าย
  • Delete Type - ลบประเภทค่าใช้จ่าย
Last updated on