Update Payout Date

อัปเดตวันที่จ่ายเงินสวัสดิการ สามารถอัปเดตหลายเอกสารพร้อมกันในครั้งเดียว (Batch Update)

Endpoint


POST /api/v1/open-apis/welfare/update_payout

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_ids`	object	Yes	Map ของ Base64(employee_welfare_id) เป็น key และวันที่จ่าย (YYYY-MM-DD) เป็น value	ดูตัวอย่างด้านล่าง

โครงสร้าง employee_ids:

Key = Base64 encoded employee_welfare_id / Value = วันที่จ่าย (YYYY-MM-DD)

Request Body Example


{
  "employee_ids": {
    "MjAyNjAzMjdXRUwwMDAwMDAwMQ==": "2026-03-31",
    "MjAyNjAzMjdXRUwwMDAwMDAwMg==": "2026-03-31",
    "MjAyNjAzMjdXRUwwMDAwMDAwMw==": "2026-04-05"
  }
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "อัปเดตวันที่จ่ายสำเร็จ",
  "payload": {
    "employee_ids": {
      "MjAyNjAzMjdXRUwwMDAwMDAwMQ==": "2026-03-31",
      "MjAyNjAzMjdXRUwwMDAwMDAwMg==": "2026-03-31",
      "MjAyNjAzMjdXRUwwMDAwMDAwMw==": "2026-04-05"
    }
  }
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: employee_ids"
  ]
}

Error Response - Server Error (HTTP 400)


{
  "code": 400,
  "message": "Internal server error"
}

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_payout" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_ids": {
      "MjAyNjAzMjdXRUwwMDAwMDAwMQ==": "2026-03-31",
      "MjAyNjAzMjdXRUwwMDAwMDAwMg==": "2026-03-31",
      "MjAyNjAzMjdXRUwwMDAwMDAwMw==": "2026-04-05"
    }
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_payout',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_ids: {
        'MjAyNjAzMjdXRUwwMDAwMDAwMQ==': '2026-03-31',
        'MjAyNjAzMjdXRUwwMDAwMDAwMg==': '2026-03-31',
        'MjAyNjAzMjdXRUwwMDAwMDAwMw==': '2026-04-05'
      }
    })
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_payout"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
payload = {
    "employee_ids": {
        "MjAyNjAzMjdXRUwwMDAwMDAwMQ==": "2026-03-31",
        "MjAyNjAzMjdXRUwwMDAwMDAwMg==": "2026-03-31",
        "MjAyNjAzMjdXRUwwMDAwMDAwMw==": "2026-04-05"
    }
}
 
response = requests.post(url, headers=headers, json=payload)
print(response.json())

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/update_payout";
$headers = ["Ocp-Apim-Subscription-Key: YOUR_API_KEY", "Content-Type: application/json"];
$payload = [
    "employee_ids" => [
        "MjAyNjAzMjdXRUwwMDAwMDAwMQ==" => "2026-03-31",
        "MjAyNjAzMjdXRUwwMDAwMDAwMg==" => "2026-03-31",
        "MjAyNjAzMjdXRUwwMDAwMDAwMw==" => "2026-04-05"
    ]
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
print_r(json_decode($response, true));
curl_close($ch);
?>

Notes

ข้อควรทราบ:

Key ของ employee_ids ต้องเป็น Base64 encoded employee_welfare_id
Value เป็น plain text วันที่รูปแบบ YYYY-MM-DD
สามารถส่งหลายรายการในครั้งเดียว (Batch Update)

Overview - ภาพรวมโมดูลสวัสดิการ