Create Timesheet Entry - Gofive OpenAPI

บันทึกเวลาทำงานของพนักงาน

บันทึกเวลาทำงาน 1 รายการ = พนักงาน 1 คน + งาน 1 งาน + 1 วัน

⚠️ Time คือ ระยะเวลาที่ใช้ ในรูปแบบ HH:mm (เช่น 08:00 = ทำงาน 8 ชั่วโมง ไม่ใช่เวลา 8 นาฬิกา)

📋 ต้องมีข้อมูลก่อนเรียก

ProjectCode ต้องมีอยู่จริง (หาได้จาก POST /api/v1/timesheets/projects/search)

TaskId ต้องมีอยู่จริงและเป็นตัวเลข (หาได้จาก POST /api/v1/timesheets/tasks/search)

EmployeeCode ต้องเป็นรหัสพนักงานที่มีอยู่ใน tenant

⚠️ ระบบกันบันทึกซ้ำ: ถ้ามีรายการของพนักงานคนนั้นในงาน/วันเดียวกันอยู่แล้วจะได้ 409

🔐 ต้องมีสิทธิ์ Open API โมดูล TimeSheet ระดับ ReadAndWrite

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "ProjectCode": "PRJ-001",
    "TaskId": "4501",
    "EmployeeCode": "EMP001",
    "Date": "2026-06-30",
    "Time": "08:00",
    "Description": "ออกแบบหน้าจอตัวอย่าง"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

บันทึกสำเร็จ — Data คือรายการที่บันทึกไว้ พร้อม CreatedAt ที่ระบบออกให้

Bodyapplication/json

Example

{
    "Status": {
        "Code": "200",
        "Description": "Timesheet entry has been created successfully"
    },
    "Data": {
        "ProjectCode": "PRJ-001",
        "TaskId": "4501",
        "EmployeeCode": "EMP001",
        "Date": "2026-06-30",
        "Time": "08:00",
        "Description": "ออกแบบหน้าจอตัวอย่าง",
        "CreatedAt": "2026-06-30T17:05:00Z"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409Conflict

🟠429Too Many Requests

🔴500Server Error