Update Employee Approver

บันทึกผู้อนุมัติของพนักงาน — กำหนดว่าใครเป็นผู้อนุมัติเอกสารหรือคำขอต่าง ๆ (สูงสุด 5 ลำดับ)

Endpoint


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

ระบบจะลบผู้อนุมัติเดิมทั้งหมดก่อน แล้วสร้างใหม่ตาม auth_list (Replace All) หาก auth_list เป็น array ว่าง [] = ลบผู้อนุมัติทั้งหมด

Query Parameters

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

Request Body

Parameter	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการตั้งผู้อนุมัติ
`auth_list`	array	Yes	รายการผู้อนุมัติ (ส่ง `[]` เพื่อลบทั้งหมด)

auth_list — แต่ละ item

Field	Type	Required	Description
`approver_step`	number	Yes	ลำดับการอนุมัติ (1-5)
`approver_employee_code`	string	Yes	รหัสพนักงานของผู้อนุมัติ (ระบบจะค้นหา ID ให้เอง)
`approver_id`	string	No	employee_id ของผู้อนุมัติ (Base64) — ถ้าไม่ส่งระบบจะหาจาก approver_employee_code
`approver_channel_id`	string	No	Channel ID ของผู้อนุมัติ (Base64)
`approver_employee_name`	string	No	ชื่อจริง (TH) — ระบบ auto-fill ได้
`approver_employee_last_name`	string	No	นามสกุล (TH) — ระบบ auto-fill ได้
`approver_employee_nickname`	string	No	ชื่อเล่น (TH) — ระบบ auto-fill ได้
`approver_employee_name_en`	string	No	ชื่อจริง (EN) — ระบบ auto-fill ได้
`approver_employee_last_name_en`	string	No	นามสกุล (EN) — ระบบ auto-fill ได้
`approver_employee_nickname_en`	string	No	ชื่อเล่น (EN) — ระบบ auto-fill ได้

แนะนำให้ส่งแค่ approver_step และ approver_employee_code ระบบจะ auto-fill ข้อมูลชื่อ/นามสกุล/รูปภาพให้อัตโนมัติ

Response Format

Success Response


{
  "code": 200,
  "message": "Save Approver Success",
  "payload": {
    "employee_id": "20260121FC89F3BB9120",
    "approver_list": [
      {
        "employee_approver_id": "20260216ABC123456789",
        "employee_id": "20260121FC89F3BB9120",
        "approver_step": "1",
        "approver_id": "20260121FC89F3BB9121",
        "approver_employee_code": "2222",
        "approver_employee_name": "สมชาย",
        "approver_employee_last_name": "ใจดี",
        "approver_employee_nickname": "ชาย",
        "approver_employee_name_en": "Somchai",
        "approver_employee_last_name_en": "Jaidee",
        "approver_employee_nickname_en": "Chai",
        "approver_photograph": "/uploads/photo.jpg",
        "approver_channel_id": "20241225567890ABCDEF"
      }
    ],
    "detail": "1. สมชาย ใจดี (ชาย)\n"
  }
}

Error Response


{
  "code": 400,
  "message": "Validation failed",
  "errors": ["Missing required parameter: 'employee_code'"]
}

เงื่อนไข	Error Message
ไม่ส่ง `employee_code` หรือว่าง	`Missing required parameter: 'employee_code'`
`auth_list` ไม่เป็น array	`'auth_list' must be an array`
`employee_code` ไม่มีในระบบ	`Employee not found with code: xxx`
`approver_employee_code` ไม่มีในระบบ	ข้ามผู้อนุมัติคนนั้น (ไม่ error)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-approver" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "auth_list": [
      {
        "approver_step": 1,
        "approver_employee_code": "2222",
        "approver_channel_id": "MjAyNDEyMjU1NkI3OEE3Q0QyNEI="
      },
      {
        "approver_step": 2,
        "approver_employee_code": "3333",
        "approver_channel_id": "MjAyNDEyMjU1NkI3OEE3Q0QyNEI="
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-approver',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      auth_list: [
        { approver_step: 1, approver_employee_code: '2222' },
        { approver_step: 2, approver_employee_code: '3333' }
      ]
    })
  }
)
const data = await response.json()
console.log('Updated:', data.message)
console.log('Approvers:', data.payload.detail)

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-approver"}
data = {
    "employee_code": "EMP001",
    "auth_list": [
        {"approver_step": 1, "approver_employee_code": "2222"},
        {"approver_step": 2, "approver_employee_code": "3333"}
    ]
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Updated: {result['message']}")
print(f"Approvers: {result['payload']['detail']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-approver";
 
$data = [
    "employee_code" => "EMP001",
    "auth_list" => [
        ["approver_step" => 1, "approver_employee_code" => "2222"],
        ["approver_step" => 2, "approver_employee_code" => "3333"]
    ]
];
 
$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

approver_step ต้องอยู่ในช่วง 1-5 และไม่ควรซ้ำกัน หากซ้ำจะใช้ตัวหลังทับตัวแรก หาก approver_employee_code ไม่มีในระบบ ระบบจะข้ามผู้อนุมัติคนนั้น

Update Basic Setting - บันทึกข้อมูลการตั้งค่าพื้นฐาน