Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Time Attendance

เพิ่มรายการบันทึกเวลาทำงานใหม่ รองรับหลายประเภทการลงเวลาและตรวจสอบ duplicate อัตโนมัติ

Endpoint

POST /api/v1/open-apis/salary/add-data-filter?path_action=add_time_attendance

Request Body

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
attendance_datetimestringYesวันเวลาที่บันทึก (YYYY-MM-DD HH:mm:ss)"2026-02-18 09:00:00"
time_attendance_type_lvstringYesประเภทการบันทึก"Checkin"
work_type_lvstringNoรอบการทำงาน: "1" (เช้า), "2" (บ่าย), "0" (ไม่ระบุ)"1"
attendance_inoutstringNoทิศทาง: "IN" (เข้างาน), "OUT" (ออกงาน)"IN"
latitudestringNoละติจูด (GPS)"13.756331"
longitudestringNoลองจิจูด (GPS)"100.501762"
location_idstringNoID สถานที่ (Base64)-
device_snstringNoSerial number ของอุปกรณ์"DEVICE001"
approve_remarkstringNoหมายเหตุ"ลงเวลาแทน"
image_pathstringNoPath รูปภาพที่บันทึก"/uploads/image.jpg"
time_round_auto_fixstringNoแก้ไขรอบเวลาอัตโนมัติ: "Y" / "N""N"
round_month_configstringNoรูปแบบรอบเดือน: "Full" หรือ "Split""Full"
language_codestringNoภาษา: TH หรือ EN"TH"

time_attendance_type_lv Values

ValueDescription (TH)Description (EN)
Beaconเช็คอินผ่านอุปกรณ์ BeaconCheck-in via Beacon Device
Checkinเช็คอินผ่านระบบCheck-in via System
Facialสแกนใบหน้าFacial Recognition
Fingerprintสแกนลายนิ้วมือผ่านเครื่องFingerprint Scanner
Importนำเข้าข้อมูลจากไฟล์Imported from File
LINE-Checkinเช็คอินผ่าน LINECheck-in via LINE
LINE-QRเช็คอินผ่าน QR Code บน LINECheck-in via LINE QR Code
Managerผู้จัดการบันทึกเวลาให้Manager Recorded
Manualบันทึกด้วยมือโดย HR/AdminManual Entry by HR/Admin
Offlineบันทึกขณะออฟไลน์Offline Recording
QRเช็คอินผ่าน QR CodeCheck-in via QR Code
Time Adjustปรับแก้เวลาTime Adjustment
TimeAppบันทึกผ่านแอปพลิเคชันRecorded via Mobile App
Wifiเช็คอินผ่านเครือข่าย Wi-FiCheck-in via Wi-Fi

Response Format

Success Response (attendance_status = 2)

{ "code": 200, "message": "Add Time Attendance Success", "attendance_status": 2, "payload": { "time_attendance_transac_id": "20260128DE896A821F70", "employee_id": "202503219741427917A0", "time_attendance_type_lv": "Checkin", "attendance_date": "2026-02-18", "device_sn": "DEVICE001", "attendance_date": "2026-02-18", "attendance_datetime": "2026-02-18 09:00:00", "attendance_inout": "IN", "image_path": "", "latitude": "13.756331", "longitude": "100.501762", "work_type_lv": "1", "location_id": "20241225C3024958C974", "approve_remark": "" } }

attendance_status Codes

CodeStatusDescription
2Successบันทึกสำเร็จ
3Duplicateมีรายการซ้ำในเวลาเดียวกัน
5No Dataข้อมูลไม่ครบถ้วน
7Finish Monthเดือนปิดแล้ว ไม่สามารถเพิ่มได้
8Not Insertเกิดข้อผิดพลาดในการบันทึก

API จะ return HTTP 200 แม้ว่าจะบันทึกไม่สำเร็จ — ต้องตรวจสอบ attendance_status เพื่อดูผลลัพธ์จริง

Error Response

{ "code": 404, "message": "Employee not found with code: 9999", "payload": [] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/add-data-filter?path_action=add_time_attendance" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "attendance_datetime": "2026-02-18 09:00:00", "time_attendance_type_lv": "Checkin", "work_type_lv": "1", "attendance_inout": "IN" }'

Notes

  • ระบบจะตรวจสอบ duplicate อัตโนมัติ — ไม่สามารถลงเวลาซ้ำในเวลาเดียวกันได้
  • ถ้าเดือนปิดแล้ว จะไม่สามารถเพิ่มข้อมูลได้ (attendance_status = 7)
  • work_type_lv = "0" หมายถึงไม่ระบุรอบการทำงาน (ระบบจะคำนวณเอง)
  • location_id ใน request ต้องเป็น Base64 encoded แต่ใน response จะเป็น plain text

  • Search Time Attendance - ค้นหารายการที่บันทึกแล้ว
  • Edit Time - แก้ไขรายการที่บันทึกผิด
  • Get Detail - ดูรายละเอียดรายการที่บันทึก
Last updated on