Update Employee Role Duty

บันทึกป้ายกำกับหน้าที่ปฏิบัติงานประจำสัปดาห์ของพนักงาน สามารถกำหนดให้หลายคนพร้อมกันได้

Endpoint


POST /api/v1/open-apis/employee/update-employee-setting?path_action=save-role-duty

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `save-role-duty` หรือ `role-duty`

Request Body

Parameter	Type	Required	Description
`employee_lists`	array	Yes	รายการพนักงานและป้ายหน้าที่

employee_lists — แต่ละ item

Field	Type	Required	Description
`employee_code`	string	Recommended	รหัสพนักงาน
`employee_id`	string	Optional	ID พนักงาน (Base64 encoded) — backward compatible
`day_lists`	array	Yes	รายการวัน 7 วัน

ต้องส่ง employee_code หรือ employee_id อย่างน้อยหนึ่งอย่าง ถ้าส่งทั้งคู่ ระบบจะใช้ employee_code

day_lists — แต่ละวัน

Field	Type	Required	Description	Example
`day`	string	Yes	ชื่อวัน (`Mon`, `Tue`, `Wed`, `Thu`, `Fri`, `Sat`, `Sun`)	`"Mon"`
`id`	string	Yes	รหัสป้ายหน้าที่ (Base64 encoded, 20 chars) ว่าง = ไม่กำหนด	`"MjAyNjAxMjFSRDAwMQ=="`
`name`	string	No	ชื่อป้ายหน้าที่ (ใช้สำหรับ log)	`"พนักงานทั่วไป"`

Response Format

Success Response


{
  "code": 200,
  "message": "Save Role Duty Success",
  "payload": {
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          { "day": "Mon", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Tue", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Wed", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Thu", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Fri", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Sat", "id": "", "name": "" },
          { "day": "Sun", "id": "", "name": "" }
        ]
      }
    ]
  }
}

Error Response


{
  "code": "400",
  "message": "กรุณาระบุ 'employee_lists'"
}

เงื่อนไข	Error Message
ไม่ส่ง `employee_lists`	`กรุณาระบุ 'employee_lists'`
`employee_lists` ไม่เป็น array	`'employee_lists' ต้องเป็น array`
ไม่ส่ง `employee_code` หรือ `employee_id`	`ไม่พบ 'employee_id' หรือ 'employee_code' ในรายการที่ x`
ไม่ส่ง `day_lists`	`ไม่พบ 'day_lists' ในรายการที่ x`
หา employee ไม่เจอ	`Employee not found with code: xxx`

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-role-duty" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          { "day": "Mon", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Tue", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Wed", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Thu", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Fri", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป" },
          { "day": "Sat", "id": "", "name": "" },
          { "day": "Sun", "id": "", "name": "" }
        ]
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-role-duty',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_lists: [
        {
          employee_code: 'EMP001',
          day_lists: [
            { day: 'Mon', id: 'MjAyNjAxMjFSRDAwMQ==', name: 'พนักงานทั่วไป' },
            { day: 'Tue', id: 'MjAyNjAxMjFSRDAwMQ==', name: 'พนักงานทั่วไป' },
            { day: 'Wed', id: 'MjAyNjAxMjFSRDAwMQ==', name: 'พนักงานทั่วไป' },
            { day: 'Thu', id: 'MjAyNjAxMjFSRDAwMQ==', name: 'พนักงานทั่วไป' },
            { day: 'Fri', id: 'MjAyNjAxMjFSRDAwMQ==', name: 'พนักงานทั่วไป' },
            { day: 'Sat', id: '', name: '' },
            { day: 'Sun', id: '', name: '' }
          ]
        }
      ]
    })
  }
)
const data = await response.json()
console.log('Updated:', data.message)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {"path_action": "save-role-duty"}
data = {
    "employee_lists": [
        {
            "employee_code": "EMP001",
            "day_lists": [
                {"day": "Mon", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป"},
                {"day": "Tue", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป"},
                {"day": "Wed", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป"},
                {"day": "Thu", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป"},
                {"day": "Fri", "id": "MjAyNjAxMjFSRDAwMQ==", "name": "พนักงานทั่วไป"},
                {"day": "Sat", "id": "", "name": ""},
                {"day": "Sun", "id": "", "name": ""}
            ]
        }
    ]
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Updated: {result['message']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-role-duty";
 
$data = [
    "employee_lists" => [
        [
            "employee_code" => "EMP001",
            "day_lists" => [
                ["day" => "Mon", "id" => "MjAyNjAxMjFSRDAwMQ==", "name" => "พนักงานทั่วไป"],
                ["day" => "Tue", "id" => "MjAyNjAxMjFSRDAwMQ==", "name" => "พนักงานทั่วไป"],
                ["day" => "Wed", "id" => "MjAyNjAxMjFSRDAwMQ==", "name" => "พนักงานทั่วไป"],
                ["day" => "Thu", "id" => "MjAyNjAxMjFSRDAwMQ==", "name" => "พนักงานทั่วไป"],
                ["day" => "Fri", "id" => "MjAyNjAxMjFSRDAwMQ==", "name" => "พนักงานทั่วไป"],
                ["day" => "Sat", "id" => "", "name" => ""],
                ["day" => "Sun", "id" => "", "name" => ""]
            ]
        ]
    ]
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Updated: " . $result['message'] . "\n";
?>

Notes

day_lists[].id ต้อง Base64 encode — ระบบจะ decode ก่อนบันทึก วันที่ไม่มีป้ายหน้าที่ให้ใส่ id เป็น "" (empty string)

Get Role Duty - ดึงข้อมูลป้ายกำกับหน้าที่ของพนักงาน