Create Loan - Gofive OpenAPI

สร้างเงินกู้/รายการผ่อนชำระให้พนักงาน

สร้างรายการเงินกู้หรือรายการผ่อนชำระให้พนักงาน โดยอ้างรายการรายได้-รายหักด้วย ชื่อ (FinancialItemName)
ไม่ใช่รหัส ระบบจะตั้งงวดหักเงินเดือนตาม TotalPeriod ให้

📘 ต่างจาก POST /api/v1/payrolls/employee/loans ตรงที่ endpoint นี้ให้ระบบคำนวณงวดและดอกเบี้ยให้จากยอดรวม ส่วน employee/loans เป็นการบันทึกยอดต่องวดที่ผู้เรียกคำนวณมาเองแล้ว

📋 ต้องมีข้อมูลก่อนเรียก: FinancialItemName ต้องตรงกับรายการรายได้-รายหักที่ตั้งไว้ในบริษัทนั้นแล้ว

⚠️ ข้อควรรู้

สำเร็จได้ 201 พร้อม body { "status": true, "message": "Successfully" }

ไม่ส่ง EmployeeRefId จะได้ 403 ไม่ใช่ 400

🔐 ต้องมีสิทธิ์ Open API โมดูล Payroll ระดับ ReadAndWrite

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme",
    "FinancialItemName": "เงินกู้สวัสดิการ",
    "DateOfPayment": "2026-08-31",
    "Amount": 19800,
    "DocumentNo": "LOAN-2026-000001",
    "TotalPeriod": 12,
    "Remark": "เงินกู้ตัวอย่าง",
    "InterestType": 1,
    "InterestRatePerYear": 3
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created

application/json

สร้างรายการสำเร็จ — body เป็น object ดิบ ไม่มี envelope ครอบ

Bodyapplication/json

Example

{
    "status": true,
    "message": "Successfully"
}

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

🟠429Too Many Requests

🔴500Server Error