Update Employee - Gofive OpenAPI

สร้างหรือแก้ไขพนักงาน

สร้างพนักงานใหม่หรือแก้ไขข้อมูลหลักของพนักงานที่มีอยู่ — ระบบตัดสินจาก EmployeeRefId ว่ามีอยู่แล้วหรือไม่

🧭 ฟิลด์บังคับต่างกันระหว่างสร้างกับแก้ไข

สร้างใหม่ → ต้องส่ง CompanyName, TitleId, Name, NameEN, Surname, SurnameEN, Gender, DateHired, DateOfBirth ให้ครบ

แก้ไข → ฟิลด์เหล่านี้ส่งเฉพาะที่ต้องการเปลี่ยนได้ (ที่เหลือปล่อยว่างไว้ได้)

📘 ข้อควรรู้ในการส่งข้อมูล

เปลี่ยนรหัสพนักงาน ทำได้โดยส่ง EmployeeRefId เป็นรหัสเดิม และ NewEmployeeRefId เป็นรหัสใหม่

รูปโปรไฟล์ส่งเป็น base64 ใน OriginalPicture คู่กับ PictureType (เช่น image/png) — endpoint นี้ไม่รับ multipart upload

TitleId ใช้รหัสจาก GET /api/v1/masters/prefixes

UpperSupervisorNo คือรหัสพนักงานของหัวหน้า ซึ่งต้องมีอยู่จริงในบริษัทเดียวกัน

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme",
    "TitleId": 1,
    "Name": "พนักงานตัวอย่าง",
    "NameEN": "Sample",
    "Surname": "หนึ่ง",
    "SurnameEN": "One",
    "NickName": "ตัวอย่าง",
    "NickNameEN": "Sample",
    "Gender": 1,
    "DateHired": "2026-07-01",
    "DateOfBirth": "1995-01-15",
    "UpperSupervisorNo": "EMP009"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สร้างหรือแก้ไขสำเร็จ — ผลอยู่ใน Data

Bodyapplication/json

Example

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

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error