Update Financial Transactions

แก้ไขรายได้-รายหักของพนักงานตามงวด

แก้ไขยอดรายได้-รายหักของพนักงานในงวดหนึ่งเป็นชุด ส่งเฉพาะรายการที่ต้องการแก้ก็ได้
โดยระบุพนักงานด้วย EmployeeRefId และรายการด้วย Code

📋 ต้องเรียก POST /api/v1/payrolls/financial-transactions ก่อน เพื่อให้ได้ EmployeeRefId และ Code ที่มีอยู่จริงในงวดนั้น

⚠️ ข้อควรรู้

ผลลัพธ์ใช้ envelope Result<Hashtable> (Status.Code / Data) — ไม่ใช่ ApiResultBff<T> แบบ POST ของ path เดียวกัน

ไม่สำเร็จได้ 400 (ไม่ใช่ 409 เหมือน endpoint บันทึกอื่นในกลุ่มนี้) โดยเหตุผลอยู่ใน Data.message

📦 Batch Size Limit

จำนวนรายการเงินได้-เงินหัก (FinancialTransactions) สูงสุดต่อ 1 Request: 1,000 รายการ (1 รายการ = พนักงาน 1 คน)

หากส่งเกินจำนวนนี้ ระบบจะตอบกลับ 429 Too Many Requests โดยไม่บันทึกรายการใดเลย

แนะนำ: หากมีข้อมูลมากกว่านี้ ให้แบ่งส่งเป็นหลาย Request

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "CompanyName": "Acme",
    "Year": 2026,
    "PeriodCalculateNo": 1,
    "PeriodExtendNo": 0,
    "FinancialTransactions": [
        {
            "EmployeeRefId": "EMP001",
            "FinancialItems": [
                {
                    "Code": "D12",
                    "Type": 2,
                    "IsCalculate": false,
                    "Amount": 1200
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

แก้ไขสำเร็จ — ผลอยู่ใน Data

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": {
        "result": true,
        "message": "Edited Successfully."
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error