Get Employee Tooltip

ดึงรายการแจ้งเตือน/คำแนะนำของพนักงาน สำหรับแสดงคำแนะนำในหน้า Time Table เช่น ลงเวลาไม่ครบคู่ ขาดงาน ทำงานล่วงเวลา

Endpoint


GET /api/v1/open-apis/salary/get-data-filter?path_action=get_list_employee_tooltip

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`year_month`	string	Yes	เดือนที่ต้องการดู (YYYY-MM)	`"2026-02"`
`date`	string	No	กรองเฉพาะวันที่ระบุ (YYYY-MM-DD)	`"2026-02-18"`
`tooltip_type_lv`	string	No	กรองตามประเภท tooltip	`"02"`
`get_all_tooltip_status`	string	No	ดึงทุกสถานะ: `"Y"` = รวมที่ปิดแล้ว, `"N"` = เฉพาะที่ยังเปิด (ค่าเริ่มต้น: `"N"`)	`"Y"`

Code	Description (TH)	Description (EN)
`01`	วันทำงาน ไม่มาทำงาน	Working date not coming to work
`02`	ลงเวลาไม่ครบคู่	Time not couple
`03`	ชั่วโมงการทำงานขาดมากกว่า 1 ชั่วโมง	Lost more than an hour
`04`	เข้างานก่อนเวลาการทำงานมากกว่าครึ่งชั่วโมง	Get to work more than half an hour earlier
`05`	ออกงานหลังเวลาการทำงานมากกว่าครึ่งชั่วโมง	Leave work after more than half an hour
`06`	มาทำงานในวันหยุด	Work in holiday
`07`	แจ้งเตือนลงเวลาการทำงาน	Alert time attendance
`08`	แจ้งเตือนอนุมัติเอกสาร	Alert approve documents

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "2026-02-18": [
      {
        "employee_id": "202503219741427917A0",
        "tooltip_id": "20260218TT001",
        "tooltip_name": "ลงเวลาไม่ครบคู่",
        "tooltip_name_en": "Incomplete Time Attendance",
        "tooltip_staus_flag_lv": "N",
        "tooltip_type_lv": "02",
        "tooltip_parameter": [
          {
            "action": "TimeAdjust",
            "bgcolor": "#FF9800",
            "color": "#FFFFFF",
            "name": "ปรับแก้เวลา",
            "parameter": {
              "work_date": "2026-02-18",
              "employee_code": "EMP001",
              "tooltip_action_id": "TA001"
            }
          }
        ]
      }
    ],
    "2026-02-19": [
      {
        "employee_id": "202503219741427917A0",
        "tooltip_id": "20260219TT002",
        "tooltip_name": "วันทำงาน ไม่มาทำงาน",
        "tooltip_name_en": "Working date not coming to work",
        "tooltip_staus_flag_lv": "N",
        "tooltip_type_lv": "01",
        "tooltip_parameter": [
          {
            "action": "TimeLeave",
            "bgcolor": "#2196F3",
            "color": "#FFFFFF",
            "name": "ขอลา",
            "parameter": {
              "work_date": "2026-02-19",
              "employee_code": "EMP001",
              "tooltip_action_id": "TA002"
            }
          },
          {
            "action": "HolidayChange",
            "bgcolor": "#4CAF50",
            "color": "#FFFFFF",
            "name": "เปลี่ยนวันหยุด",
            "parameter": {
              "work_date": "2026-02-19",
              "employee_code": "EMP001",
              "tooltip_action_id": "TA003"
            }
          },
          {
            "action": "TimeAdjust",
            "bgcolor": "#FF9800",
            "color": "#FFFFFF",
            "name": "ปรับแก้เวลา",
            "parameter": {
              "work_date": "2026-02-19",
              "employee_code": "EMP001",
              "tooltip_action_id": "TA004"
            }
          }
        ]
      }
    ]
  }
}

Field	Type	Description
`employee_id`	string	รหัสพนักงาน (internal)
`tooltip_id`	string	รหัส tooltip (unique)
`tooltip_name`	string	ชื่อ tooltip (ภาษาไทย)
`tooltip_name_en`	string	ชื่อ tooltip (ภาษาอังกฤษ)
`tooltip_staus_flag_lv`	string	สถานะ: `"N"` = active, `"Y"` = closed
`tooltip_type_lv`	string	ประเภท tooltip
`tooltip_parameter`	array	รายการ action ที่แนะนำ

Field	Type	Description
`action`	string	ประเภท action: `"TimeAdjust"`, `"TimeLeave"`, `"OT"`, `"HolidayChange"`
`bgcolor`	string	สีพื้นหลังปุ่ม (hex color)
`color`	string	สีตัวอักษร (hex color)
`name`	string	ชื่อปุ่ม action
`parameter`	object	ข้อมูลสำหรับเรียก action

Empty Result

เมื่อไม่พบ tooltip จะส่งคืน payload เป็น object ว่าง:


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {}
}

Error Response


{
  "code": 400,
  "message": "ValidationException: employee_code is required",
  "payload": {}
}

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`404`	ไม่พบพนักงาน
`429`	เกิน Rate Limit

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_list_employee_tooltip&employee_code=EMP001&year_month=2026-02" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_list_employee_tooltip',
  employee_code: 'EMP001',
  year_month: '2026-02'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
for (const [date, tooltips] of Object.entries(data.payload)) {
  tooltips.forEach(t => {
    console.log(`${date} - ${t.tooltip_name} (${t.tooltip_type_lv})`)
    t.tooltip_parameter.forEach(p => {
      console.log(`  Action: ${p.action} - ${p.name}`)
    })
  })
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "get_list_employee_tooltip",
    "employee_code": "EMP001",
    "year_month": "2026-02"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for date, tooltips in data["payload"].items():
    for t in tooltips:
        print(f"{date} - {t['tooltip_name']} ({t['tooltip_type_lv']})")
        for p in t["tooltip_parameter"]:
            print(f"  Action: {p['action']} - {p['name']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_list_employee_tooltip",
    "employee_code" => "EMP001",
    "year_month" => "2026-02"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
foreach ($data["payload"] as $date => $tooltips) {
    foreach ($tooltips as $t) {
        echo "{$date} - {$t['tooltip_name']} ({$t['tooltip_type_lv']})\n";
        foreach ($t["tooltip_parameter"] as $p) {
            echo "  Action: {$p['action']} - {$p['name']}\n";
        }
    }
}
?>

Notes

Response เป็น object ที่ key คือวันที่ (YYYY-MM-DD) ไม่ใช่ array
Tooltip ที่ปิดแล้ว (tooltip_staus_flag_lv = "Y") จะไม่แสดง เว้นแต่ระบุ get_all_tooltip_status=Y
ระบบจะสร้าง tooltip อัตโนมัติเมื่อพบความผิดปกติในการลงเวลา
Tooltip จะถูกปิดอัตโนมัติเมื่อพนักงานแก้ไขข้อมูลแล้ว

Daily Info - ดูรายละเอียดการทำงานรายวัน
Daily In Month - ดูตารางเวลาทำงานภาพรวมทั้งเดือน
Current Month - ดูรอบเดือนปัจจุบัน

Get Employee Tooltip

Endpoint

Request Parameters

tooltip_type_lv Values

Response Format

Success Response

Key Response Fields - Tooltip

Key Response Fields - tooltip_parameter[]

Empty Result

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Get Employee Tooltip

Endpoint

Request Parameters

tooltip_type_lv Values

Response Format

Success Response

Key Response Fields - Tooltip

Key Response Fields - tooltip_parameter[]

Empty Result

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs