Create Welfare Log

สร้างรายการ Welfare Log แบบ Manual สำหรับบันทึกการใช้สวัสดิการโดยตรง เช่น การนำเข้าข้อมูลประวัติ

Endpoint


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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`salary_type_id`	string (base64)	Yes	รหัสประเภทสวัสดิการ	`"MjAyNjAzMDNTVFlQWDAwMDE="`
`employee_welfare_year`	string	Yes	ปีสวัสดิการ (YYYY)	`"2026"`
`year_month`	string	Yes	รอบเงินเดือน (YYYY-MM)	`"2026-03"`
`welfare_amt`	number	Yes	จำนวนเงิน (บาท)	`5000.00`

Optional Parameters

Parameter	Type	Required	Description	Example
`welfare_dt`	string	No	วันที่ใช้สวัสดิการ (YYYY-MM-DD) (default: วันปัจจุบัน)	`"2026-03-15"`
`welfare_desc`	string	No	รายละเอียด	`"ค่ารักษาพยาบาลสะสม"`
`welfare_doc`	file	No	ไฟล์แนบ (ต้องส่งเป็น `multipart/form-data`)	`[Binary File]`

Request Body Example


{
  "employee_code": "EMP001",
  "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
  "employee_welfare_year": "2026",
  "year_month": "2026-03",
  "welfare_amt": 5000.00,
  "welfare_dt": "2026-03-15",
  "welfare_desc": "ค่ารักษาพยาบาลสะสม"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สร้าง Log สวัสดิการสำเร็จ",
  "payload": {
    "employee_welfare_log_id": "20260315WLOG0000001",
    "employee_id": "20260309462FEF65EFCA",
    "salary_type_id": "20260303STYP00001",
    "employee_welfare_year": "2026",
    "master_salary_month": "2026-03",
    "master_salary_report_id": "20260303RPRT00001",
    "welfare_dt": "2026-03-15",
    "welfare_amt": "5000.00",
    "log_balance": "5000.00",
    "log_source": "Manual",
    "welfare_desc": "ค่ารักษาพยาบาลสะสม",
    "welfare_doc": "https://openapi.humansoft.co.th/files/employee-welfares/...",
    "log_datetime": "2026-03-27 10:00:00"
  }
}

Response Fields

Field	Type	Description
`employee_welfare_log_id`	string	รหัส Log (plain text)
`employee_id`	string	รหัสพนักงาน (plain text)
`salary_type_id`	string	รหัสประเภทสวัสดิการ (plain text)
`employee_welfare_year`	string	ปีสวัสดิการ
`master_salary_month`	string	รอบเงินเดือน (YYYY-MM)
`master_salary_report_id`	string	รหัสรอบรายงานเงินเดือน (plain text)
`welfare_dt`	string	วันที่ใช้สวัสดิการ
`welfare_amt`	string	จำนวนเงิน
`log_balance`	string	ยอดที่หักจากวงเงิน
`log_source`	string	แหล่งที่มา (`"Manual"`)
`welfare_desc`	string	รายละเอียด
`welfare_doc`	string	URL ไฟล์แนบ
`log_datetime`	string	วันเวลาที่บันทึก

Error Response - Validation Failed (HTTP 422)


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

Error Response - Payroll Period Closed (HTTP 400)


{
  "code": 400,
  "message": "รอบเงินเดือนปิดแล้ว ไม่สามารถบันทึกได้"
}

สาเหตุ: รอบเงินเดือน year_month ถูกปิดแล้ว วิธีแก้: ใช้รอบเงินเดือนที่ยังเปิดอยู่

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/submit_welfare_log" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_code": "EMP001",
    "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
    "employee_welfare_year": "2026",
    "year_month": "2026-03",
    "welfare_amt": 5000.00,
    "welfare_dt": "2026-03-15",
    "welfare_desc": "ค่ารักษาพยาบาลสะสม"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/welfare/submit_welfare_log',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      salary_type_id: 'MjAyNjAzMDNTVFlQWDAwMDE=',
      employee_welfare_year: '2026',
      year_month: '2026-03',
      welfare_amt: 5000.00,
      welfare_dt: '2026-03-15',
      welfare_desc: 'ค่ารักษาพยาบาลสะสม'
    })
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/submit_welfare_log"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
payload = {
    "employee_code": "EMP001",
    "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
    "employee_welfare_year": "2026",
    "year_month": "2026-03",
    "welfare_amt": 5000.00,
    "welfare_dt": "2026-03-15",
    "welfare_desc": "ค่ารักษาพยาบาลสะสม"
}
 
response = requests.post(url, headers=headers, json=payload)
print(response.json())

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/submit_welfare_log";
$headers = ["Ocp-Apim-Subscription-Key: YOUR_API_KEY", "Content-Type: application/json"];
$payload = [
    "employee_code" => "EMP001",
    "salary_type_id" => "MjAyNjAzMDNTVFlQWDAwMDE=",
    "employee_welfare_year" => "2026",
    "year_month" => "2026-03",
    "welfare_amt" => 5000.00,
    "welfare_dt" => "2026-03-15",
    "welfare_desc" => "ค่ารักษาพยาบาลสะสม"
];
$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

ข้อควรทราบ:

salary_type_id ใน request ต้องเข้ารหัส Base64
ID ทั้งหมดใน response เป็น plain text
employee_welfare_log_id ที่ได้จาก response ใช้ใน API อื่น (ต้อง encode Base64 ก่อนส่ง)
Log ที่สร้างจาก API นี้จะมี log_source = "Manual" เสมอ
รอบเงินเดือน year_month ต้องยังเปิดอยู่
หากต้องการแนบไฟล์ ต้องส่ง request เป็น multipart/form-data

List Logs - ดูรายการ Log ทั้งหมด
Delete Log - ลบ Log ที่สร้างแล้ว

Create Welfare Log

Endpoint

Request Parameters

Required Parameters

Optional Parameters

Request Body Example

Response Format

Success Response (HTTP 200)

Response Fields

Error Response - Validation Failed (HTTP 422)

Error Response - Payroll Period Closed (HTTP 400)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs