Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Save Extra Round

บันทึกข้อมูลรายรับและรายจ่ายของพนักงานในงวดพิเศษ โดยส่งข้อมูลพนักงานทั้งหมดเข้ามาในครั้งเดียว (Bulk Save)

Endpoint

POST /api/v1/open-apis/salary/update-data-filter?path_action=save_extra_round

Request Body

ParameterTypeRequiredDescriptionExample
master_salary_xtra_report_idstringYesรหัสงวดพิเศษ (Base64 encoded)"MjAyNTAzMjM5NzQxNDI="
employee_listsarrayYesรายการข้อมูลพนักงานที่จะบันทึก(ดูโครงสร้างด้านล่าง)

โครงสร้าง employee_lists (แต่ละคน)

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
total_incomenumberYesยอดเงินรับรวม
total_nvat_incomenumberYesยอดรวมรายได้ส่วนที่เป็น Non-VAT
nvat_ratenumberYesอัตราภาษีมูลค่าเพิ่ม
total_nvatnumberYesยอดภาษี NVAT ขั้นสุดท้าย
total_salarynumberYesยอดเงินสุทธิ
xtra_remarkstringNoหมายเหตุสลิปงวดพิเศษ
include_calc_taxstringYesรวมคิดภาษีหัก ณ ที่จ่าย (Y หรือ N)
calc_tax_amtnumberYesยอดเงินที่จะนำไปหักภาษี ณ ที่จ่าย
calc_taxnumberYesค่าภาษี
incomearrayNoรายการรายรับ
expensearrayNoรายการรายจ่าย

โครงสร้าง income / expense

ParameterTypeRequiredDescription
salary_type_idstringYesรหัสประเภทรายการ (Base64 encoded)
income_amt / expenses_amtnumberYesจำนวนเงิน
  • ไม่สามารถบันทึกได้หากงวดถูกปิด (Finished) แล้ว ต้อง Unfinish ก่อน
  • หาก employee_code ไม่ถูกต้องแม้แต่คนเดียว ระบบจะยกเลิกการบันทึกทั้งหมด
  • การบันทึกจะลบข้อมูลเดิมแล้วแทรกใหม่ทั้งหมด (Atomic Transaction)

Response Format

Success Response

{ "code": 200, "message": "Extra Round Saved Successfully: At Round 1 ( โบนัสไตรมาส1 )", "payload": { "master_salary_xtra_report_id": "20250323974142", "master_salary_xtra_name": "โบนัสไตรมาส1", "master_salary_xtra_seq": 1, "employee_lists": 1 } }

Response Fields

FieldTypeDescription
master_salary_xtra_report_idstringรหัสงวดพิเศษ (plain text)
master_salary_xtra_namestringชื่องวดพิเศษ
master_salary_xtra_seqnumberลำดับงวดพิเศษ
employee_listsnumberจำนวนพนักงานที่บันทึกสำเร็จ

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=save_extra_round" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "master_salary_xtra_report_id": "MjAyNTAzMjM5NzQxNDI=", "employee_lists": [ { "employee_code": "EMP001", "total_income": 5000, "total_nvat_income": 0, "nvat_rate": 7, "total_nvat": 0, "total_salary": 5000, "xtra_remark": "โบนัสพิเศษ", "include_calc_tax": "N", "calc_tax_amt": 0, "calc_tax": 0, "income": [ { "salary_type_id": "SU5DMDE=", "income_amt": 5000 } ], "expense": [] } ] }'

Notes

  • ค่า salary_type_id ใน income/expense ต้องเป็น Base64 encoded (ดูรายการที่ใช้ได้จาก Get Extra Round Detail)
  • ข้อมูลเดิมจะถูกลบและแทรกใหม่ทั้งหมดในครั้งเดียว หากเกิดข้อผิดพลาดระหว่างทางจะยกเลิกทั้งหมด

  • Finish Extra Round - ล็อกงวดหลังตรวจสอบยอดถูกต้องแล้ว
  • Get Extra Round Detail - ตรวจสอบข้อมูลงวดพิเศษ
Last updated on