Split Income/Expense Import
นำเข้าข้อมูลรายได้/รายจ่ายของพนักงานสำหรับรอบเงินเดือนแยก (Split Period)
Endpoint
POST /api/v1/open-apis/salary/import?path_action=inex_split_importRequest Parameters
Query Parameter
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
path_action | string | Yes | ระบุเป็น inex_split_import | "inex_split_import" |
Request Body (JSON)
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year_month | string | Yes | งวดเงินเดือนหลัก (YYYY-MM) | "2026-03" |
master_salary_split_seq | string | Yes | ลำดับรอบเงินเดือนแยก | "1" |
import_data | array | Yes | ข้อมูลรายได้/รายจ่ายของพนักงาน | ดูตัวอย่างด้านล่าง |
import_data[] Fields
| Field | Type | Required | Description |
|---|---|---|---|
emp_code | string | Yes | รหัสพนักงาน |
Income-{id} | number/string | No | จำนวนเงินรายได้ตามประเภท |
Expense-{id} | number/string | No | จำนวนเงินรายจ่ายตามประเภท |
พฤติกรรมการนำเข้าเหมือนกับ Income/Expense Import ปกติ (UPSERT, รองรับ comma separator, ค่า 0 = ลบ)
Example Request Body
{
"year_month": "2026-03",
"master_salary_split_seq": "1",
"import_data": [
{
"emp_code": "EMP001",
"Income-SAL001": "12500",
"Expense-EXP001": "500"
}
]
}Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"import_log_id": "20260305IMP00000002",
"all_record": 1,
"insert_record": 1,
"error_record": 0,
"errors": []
}
}Response Fields
| Field | Type | Description |
|---|---|---|
import_log_id | string | รหัส log การนำเข้า (20 ตัวอักษร) |
all_record | number | จำนวนรายการทั้งหมด |
insert_record | number | จำนวนรายการที่นำเข้าสำเร็จ |
error_record | number | จำนวนรายการที่เกิดข้อผิดพลาด |
errors | array | รายละเอียดข้อผิดพลาด (row, emp_code, column, message) |
Error Response
| HTTP Status | Description |
|---|---|
400 | year_month ไม่ถูกต้อง, ไม่ได้ส่ง master_salary_split_seq, ไม่พบรอบเงินเดือนแยก |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/import?path_action=inex_split_import" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"year_month": "2026-03",
"master_salary_split_seq": "1",
"import_data": [
{
"emp_code": "EMP001",
"Income-SAL001": "12500",
"Expense-EXP001": "500"
}
]
}'Related APIs
- Split Income/Expense Template - ดึง Template ก่อนนำเข้า
- Income/Expense Import Log - ดูประวัติการนำเข้า
Last updated on