Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Split Income/Expense Import

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

Endpoint

POST /api/v1/open-apis/salary/import?path_action=inex_split_import

Request Parameters

Query Parameter

ParameterTypeRequiredDescriptionExample
path_actionstringYesระบุเป็น inex_split_import"inex_split_import"

Request Body (JSON)

ParameterTypeRequiredDescriptionExample
year_monthstringYesงวดเงินเดือนหลัก (YYYY-MM)"2026-03"
master_salary_split_seqstringYesลำดับรอบเงินเดือนแยก"1"
import_dataarrayYesข้อมูลรายได้/รายจ่ายของพนักงานดูตัวอย่างด้านล่าง

import_data[] Fields

FieldTypeRequiredDescription
emp_codestringYesรหัสพนักงาน
Income-{id}number/stringNoจำนวนเงินรายได้ตามประเภท
Expense-{id}number/stringNoจำนวนเงินรายจ่ายตามประเภท

พฤติกรรมการนำเข้าเหมือนกับ 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

FieldTypeDescription
import_log_idstringรหัส log การนำเข้า (20 ตัวอักษร)
all_recordnumberจำนวนรายการทั้งหมด
insert_recordnumberจำนวนรายการที่นำเข้าสำเร็จ
error_recordnumberจำนวนรายการที่เกิดข้อผิดพลาด
errorsarrayรายละเอียดข้อผิดพลาด (row, emp_code, column, message)

Error Response

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

Code Examples

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" } ] }'

Last updated on