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": "TESTOPENAPI",
    "taskId": "311",
    "employeeCode": "00001",
    "date": "2026-03-30",
    "time": "02:30",
    "description": "Implement API integration for customer sync"
  }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

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

Bodyapplication/json

Examples

SuccessSuccess Example

{
  "status": {
    "code": "200",
    "description": "Timesheet entry has been created successfully"
  },
  "data": {
    "projectCode": "PJ-240001",
    "taskId": "TASK-1001",
    "employeeCode": "EMP00045",
    "date": "2026-03-30",
    "time": "02:30",
    "description": "Implement API integration for customer sync",
    "createdAt": "2026-03-30T10:15:23Z"
  }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠429

🔴500Server Error