Add Employee Family
เพิ่มข้อมูลสมาชิกในครอบครัวของพนักงาน
Endpoint
POST /api/v1/open-apis/employee/add-employee-profile?path_action=familyQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น family |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
relation_type | string | Yes | รหัสประเภทความสัมพันธ์ (ดูตาราง relation_type ด้านล่าง) |
family_title_lv | string | Yes | คำนำหน้าชื่อ (ดูตาราง family_title_lv ด้านล่าง) |
family_name | string | Yes | ชื่อ |
family_last_name | string | Yes | นามสกุล |
family_id_no | string | No | เลขบัตรประชาชน (ระบบจะลบ - อัตโนมัติ) |
family_birthday | string | No | วันเกิด (YYYY-MM-DD) |
family_mobile | string | No | เบอร์โทรศัพท์ (ระบบจะลบ - อัตโนมัติ) |
family_email | string | No | อีเมล |
family_address | string | No | ที่อยู่ |
relation_type Values
| Value | Description (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
| Value | Description (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
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
relation_type | ต้องระบุ ถ้าไม่ใช่ 04 (บุตร) จะตรวจสอบว่าซ้ำกับรายการเดิมหรือไม่ |
family_title_lv | ต้องระบุ |
family_name | ต้องระบุและต้องไม่เป็นค่าว่าง |
family_last_name | ต้องระบุและต้องไม่เป็นค่าว่าง |
Code Examples
cURL
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)
Related APIs
- List Family Members - ดึงรายการข้อมูลครอบครัวทั้งหมด
- Get Family - ดึงข้อมูลครอบครัวตาม ID
- Update Family - แก้ไขข้อมูลครอบครัว
- Delete Family - ลบข้อมูลครอบครัว
Last updated on