Get Employee Info

ดึงข้อมูลพนักงานรายบุคคลแบบละเอียดครบถ้วน รวมถึงข้อมูลส่วนตัว ข้อมูลองค์กร ข้อมูลการทำงาน ประวัติการศึกษา ครอบครัว และข้อมูลด้านการเงิน

API นี้ดึงข้อมูลครบ 18 หมวด เหมาะสำหรับแสดงหน้ารายละเอียดพนักงาน ถ้าต้องการเฉพาะบางหมวด ใช้ Get Employee Data แทน

Convention ID: พารามิเตอร์ที่ลงท้าย _id (เมื่อส่งใน Request Body) ต้องส่งเป็น Base64-encoded string. Response คืนค่า ID เป็น raw string (ไม่ใช่ Base64) — เมื่อนำไปใช้ใน request อื่นที่รับ *_id ต้อง encode เป็น Base64 ก่อนส่ง

Endpoint


GET /api/v1/open-apis/employee/get-employee-info

Query Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการดึงข้อมูล	`EMP0001`
`identify_user_id`	string	No	User ที่เรียกใช้ (Base64)	`MjAyNDAxMzBFNEFCNzdGMEMxNTI=`
`language_code`	string	No	ภาษา (TH/EN)	`TH`

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "profile": {
      "employee_id": "20260121FC89F3BB9120",
      "employee_code": "EMP0001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_name_en": "Somchai",
      "employee_last_name_en": "Jaidee",
      "employee_gender": "M",
      "employee_gender_name": "ชาย",
      "employee_status": "01",
      "employee_status_name": "ทำงาน",
      "company_id": "20241225C3024958C974",
      "company_name": "บริษัท ABC จำกัด",
      "branch_id": "202412254358646B34E4",
      "branch_name": "สาขากรุงเทพ",
      "department_id": "20241225F520AC8456ED",
      "department_name": "ฝ่ายบริหาร",
      "position_id": "2024122587C216DA2C19",
      "position_name": "ผู้จัดการ",
      "effective_dt": "2024-01-15",
      "work_ages": "2 ปี 0 เดือน 0 วัน",
      "mobilephone": "081-234-5678",
      "emailaddress": "somchai@example.com",
      "photograph": "images/employees/emp0001.jpg",
      "organization": {
        "company": { "label": "บริษัท", "value": "บริษัท ABC จำกัด" },
        "branch": { "label": "สาขา", "value": "สาขากรุงเทพ" },
        "department": { "label": "แผนก", "value": "ฝ่ายบริหาร" }
      }
    },
    "work_lists": [],
    "education_lists": [],
    "ability_lists": [],
    "trainning_lists": [],
    "language_skill_lists": [],
    "typing_skill_lists": [],
    "driving_skill_lists": [],
    "family_lists": [],
    "possess_lists": [],
    "document_lists": [],
    "quota_lists": {},
    "loan_lists": [],
    "constant_lists": [],
    "fund_lists": [],
    "tax_lists": [],
    "work_insurance_lists": [],
    "user_lists": {}
  }
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found with code: EMP9999"
}

Response Fields

1. Profile (ข้อมูลหลัก)

ข้อมูลพื้นฐาน

Field	Type	Description
`employee_id`	string	ID ของพนักงาน
`employee_code`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน (ไทย)
`employee_last_name`	string	นามสกุลพนักงาน (ไทย)
`employee_nickname`	string	ชื่อเล่น (ไทย)
`employee_name_en`	string	ชื่อพนักงาน (อังกฤษ)
`employee_last_name_en`	string	นามสกุลพนักงาน (อังกฤษ)
`employee_nickname_en`	string	ชื่อเล่น (อังกฤษ)
`employee_title_name`	string	คำนำหน้าชื่อ (ไทย)
`employee_title_name_en`	string	คำนำหน้าชื่อ (อังกฤษ)
`employee_gender`	string	เพศ (M=ชาย, F=หญิง)
`employee_gender_name`	string	ชื่อเพศ
`photograph`	string	URL รูปภาพพนักงาน

ข้อมูลองค์กร

Field	Type	Description
`company_id`	string	ID ของบริษัท
`company_name`	string	ชื่อบริษัท
`branch_id`	string	ID ของสาขา
`branch_name`	string	ชื่อสาขา
`department_id`	string	ID ของแผนก
`department_name`	string	ชื่อแผนก
`division_id`	string	ID ของส่วน
`division_name`	string	ชื่อส่วน
`section_id`	string	ID ของงาน
`section_name`	string	ชื่องาน
`position_id`	string	ID ของตำแหน่ง
`position_name`	string	ชื่อตำแหน่ง

ข้อมูลการจ้างงาน

Field	Type	Description
`employee_status`	string	สถานะพนักงาน (01, 02, 03)
`employee_status_name`	string	ชื่อสถานะพนักงาน
`employee_type_code`	string	ประเภทพนักงาน (01-04)
`employee_type_name`	string	ชื่อประเภทพนักงาน
`effective_dt`	date	วันที่เริ่มงาน
`begin_dt`	date	วันที่เริ่มงานจริง
`signout_dt`	date	วันที่ลาออก
`work_ages`	string	อายุงาน

ข้อมูลติดต่อ

