Split Income/Expense Template

ดึง Template คอลัมน์รายได้/รายจ่ายและข้อมูลพนักงาน สำหรับรอบเงินเดือนแยก (Split Period)

Endpoint


GET /api/v1/open-apis/salary/get-data-filter?path_action=inex_split_template

Request Parameters

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	งวดเงินเดือนหลัก (YYYY-MM)	`"2026-03"`
`master_salary_split_seq`	string	Yes	ลำดับรอบเงินเดือนแยก	`"1"`
`lang`	string	No	ภาษาที่แสดง: `"TH"` / `"EN"` (ค่าเริ่มต้น: `"TH"`)	`"TH"`
`keyword`	string	No	ค้นหาจากชื่อ นามสกุล รหัสพนักงาน	`"EMP001"`
`company_lists`	array	No	กรองตามบริษัท (Base64 encoded ID)
`branch_lists`	array	No	กรองตามสาขา (Base64 encoded ID)
`department_lists`	array	No	กรองตามแผนก (Base64 encoded ID)
`position_lists`	array	No	กรองตามตำแหน่ง (Base64 encoded ID)
`employee_lists`	array	No	กรองเฉพาะพนักงาน (Base64 encoded ID)
`_PAGE`	number	No	หน้าที่ต้องการ (ค่าเริ่มต้น: `1`)	`1`
`_NUMBER_PER_PAGE`	number	No	จำนวนต่อหน้า (ค่าเริ่มต้น: `20`)	`50`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "year_month": "2026-03",
    "master_salary_split_seq": "1",
    "columns": [
      { "key": "emp_code", "label": "รหัสพนักงาน", "type": "fixed" },
      { "key": "full_name", "label": "ชื่อ-นามสกุล", "type": "fixed" },
      { "key": "Income-SAL001", "label": "เงินเดือน", "type": "income", "color": "#a5ffd9" },
      { "key": "Expense-EXP001", "label": "หักขาดงาน", "type": "expense", "color": "#ffc6c6" }
    ],
    "total_employees": 100,
    "import_data": [
      {
        "emp_code": "EMP001",
        "full_name": "สมชาย ใจดี",
        "Income-SAL001": "12500",
        "Expense-EXP001": ""
      }
    ]
  },
  "_PAGINATION": {
    "_TOTAL_RECORDS": 100,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 20
  }
}

Key Response Fields

Field	Type	Description
`year_month`	string	งวดเงินเดือนหลัก
`master_salary_split_seq`	string	ลำดับรอบเงินเดือนแยก
`columns`	array	รายการคอลัมน์ (เหมือนกับ Income/Expense Template)
`total_employees`	number	จำนวนพนักงานทั้งหมด
`import_data`	array	ข้อมูลพนักงานปัจจุบันในรอบแยก

Error Response

HTTP Status	Description
`400`	รูปแบบ year_month ไม่ถูกต้อง, ไม่ได้ส่ง master_salary_split_seq, ไม่พบรอบเงินเดือนแยก
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=inex_split_template&year_month=2026-03&master_salary_split_seq=1" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'inex_split_template',
  year_month: '2026-03',
  master_salary_split_seq: '1'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
console.log('Split seq:', data.payload.master_salary_split_seq)
console.log('Columns:', data.payload.columns.length)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "inex_split_template",
    "year_month": "2026-03",
    "master_salary_split_seq": "1"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Split: {data['payload']['master_salary_split_seq']}")
print(f"Employees: {data['payload']['total_employees']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "inex_split_template",
    "year_month" => "2026-03",
    "master_salary_split_seq" => "1"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo "Split: {$data['payload']['master_salary_split_seq']}\n";
?>

Split Income/Expense Import - นำเข้าข้อมูลรอบเงินเดือนแยก
Income/Expense Template - Template สำหรับรอบเงินเดือนปกติ
Income/Expense Import Log - ดูประวัติการนำเข้า

Split Income/Expense Template

Endpoint

Request Parameters

Response Format

Success Response

Key Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Related APIs