Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Excel Template

สร้างไฟล์ Excel Template สำหรับนำเข้าข้อมูลสวัสดิการ พร้อม pre-fill ข้อมูลพนักงานตาม filter ที่ส่งมา Response ที่ได้จะเป็นไฟล์ Excel (ไม่ใช่ JSON)

Endpoint

POST /api/v1/open-apis/welfare/excel_template

Request Body

ParameterTypeRequiredDescriptionExample
salary_type_idstring (base64)Yesรหัสประเภทสวัสดิการ"MjAyNjAzMDNTVFlQWDAwMDE="
welfare_yearstringYesปีสวัสดิการ (YYYY)"2026"

Optional Parameters

ParameterTypeRequiredDescriptionExample
authorize_linestringNo"true" เพื่อ scope ตามสายบังคับบัญชา"true"

Request Body Example

{ "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "welfare_year": "2026" }

Response Format

Success Response (HTTP 200)

Response เป็นไฟล์ Excel binary (ไม่ใช่ JSON)

Response Headers:

  • Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • Content-Disposition: attachment;filename="Import_Welfare_Data.xlsx"

โครงสร้างคอลัมน์ในไฟล์ที่ได้

#Column (TH)Column (EN)
1รหัสพนักงานEmployee Code
2สำนักงานสาขาBranch
3แผนกDepartment
4ตำแหน่งPosition
5ชื่อ-นามสกุลName
6รหัสสวัสดิการWelfare Code
7ชื่อสวัสดิการWelfare Name
8ยอดยกมาBalance
9วงเงินAmount

ค่าที่ pre-fill:

  • คอลัมน์พนักงาน/องค์กร: เป็นข้อมูลอ่านอย่างเดียว
  • คอลัมน์รหัส/ชื่อสวัสดิการ: ดึงจาก salary_type_id ที่ส่งมา
  • คอลัมน์ยอดยกมา: ใส่ยอดยกมาถ้ามีข้อมูลในระบบ
  • คอลัมน์วงเงิน: ว่างไว้ให้ผู้ใช้กรอก

Error Response (HTTP 400)

{ "code": 400, "message": "..." }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/excel_template" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "welfare_year": "2026" }' \ -o "Import_Welfare_Data.xlsx"

Notes

ข้อควรทราบ:

  • salary_type_id ใน request ต้องเข้ารหัส Base64
  • Response ของ endpoint นี้เป็นไฟล์ Excel ไม่มี JSON payload
  • ชื่อไฟล์ที่ดาวน์โหลดจะเป็น นำเข้าข้อมูลสวัสดิการ.xlsx (TH) หรือ Import_Welfare_Data.xlsx (EN) ตามภาษาที่ตั้งค่าไว้
  • Excel Import - อัปโหลดไฟล์เพื่อ import เข้าระบบ
  • Import JSON - ส่งข้อมูลแถว JSON แทนไฟล์
  • List Welfare Employee By Type - ตรวจสอบข้อมูลก่อน/หลัง import
Last updated on