Field	Type	Description
`id_no`	string	เลขบัตรประชาชน
`mobilephone`	string	เบอร์โทรศัพท์มือถือ
`emailaddress`	string	อีเมล
`address`	string	ที่อยู่ตามทะเบียนบ้าน
`full_address`	string	ที่อยู่เต็ม
`current_address`	string	ที่อยู่ปัจจุบัน

ข้อมูลธนาคาร

Field	Type	Description
`bank_id`	string	ID ของธนาคาร
`bank_code`	string	รหัสธนาคาร
`bank_name`	string	ชื่อธนาคาร
`bank_account_code`	string	เลขบัญชีธนาคาร
`payment_method`	string	วิธีการจ่ายเงินเดือน

2-18. Data Lists

#	Field	Description
2	`work_lists`	ประสบการณ์การทำงาน
3	`education_lists`	ประวัติการศึกษา
4	`ability_lists`	ความสามารถพิเศษ
5	`trainning_lists`	ประวัติการอบรม
6	`language_skill_lists`	ทักษะภาษา
7	`typing_skill_lists`	ทักษะการพิมพ์
8	`driving_skill_lists`	ทักษะการขับขี่
9	`family_lists`	ข้อมูลครอบครัว
10	`possess_lists`	ทรัพย์สิน
11	`document_lists`	เอกสาร
12	`quota_lists`	โควตาการลา
13	`loan_lists`	เงินกู้
14	`constant_lists`	รายรับ/รายจ่ายคงที่
15	`fund_lists`	กองทุนสำรองเลี้ยงชีพ
16	`tax_lists`	ข้อมูลภาษี
17	`work_insurance_lists`	ประกันสังคม
18	`user_lists`	ข้อมูลบัญชีผู้ใช้งาน

Lists ที่ไม่มีข้อมูลจะเป็น [] (empty array) หรือ {} (empty object)

Family Lists Structure


{
  "family_lists": [
    {
      "employee_family_id": "FAM001",
      "family_title_lv": "01",
      "family_title_name": "นาย",
      "family_name": "สมศักดิ์",
      "family_last_name": "ใจดี",
      "relation_type": "01",
      "relation_type_name": "บิดา",
      "family_birthday": "1960-05-15",
      "family_id_no": "1234567890123",
      "family_mobile": "081-111-2222"
    }
  ]
}

Education Lists Structure


{
  "education_lists": [
    {
      "employee_education_id": "EDU001",
      "education_level": "ปริญญาตรี",
      "education_institution": "มหาวิทยาลัย ABC",
      "education_major": "วิศวกรรมคอมพิวเตอร์",
      "education_gpa": 3.25,
      "education_year": 2020
    }
  ]
}

Fund Lists Structure


{
  "fund_lists": [
    {
      "fund_id": "FUND001",
      "fund_name": "กองทุนสำรองเลี้ยงชีพ",
      "fund_employee_no": "PVD123456",
      "fund_employee_date": "2024-01-15",
      "fund_employee_rate": 5,
      "fund_employee_balance": 50000
    }
  ]
}

User Lists Structure


{
  "user_lists": {
    "user_id": "U123",
    "user_name": "emp0001",
    "usergroup_code": "EMPLOYEE"
  }
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-info?employee_code=EMP0001" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const employeeCode = 'EMP0001'
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-info?employee_code=${employeeCode}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  const { profile, family_lists, education_lists } = data.payload
 
  console.log('Profile:', profile.employee_name, profile.employee_last_name)
  console.log('Family members:', family_lists.length)
  console.log('Education records:', education_lists.length)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-info"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "employee_code": "EMP0001"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
if data['code'] == 200:
    profile = data['payload']['profile']
    print(f"Name: {profile['employee_name']} {profile['employee_last_name']}")
    print(f"Position: {profile['position_name']}")
    print(f"Department: {profile['department_name']}")
 
    # Access lists
    family = data['payload']['family_lists']
    print(f"Family members: {len(family)}")

PHP


<?php
$employeeCode = "EMP0001";
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-info?employee_code=" . $employeeCode;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    $profile = $data['payload']['profile'];
    echo "Name: " . $profile['employee_name'] . " " . $profile['employee_last_name'] . "\n";
    echo "Position: " . $profile['position_name'] . "\n";
 
    $family = $data['payload']['family_lists'];
    echo "Family members: " . count($family) . "\n";
}
 
curl_close($ch);
?>

Notes

Performance Note:

API นี้ดึงข้อมูลครบทุกหมวดและมีการคำนวณข้อมูลหลายส่วน จึงใช้เวลาประมวลผลมากกว่าปกติ
เหมาะสำหรับดึงข้อมูลรายบุคคล
ถ้าต้องการดึงหลายคนพร้อมกัน ใช้ Get Employee List แทน

Photograph Handling

ระบบจะจัดการรูปภาพพนักงานดังนี้:

ถ้ามีรูปภาพ → ส่ง URL ของรูปภาพ
ถ้าไม่มีรูปภาพ → ส่ง images/userPlaceHolder.png

Phone Number Format

เบอร์โทรศัพท์จะถูกจัดรูปแบบเป็น XXX-XXX-XXXX อัตโนมัติ

Data Categories

ข้อมูลพนักงานแบ่งเป็น 18 หมวดหมู่ ดูรายละเอียดที่ Overview

Get Employee List - ดึงรายการพนักงานทั้งหมด
Get Employee Data - ดึงข้อมูลเฉพาะบางหมวด
Update Employee - แก้ไขข้อมูลพนักงาน