Skip to Content
🚀 Welcome to Humansoft Open API Documentation
DocumentationAPI ReferenceSalary (เงินเดือน)Extra Round (งวดพิเศษ)Overview

Extra Round (งวดพิเศษ)

จัดการงวดพิเศษสำหรับการจ่ายเงินนอกรอบปกติ เช่น โบนัส ค่าคอมมิชชัน หรือรายรับรายจ่ายอื่นๆ ที่ไม่ได้อยู่ในงวดเงินเดือนปกติ รองรับการสร้าง แก้ไข ปิด/เปิดงวด บันทึกข้อมูลรายรับรายจ่ายของพนักงาน และส่งออกรายงานในหลายรูปแบบ

Round Management

API สำหรับจัดการงวดพิเศษในระดับภาพรวม เช่น สร้างงวด ดูรายละเอียด ปิด/เปิดงวด และลบงวด

MethodEndpointDescription
GETList Extra Roundsดูรายการงวดพิเศษทั้งหมดในเดือนที่ระบุ
GETGet Extra Round Detailดูรายละเอียดงวดพิเศษพร้อมรายชื่อพนักงานและประเภทรายรับรายจ่าย
POSTCreate Extra Roundสร้างงวดพิเศษใหม่สำหรับเดือนที่ระบุ
POSTSave Extra Roundบันทึกข้อมูลรายรับรายจ่ายของพนักงานในงวดพิเศษ
POSTDelete Extra Roundลบงวดพิเศษและข้อมูลทั้งหมดที่เกี่ยวข้อง
POSTFinish Extra Roundปิดงวดพิเศษ (ล็อกไม่ให้แก้ไข)
POSTUnfinish Extra Roundเปิดงวดพิเศษกลับมาแก้ไข

Data & Export

API สำหรับดูข้อมูลสรุป ตั้งค่าวันจ่ายเงิน และส่งออกรายงาน

MethodEndpointDescription
GETGet Income/Expense Summaryดูสรุปยอดรวมรายรับรายจ่ายของพนักงานในงวดพิเศษ
POSTSave Paid Dateบันทึกวันที่จ่ายเงินสำหรับงวดพิเศษ
GETExport Extra Roundส่งออกข้อมูลงวดพิเศษเป็นไฟล์ (Excel, PDF, Bank Format)
  • master_salary_xtra_report_id ที่ส่งใน request ต้องเป็น Base64 encoded ส่วนค่าที่ได้รับใน response จะเป็น plain text
  • งวดพิเศษที่ถูกปิด (Finish) แล้วจะไม่สามารถแก้ไขข้อมูลได้ ต้อง Unfinish ก่อน
  • การส่งออกรายงาน (Export) ทำได้เฉพาะงวดที่ปิดแล้วเท่านั้น
  • เดือนที่ต้องการสร้างงวดพิเศษต้องมีการตั้งค่ารอบการจ่ายเงินเดือนไว้แล้ว
Last updated on