เพิ่ม field เเละปรับ logic สำหรับ /contacts APIs

เพิ่ม field ข้อมูลธนาคารใน Contact API และปรับปรุง Logic ของ contactBranchCode และ contactBranch

FlowAccount OpenAPI ได้เพิ่มฟิลด์ใหม่สำหรับข้อมูลธนาคารของผู้ติดต่อ เพื่อให้ข้อมูลผู้ติดต่อครบถ้วน พร้อมทั้งปรับปรุงวิธีการกำหนดค่า contactBranchCode และ contactBranch เพื่อให้การบันทึกข้อมูลผู้ติดต่อถูกต้องและสอดคล้องกัน

เริ่มมีผลบน Production Environment: 25/02/2026

รายละเอียดการเปลี่ยนแปลง

1. เพิ่ม field contactBankAccountName และ contactBankBranchCode ใน Contact API

เพิ่ม field ใหม่ 2 รายการใน request payload ของ Contact API สำหรับการสร้างและอัปเดตข้อมูลผู้ติดต่อ เพื่อให้รองรับข้อมูลบัญชีธนาคารได้ครบถ้วนยิ่งขึ้น:

Field	ประเภท	คำอธิบาย
contactBankAccountName	string	ชื่อบัญชีธนาคารของผู้ติดต่อ
contactBankBranchCode	string	รหัสสาขาธนาคาร

วิธีการใช้งาน

ระบุ field ใหม่ใน payload สำหรับสร้างหรือแก้ไขข้อมูลผู้ติดต่อ:

{
  "contactName": "บริษัท ตัวอย่าง จำกัด",
  "contactBankId": 2,
  "contactBankAccountNumber": "0123456789",
  "contactBankBranch": "สีลม",
  "contactBankBranchCode": "1234",
  "contactBankAccountName": "บริษัท ตัวอย่าง จำกัด",
  "contactBankAccountType": 1
}

เงื่อนไขการใช้งานข้อมูลบัญชีธนาคาร

ก่อนหน้านี้ OpenAPI ไม่มีการตรวจสอบข้อมูลบัญชีธนาคาร (bank account validation) ทำให้อาจมีกรณีที่มีการบันทึกข้อมูลไม่ถูกต้อง ระบบ FlowAccount OpenAPI จึงมีการเพิ่มเงื่อนไขในการสร้างหรือแก้ไขข้อมูลบัญชีธนาคาร โดยมีเงื่อนไข ดังนี้

• bank fields ทั้งหมด — ต้องกรอกครบทุก field หรือไม่กรอกเลย (กรอกบางส่วนไม่ได้)
  • contactBankId
  • contactBankAccountNumber
  • contactBankBranch
  • contactBankAccountName
• contactBankAccountName — ความยาวสูงสุด 100 ตัวอักษร, รองรับเฉพาะตัวอักษรไทย/อังกฤษ, ตัวเลข, . , (), ห้ามมีสัญลักษณ์ ฿ หรือ ฺ
• contactBankAccountNumber — ความยาวสูงสุด 20 ตัวอักษร
• contactBankBranch — ความยาวสูงสุด 100 ตัวอักษร
• contactBankBranchCode — ตัวเลขเท่านั้น, ความยาว 4 ตัวอักษรพอดี

Error Codes:

Error Code	Error Message	Cause
80004	ContactBankAccountBadRequest	กรอกข้อมูลธนาคารไม่ครบทุก field หรือกรอกบางส่วน
80005	ContactBankAccountAccountNameInvalid	ชื่อบัญชีไม่ถูกต้อง (ยาวเกินที่กำหนด / มีอักขระที่ไม่อนุญาต)
80006	ContactBankAccountBranchCodeInvalid	รหัสสาขาธนาคารต้องเป็นตัวเลข 4 หลักพอดี
80007	ContactBankAccountBranchNameInvalid	ชื่อสาขาธนาคารยาวเกิน 100 ตัวอักษร
80008	ContactBankAccountAccountNumberInvalid	เลขที่บัญชียาวเกิน 20 ตัวอักษร

---

2. ปรับค่า contactBranchCode อัตโนมัติเมื่อ contactBranch ถูกระบุเป็น "สำนักงานใหญ่"

ปรับปรุง Logic การจัดการ contactBranchCode ใน Contact API เมื่อ contactBranch มีค่าเป็น "สำนักงานใหญ่" ระบบจะปรับค่า contactBranchCode ให้เป็นค่าว่างโดยอัตโนมัติ

ตัวอย่างการทำงาน

input contactBranch	input contactBranchCode	ผลลัพธ์
"สำนักงานใหญ่"	"0000"	"contactBranchCode": "" "contactBranch": "สำนักงานใหญ่"
"สำนักงานใหญ่"	null	"contactBranchCode": "" "contactBranch": "สำนักงานใหญ่"
"สาขา 1"	"0001"	"contactBranchCode": "0001" "contactBranch": "สาขา 1"
null	"0001"	"contactBranchCode": "0001" "contactBranch": ""
""	"0001"	"contactBranchCode": "0001" "contactBranch": ""

APIs ที่ได้รับผลกระทบ

• POST /contacts
• PUT /contacts/{id}