Net Total Import

นำเข้าข้อมูลเงินเดือนสุทธิของพนักงาน ระบบจะสร้างสลิปเงินเดือนอัตโนมัติ พร้อมคำนวณภาษีและประกันสังคม

Endpoint


POST /api/v1/open-apis/salary/get-data?path_action=nettotal_import

Request Parameters

Query Parameter

Parameter	Type	Required	Description	Example
`path_action`	string	Yes	ระบุเป็น `nettotal_import`	`"nettotal_import"`

Request Body (JSON)

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	งวดเงินเดือน (YYYY-MM)	`"2026-03"`
`import_data`	array	Yes	ข้อมูลเงินเดือนของพนักงาน	ดูตัวอย่างด้านล่าง

import_data[] Fields

Field	Type	Required	Description
`emp_code`	string	Yes	รหัสพนักงาน
`[column_key]`	number/string	No	จำนวนเงินตาม key ที่ได้จาก Template

การนำเข้าจะลบสลิปเงินเดือนเก่าของงวดที่ระบุ แล้วสร้างใหม่
ระบบคำนวณภาษีและประกันสังคมอัตโนมัติ
ค่าเงินรองรับรูปแบบ comma separator เช่น "1,000.50"

Example Request Body


{
  "year_month": "2026-03",
  "import_data": [
    {
      "emp_code": "EMP001",
      "Income-SAL001": "25000",
      "Income-SAL002": "5000",
      "Expense-EXP001": "1000",
      "tax": "1500",
      "nvat-04": "750"
    },
    {
      "emp_code": "EMP002",
      "Income-SAL001": "30000",
      "tax": "2000"
    }
  ]
}

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "import_log_id": "20260305IMP00000003",
    "all_record": 2,
    "insert_record": 2,
    "error_record": 0,
    "errors": []
  }
}

Response Fields

Field	Type	Description
`import_log_id`	string	รหัส log การนำเข้า
`all_record`	number	จำนวนรายการทั้งหมด
`insert_record`	number	จำนวนสลิปที่สร้างสำเร็จ
`error_record`	number	จำนวนรายการที่เกิดข้อผิดพลาด
`errors`	array	รายละเอียดข้อผิดพลาด

Error Detail Fields

Field	Type	Description
`row`	number	ลำดับแถวที่เกิดข้อผิดพลาด
`emp_code`	string	รหัสพนักงานที่เกิดข้อผิดพลาด
`message`	string	รายละเอียดข้อผิดพลาด

Error Response

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

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data?path_action=nettotal_import" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year_month": "2026-03",
    "import_data": [
      {
        "emp_code": "EMP001",
        "Income-SAL001": "25000",
        "tax": "1500",
        "nvat-04": "750"
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data?path_action=nettotal_import',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year_month: '2026-03',
      import_data: [
        {
          emp_code: 'EMP001',
          'Income-SAL001': '25000',
          tax: '1500',
          'nvat-04': '750'
        }
      ]
    })
  }
)
const data = await response.json()
console.log(`Slips created: ${data.payload.insert_record}/${data.payload.all_record}`)
if (data.payload.errors.length > 0) {
  data.payload.errors.forEach(e => console.error(`Row ${e.row} (${e.emp_code}): ${e.message}`))
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "nettotal_import"}
payload = {
    "year_month": "2026-03",
    "import_data": [
        {
            "emp_code": "EMP001",
            "Income-SAL001": "25000",
            "tax": "1500",
            "nvat-04": "750"
        }
    ]
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(f"Slips created: {data['payload']['insert_record']}/{data['payload']['all_record']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data?path_action=nettotal_import";
$data = json_encode([
    "year_month" => "2026-03",
    "import_data" => [
        [
            "emp_code" => "EMP001",
            "Income-SAL001" => "25000",
            "tax" => "1500",
            "nvat-04" => "750"
        ]
    ]
]);
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Slips created: {$result['payload']['insert_record']}/{$result['payload']['all_record']}\n";
?>

Notes

การนำเข้าข้อมูลจะลบสลิปเงินเดือนเก่าของพนักงานในงวดที่ระบุทั้งหมด แล้วสร้างใหม่ กรุณาตรวจสอบข้อมูลให้ถูกต้องก่อนนำเข้า

Net Total Template - ดึง Template คอลัมน์ก่อนนำเข้า
Net Total Import Log - ดูประวัติการนำเข้า
Pay Slip - ดูสลิปเงินเดือน