Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Family

เพิ่มข้อมูลสมาชิกในครอบครัวของพนักงาน

Endpoint

POST /api/v1/open-apis/employee/add-employee-profile?path_action=family

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น family

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
relation_typestringYesรหัสประเภทความสัมพันธ์ (ดูตาราง relation_type ด้านล่าง)
family_title_lvstringYesคำนำหน้าชื่อ (ดูตาราง family_title_lv ด้านล่าง)
family_namestringYesชื่อ
family_last_namestringYesนามสกุล
family_id_nostringNoเลขบัตรประชาชน (ระบบจะลบ - อัตโนมัติ)
family_birthdaystringNoวันเกิด (YYYY-MM-DD)
family_mobilestringNoเบอร์โทรศัพท์ (ระบบจะลบ - อัตโนมัติ)
family_emailstringNoอีเมล
family_addressstringNoที่อยู่

relation_type Values

ValueDescription (TH)Description (EN)ซ้ำได้
01ภรรยาWifeไม่
02บิดาDadไม่
03มารดาMomไม่
04บุตรChildได้
05ผู้ติดต่อฉุกเฉินAccident Contact Personไม่
06สามีHusbandไม่
07ผู้ค้ำประกันGuarantorไม่
08พี่น้องSiblingsไม่
  • relation_type = 04 (บุตร) สามารถเพิ่มได้หลายคน ประเภทอื่นเพิ่มได้เพียง 1 คน
  • รายการอาจมีเพิ่มเติมได้จากการตั้งค่าในระบบ (list_of_value)

family_title_lv Values

ValueDescription (TH)Description (EN)
01นายMr.
02นางMrs.
03นางสาวMiss
51เด็กชายMaster
52เด็กหญิงMiss (Child)

Response Format

Success Response

{ "code": 200, "message": "Add Family Success", "payload": { "employee_family_id": "20260213A310C7812B2C", "employee_id": "20260121FC89F3BB9120", "employee_code": "EMP001", "relation_type": "04", "family_id_no": "1123456789012", "family_title_lv": "51", "family_name": "สมชาย", "family_last_name": "ใจดี", "family_birthday": "2010-05-15", "family_mobile": "0812345678", "family_email": "somchai@email.com", "family_address": "123/45 ถ.สุขุมวิท กรุงเทพฯ" } }

Error Response

{ "code": 400, "message": "Validation failed", "errors": [ "Missing required parameter: 'employee_code'", "Missing required parameter: 'relation_type'", "Missing required parameter: 'family_title_lv'", "Missing required parameter: 'family_name'", "Missing required parameter: 'family_last_name'" ] }

Validation Rules

FieldRule
employee_codeต้องระบุและต้องมีพนักงานในระบบ
relation_typeต้องระบุ ถ้าไม่ใช่ 04 (บุตร) จะตรวจสอบว่าซ้ำกับรายการเดิมหรือไม่
family_title_lvต้องระบุ
family_nameต้องระบุและต้องไม่เป็นค่าว่าง
family_last_nameต้องระบุและต้องไม่เป็นค่าว่าง

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile?path_action=family" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "relation_type": "04", "family_title_lv": "51", "family_name": "สมชาย", "family_last_name": "ใจดี", "family_id_no": "1-1234-56789-01-2", "family_birthday": "2010-05-15", "family_mobile": "081-234-5678", "family_email": "somchai@email.com", "family_address": "123/45 ถ.สุขุมวิท กรุงเทพฯ" }'

Notes

  • ระบบจะลบ - ออกจาก family_id_no และ family_mobile อัตโนมัติ
  • Endpoint นี้ใช้ employee_code (ไม่ต้อง encode Base64)

  • List Family Members - ดึงรายการข้อมูลครอบครัวทั้งหมด
  • Get Family - ดึงข้อมูลครอบครัวตาม ID
  • Update Family - แก้ไขข้อมูลครอบครัว
  • Delete Family - ลบข้อมูลครอบครัว
Last updated on