Swap Employee Shifts - Gofive OpenAPI

สลับกะระหว่างพนักงาน 2 คน

สลับกะของพนักงานสองคนในวันที่ที่ระบุ — พนักงาน FromEmployeeRefId ในวัน DateSwapFrom จะได้กะของ
ToEmployeeRefId ในวัน DateSwapTo และกลับกัน ระบบบันทึกเป็นคำขอสลับกะที่อนุมัติแล้ว

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

พนักงานทั้งสองคนต้องอยู่ในบริษัทเดียวกัน (CompanyName)

ทั้งคู่ต้องมีกะของวันที่ที่จะสลับอยู่แล้ว ถ้าฝ่ายใดฝ่ายหนึ่งยังไม่มีกะในวันนั้น คำขอจะล้มเหลว

⚠️ endpoint นี้ใช้ envelope Result<T> ไม่ใช่ ApiResultBff<T> — ผลลัพธ์อยู่ใน Data.result (boolean) และ Data.message (ข้อความ ปกติเป็นภาษาอังกฤษ) โดย key ทั้งสองเป็นตัวพิมพ์เล็กเพราะเป็น dictionary

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "CompanyName": "Acme",
    "FromEmployeeRefId": "EMP001",
    "ToEmployeeRefId": "EMP002",
    "DateSwapFrom": "2026-07-10",
    "DateSwapTo": "2026-07-11",
    "Description": "สลับกะตามที่ตกลงกันในทีม"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สลับกะสำเร็จ — Data.result = true

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": {
        "message": "Saved successfully.",
        "result": true
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error