Net Total Template

ดึง Template คอลัมน์และข้อมูลพนักงาน สำหรับเตรียมข้อมูลก่อนนำเข้าเงินเดือนสุทธิ

Endpoint


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

Request Parameters

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

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "year_month": "2026-03",
    "columns": [
      { "key": "emp_code", "label": "รหัสพนักงาน", "type": "fixed" },
      { "key": "full_name", "label": "ชื่อ-นามสกุล", "type": "fixed" },
      { "key": "tax", "label": "ภาษี", "type": "deduction" },
      { "key": "nvat-04", "label": "ประกันสังคม (ลูกจ้าง)", "type": "deduction" },
      { "key": "nvat-05", "label": "ประกันสังคม (นายจ้าง)", "type": "deduction" },
      { "key": "Income-SAL001", "label": "เงินเดือน", "type": "income", "color": "#a5ffd9" },
      { "key": "Expense-EXP001", "label": "หักขาดงาน", "type": "expense", "color": "#ffc6c6" }
    ],
    "total_employees": 200,
    "import_data": [
      {
        "emp_code": "EMP001",
        "full_name": "สมชาย ใจดี",
        "tax": "1500",
        "nvat-04": "750",
        "nvat-05": "750",
        "Income-SAL001": "25000",
        "Expense-EXP001": ""
      }
    ]
  },
  "_PAGINATION": {
    "_TOTAL_RECORDS": 200,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 20
  }
}

Key Response Fields

Field	Type	Description
`year_month`	string	งวดเงินเดือน
`columns`	array	รายการคอลัมน์ทั้งหมด
`columns[].key`	string	ชื่อ key สำหรับส่งข้อมูล
`columns[].label`	string	ชื่อแสดงผล
`columns[].type`	string	ประเภท: `"fixed"`, `"income"`, `"expense"`, `"deduction"`
`total_employees`	number	จำนวนพนักงานทั้งหมด
`import_data`	array	ข้อมูลพนักงานปัจจุบัน

คอลัมน์ tax, nvat-04, nvat-05 เป็นคอลัมน์เฉพาะของ Net Total
คอลัมน์ nvat-04 = ประกันสังคมส่วนลูกจ้าง, nvat-05 = ประกันสังคมส่วนนายจ้าง
คอลัมน์ Income/Expense เป็น dynamic ขึ้นกับ config บริษัท

Error Response

HTTP Status	Description
`400`	ไม่พบงวดเงินเดือนที่ระบุ
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  path_action: 'nettotal_template',
  year_month: '2026-03'
})
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('Columns:', data.payload.columns.map(c => `${c.key}: ${c.label}`))

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": "nettotal_template",
    "year_month": "2026-03"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for col in data["payload"]["columns"]:
    print(f"{col['key']}: {col['label']} ({col['type']})")

PHP


<?php
$params = http_build_query([
    "path_action" => "nettotal_template",
    "year_month" => "2026-03"
]);
$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);
foreach ($data["payload"]["columns"] as $col) {
    echo "{$col['key']}: {$col['label']}\n";
}
?>

Net Total Import - นำเข้าข้อมูลเงินเดือนสุทธิ
Net Total Import Log - ดูประวัติการนำเข้า
Income/Expense Template - Template สำหรับรายได้/รายจ่าย

Net Total Template

Endpoint

Request Parameters

Response Format

Success Response

Key Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Related APIs