Import Work Cycle Change Batch

นำเข้าเอกสารเปลี่ยนกะการทำงานแบบกลุ่ม (Batch) เพื่อประมวลผลและอนุมัติอัตโนมัติทันที

ใช้ API นี้เพื่อนำเข้าข้อมูลการเปลี่ยนกะหลายรายการพร้อมกัน เหมาะสำหรับการเชื่อมต่อกับระบบวางแผนกำลังพลภายนอก

Endpoint


POST /api/v1/open-apis/work-cycle-change/import

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`import_data`	array	Yes	รายการข้อมูลที่ต้องการประมวลผล	`[...]`

Optional Parameters

Parameter	Type	Required	Description	Example
`authorize_id`	string	No	ID ของผู้อนุมัติ (Base64) — ใช้แทนผู้อนุมัติเริ่มต้น	`U01DMD...`

หา authorize_id ได้อย่างไร: รับค่าจาก Get Employee Data Filter โดยใช้ path_action=get-user พร้อม employee_code ของผู้ทำรายการ — ใช้ค่า user_id ที่ได้กลับมาเป็น authorize_id

Item Fields ใน `import_data` (Status: `ADD`)

Parameter	Type	Required	Description	Example
`status`	string	Yes	กำหนดเป็น `ADD`	`ADD`
`employee_code`	string	Yes	รหัสพนักงานผู้ขอเปลี่ยนกะ	`EMP001`
`work_cycle_change_dt`	string	Yes	วันที่ต้องการเปลี่ยนกะ (YYYY-MM-DD)	`2025-11-15`
`work_cycle_id`	string	Yes	รหัสกะการทำงานที่ต้องการเปลี่ยนไป	`20251127D4573C421639`
`work_cycle_change_desc`	string	No	รายละเอียดเพิ่มเติม	`เปลี่ยนกะด่วนผ่านระบบ Import`

Request Body Example


{
  "authorize_id": "U01DM0RFMEE5MTZCMUMyRTg=",
  "import_data": [
    {
      "status": "ADD",
      "employee_code": "EMP001",
      "work_cycle_change_dt": "2025-11-20",
      "work_cycle_id": "20251127D4573C421639",
      "work_cycle_change_desc": "เปลี่ยนกะด่วน"
    }
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "successfully en-queued",
  "payload": {
    "invalid_items": []
  }
}

Key Response Fields

Field	Type	Description
`code`	integer	รหัสสถานะ (`200` = สำเร็จ)
`message`	string	ข้อความตอบกลับ (`successfully en-queued`)
`payload.invalid_items`	array	รายการที่ไม่ผ่านการตรวจสอบเบื้องต้น (ถ้ามี)

Error Response (HTTP 400)


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "import_data must be a non-empty array",
    "Item 1: 'work_cycle_change_dt' must be in Y-m-d format"
  ]
}

Field	Type	Description
`code`	integer	รหัสสถานะ (`400` = ไม่สำเร็จ)
`message`	string	ข้อความแสดงข้อผิดพลาด
`errors`	array	รายการข้อผิดพลาดจากการ Validate (ถ้ามี)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/import" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorize_id": "U01DM0RFMEE5MTZCMUMyRTg=",
    "import_data": [
      {
        "status": "ADD",
        "employee_code": "EMP001",
        "work_cycle_change_dt": "2025-11-20",
        "work_cycle_id": "20251127D4573C421639",
        "work_cycle_change_desc": "เปลี่ยนกะด่วน"
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/import',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      authorize_id: 'U01DM0RFMEE5MTZCMUMyRTg=',
      import_data: [
        {
          status: 'ADD',
          employee_code: 'EMP001',
          work_cycle_change_dt: '2025-11-20',
          work_cycle_id: '20251127D4573C421639',
          work_cycle_change_desc: 'เปลี่ยนกะด่วน'
        }
      ]
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('นำเข้าสำเร็จ — รอประมวลผล')
  if (data.payload.invalid_items.length > 0) {
    console.warn('รายการที่ไม่ผ่าน:', data.payload.invalid_items)
  }
} else {
  console.error('Error:', data.errors)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/import"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "authorize_id": "U01DM0RFMEE5MTZCMUMyRTg=",
    "import_data": [
        {
            "status": "ADD",
            "employee_code": "EMP001",
            "work_cycle_change_dt": "2025-11-20",
            "work_cycle_id": "20251127D4573C421639",
            "work_cycle_change_desc": "เปลี่ยนกะด่วน"
        }
    ]
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('นำเข้าสำเร็จ — รอประมวลผล')
    if data['payload']['invalid_items']:
        print('รายการที่ไม่ผ่าน:', data['payload']['invalid_items'])
else:
    print('Error:', data.get('errors'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/import";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "authorize_id" => "U01DM0RFMEE5MTZCMUMyRTg=",
    "import_data" => [
        [
            "status" => "ADD",
            "employee_code" => "EMP001",
            "work_cycle_change_dt" => "2025-11-20",
            "work_cycle_id" => "20251127D4573C421639",
            "work_cycle_change_desc" => "เปลี่ยนกะด่วน"
        ]
    ]
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "นำเข้าสำเร็จ — รอประมวลผล\n";
} else {
    echo "Error: " . implode(', ', $data['errors'] ?? []);
}
 
curl_close($ch);
?>

Validation Rules

ระบบจะทำการตรวจสอบข้อมูลเบื้องต้นก่อนรับเข้าประมวลผล:

Rule	Description
โครงสร้างข้อมูล	`import_data` ต้องเป็น Array และไม่ว่างเปล่า
รหัสพนักงาน	`employee_code` ต้องมีอยู่ในระบบ
รูปแบบวันที่	`work_cycle_change_dt` ต้องอยู่ในรูปแบบ `YYYY-MM-DD`
พารามิเตอร์ที่จำเป็น	ต้องระบุครบทุก field บังคับตาม Status (`ADD`)

รายการที่ไม่ผ่านการตรวจสอบจะถูกเก็บไว้ใน payload.invalid_items ของ Response — หากไม่มีรายการใดผ่านเลย จะตอบกลับด้วย HTTP 400

Notes

การประมวลผลเป็นแบบ Asynchronous — Response สำเร็จหมายถึงรับเข้าคิวแล้ว ยังไม่รับประกันว่าบันทึกข้อมูลในระบบเสร็จสิ้น
รายการที่ผ่าน Validation จะถูก Auto-approve และ Execute ทันทีโดยอัตโนมัติ ไม่ผ่านขั้นตอนการอนุมัติปกติ

Use Cases

นำเข้าข้อมูลเปลี่ยนกะจำนวนมาก — ส่งทีละหลายร้อยรายการในคำขอเดียว
เชื่อมต่อกับระบบวางแผนกำลังพลภายนอก — Sync ตารางกะอัตโนมัติ

หา work_cycle_id

ใช้ Get Work Cycle Types เพื่อดู work_cycle_id ของกะทั้งหมด

Submit Change Request — ส่งเอกสารแบบปกติ (รอการอนุมัติ)
Get Work Cycle Types — ดูรายการกะ
Get Change List — ดึงรายการเอกสารเปลี่ยนกะ
Update Change Request — แก้ไขคำขอ
Delete Change Request — ลบคำขอ