Check in individual KPI values (1–100 items)

POST

https://api.gofive.co.th/api/v1/goals/kpi/individual/check-in

บันทึกค่าปัจจุบันของ KPI รายบุคคลผ่าน check-in เดียวกับปุ่ม Check-in บนเว็บ

IsCheckIn = true (ค่าเริ่มต้น): เช็คอินปกติ ขึ้น timeline พร้อม Remark

IsCheckIn = false: บันทึกแบบเงียบ (สำหรับ sync ตามตารางเวลา) ไม่นับ streak ไม่เปลี่ยน last-modified
ตรวจทุกรายการก่อนบันทึก ถ้ามีรายการผิดจะได้ 400 และไม่บันทึกอะไรเลย
ถ้าบันทึกหลายรอบ (cycle) แล้วรอบหลังล้ม รอบก่อนหน้าจะถูกบันทึกแล้ว ดูได้จาก Data.SavedKpiIds
ต้องมีสิทธิ์ Goals · ReadAndWrite

Request

Authorization

Body Params application/jsonRequired

Examples

Normal check-in with remarkSilent sync (IsCheckIn false)

{
    "EmployeeNo": "EMP001",
    "CompanyName": "Acme",
    "Remark": "ซิงก์จากระบบ ticket ประจำวัน",
    "Items": [
        {
            "KpiId": 5567,
            "CurrentPoint": 22.5
        },
        {
            "KpiId": 5568,
            "CurrentPoint": 64
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Normal check-in with remarkSilent sync (IsCheckIn false)

curl --location 'https://api.gofive.co.th/api/v1/goals/kpi/individual/check-in' \
--header 'Content-Type: application/json' \
--data '{
    "EmployeeNo": "EMP001",
    "CompanyName": "Acme",
    "Remark": "ซิงก์จากระบบ ticket ประจำวัน",
    "Items": [
        {
            "KpiId": 5567,
            "CurrentPoint": 22.5
        },
        {
            "KpiId": 5568,
            "CurrentPoint": 64
        }
    ]
}'

Responses

🟢200

application/json

บันทึกสำเร็จ

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "OK",
    "Data": {
        "SavedKpiIds": [
            5567,
            5568
        ],
        "CheckedInAt": "2026-11-10T07:00:00"
    }
}

🟠400

🟠401

🟠403

🟠429

🔴500

Modified at 2026-11-11 14:43:33

Update KPI

Get Employee Achievements