Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Income/Expense Import

นำเข้าข้อมูลรายได้/รายจ่ายของพนักงานตามงวดเงินเดือน

Endpoint

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

Request Parameters

Query Parameter

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

Request Body (JSON)

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

import_data[] Fields

FieldTypeRequiredDescription
emp_codestringYesรหัสพนักงาน
Income-{id}number/stringNoจำนวนเงินรายได้ตามประเภท
Expense-{id}number/stringNoจำนวนเงินรายจ่ายตามประเภท
  • ค่าเงินรองรับรูปแบบ comma separator เช่น "1,000.50"
  • ค่าที่เป็น 0 จะลบข้อมูลเก่าออกโดยไม่เพิ่มใหม่
  • ค่าที่เป็นค่าว่าง "" หรือ null จะถูกข้ามไป
  • การนำเข้าเป็นแบบ UPSERT — ลบข้อมูลเก่าแล้วเพิ่มใหม่

Example Request Body

{ "year_month": "2026-03", "import_data": [ { "emp_code": "EMP001", "Income-SAL001": "25000", "Income-SAL002": "5000", "Expense-EXP001": "1000" }, { "emp_code": "EMP002", "Income-SAL001": "30,000.50", "Expense-EXP001": "1500" } ] }

Response Format

Success Response

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

Response Fields

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

Error Detail Fields

FieldTypeDescription
rownumberลำดับแถวที่เกิดข้อผิดพลาด
emp_codestringรหัสพนักงานที่เกิดข้อผิดพลาด
columnstringคอลัมน์ที่เกิดข้อผิดพลาด
messagestringรายละเอียดข้อผิดพลาด

Error Response

{ "code": 400, "message": "import_data is not an array", "payload": [] }
HTTP StatusDescription
400รูปแบบข้อมูลไม่ถูกต้อง, year_month ไม่ถูกต้อง, ไม่พบงวดเงินเดือน
401API Key ไม่ถูกต้องหรือไม่ได้ส่ง

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/import?path_action=inex_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", "Expense-EXP001": "1000" } ] }'

Last updated on