ส่งงานกลับให้แก้หลายใบพร้อมกัน

ส่งงานกลับให้พนักงานแก้ไขทีละหลายใบ ทำงานแบบเดียวกับการอนุมัติ — ใบที่ทำไม่ได้ไม่ทำให้ทั้งชุดล้ม

⚠️ ข้อควรรู้

ReturnRemark บังคับส่ง — ไม่ส่งจะได้ 400 พร้อม Error = RETURN_REMARK_REQUIRED เพราะพนักงานต้องรู้ว่าต้องแก้อะไร

200 ไม่ได้แปลว่าสำเร็จทุกใบ ต้องอ่าน Data.ReturnedTasks และ Data.FailedTasks

Code ใน FailedTasks เป็นชุดเดียวกับ endpoint อนุมัติ บวก TASK_STATUS_INVALID (สถานะปัจจุบันของงานส่งกลับไม่ได้)

📦 Batch Size Limit

จำนวนรหัสงาน (EmployeeMissionTaskIds) สูงสุดต่อ 1 Request: 500 รายการ

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

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "EmployeeMissionTaskIds": [
        90101
    ],
    "ReturnRemark": "กรุณาแนบไฟล์สรุปยอดขายเพิ่ม"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

ดำเนินการเสร็จ — อาจสำเร็จเพียงบางส่วน ใบที่สำเร็จอยู่ใน Data.ReturnedTasks
ใบที่ไม่สำเร็จอยู่ใน Data.FailedTasks พร้อม Code ของแต่ละใบ

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "Returned successfully.",
    "Data": {
        "ReturnedTasks": [
            {
                "EmployeeMissionTaskId": 90101,
                "TaskStatus": "Returned",
                "DateReturned": "2026-07-05T11:00:00"
            }
        ],
        "FailedTasks": []
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error