Update Employee Shifts - Gofive OpenAPI

กำหนดกะให้พนักงานหลายคนเป็นช่วงวันที่

กำหนดกะให้พนักงานหลายคนพร้อมกัน โดยแต่ละรายการระบุช่วงวันที่ที่กะมีผล
ระบบสร้างเป็นคำขอเปลี่ยนกะที่อนุมัติแล้วให้อัตโนมัติ
ต่างจาก PUT /api/v1/employees/shift ตรงที่ระบุบริษัทได้ ระบุกะด้วย รหัสกะ (ShiftCode) และกำหนดเป็นช่วงวันได้

📥 การส่ง body — body เป็น array ส่งหลายรายการได้ในคำขอเดียว

ไม่ส่ง DateTo = กะมีผลไปตลอด (ระบบตั้ง UnlimitEndDate ให้เอง)

EmployeeId / ToShiftId / ShiftTypeId ระบบเติมให้เองจาก EmployeeRefId และ ShiftCode — ส่งมาก็ถูกเขียนทับ จึงไม่มีในเอกสารนี้

📋 ต้องมีข้อมูลก่อนเรียก: รหัสกะต้องมีอยู่ในบริษัทนั้นหรือเป็นกะที่ใช้ได้ทุกสาขา (ดูจาก GET /api/v1/shifts)

⚠️ การตรวจสอบจะหยุดที่รายการแรกที่ผิด และตอบ 400 ทันที รายการก่อนหน้ายังไม่ถูกบันทึก (ระบบบันทึกทั้งชุดหลังตรวจครบแล้ว) — ข้อความบอกค่าที่ผิดไว้ใน Message เช่น No company name 'X' in this tenant., No employee 'EMP001' in this company. หรือ No shift 'A01' in this company.

📦 Batch Size Limit

จำนวนบริษัทสูงสุดต่อ 1 Request: 5 บริษัท (นับจาก CompanyName ที่ต่างกัน)

จำนวนรายการกะการทำงาน (Shift) สูงสุดต่อ 1 บริษัท: 1,000 รายการ

รวมสูงสุดต่อ 1 Request: ไม่เกิน 5 บริษัท × 1,000 รายการ/บริษัท

หากส่งเกินจำนวนนี้ ระบบจะตอบกลับ 429 Too Many Requests โดยไม่บันทึกรายการใดเลย

แนะนำ: หากมีข้อมูลมากกว่านี้ ให้แบ่งส่งเป็นหลาย Request

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

[
    {
        "EmployeeRefId": "EMP001",
        "CompanyName": "Acme",
        "ShiftCode": "A01",
        "DateFrom": "2026-07-01",
        "DateTo": "2026-07-31"
    },
    {
        "EmployeeRefId": "EMP002",
        "CompanyName": "Acme",
        "ShiftCode": "B01",
        "DateFrom": "2026-07-01",
        "DateTo": null
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

บันทึกสำเร็จทั้งชุด — Message เป็นข้อความผลลัพธ์จากระบบ ไม่มี Data

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "Saved successfully."
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error