Submit Complaint

ยื่นคำขอสร้างเอกสารร้องเรียนพนักงานใหม่เข้าสู่ระบบ โดยเอกสารที่สร้างขึ้นใหม่จะเริ่มต้นด้วยสถานะรอพิจารณา (Waiting for consideration)

ระบบจะค้นหาข้อมูลพนักงานผู้ร้องเรียนจาก informer_employee_code เป็นลำดับแรก หากไม่พบจะค้นหาจาก informer_employee_id

Endpoint


POST /api/v1/open-apis/complaint/submit

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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`complaint_dt`	string	Yes	วันที่ร้องเรียน (YYYY-MM-DD)	`2026-03-30`
`complaint_type_lv`	string	Yes	รหัสประเภทการร้องเรียน	`01`
`complaint_desc`	string	Yes	รายละเอียดการชี้แจง / เหตุการณ์ที่ร้องเรียน	`พบเห็นการทุจริตในเวลางาน`
`informer_employee_code`	string	Yes*	รหัสพนักงานผู้ร้องเรียน (*บังคับอย่างใดอย่างหนึ่งระหว่าง _code หรือ _id)	`EMP001`
`informer_employee_id`	string (base64)	Yes*	ID ของผู้ร้องเรียน (Base64 encoded) (*บังคับอย่างใดอย่างหนึ่งระหว่าง _code หรือ _id)	`MjAyNTExMjdENDU3M0M0MjE2Mzk=`

Optional Parameters

Parameter	Type	Required	Description	Example
`complaint_visible_lv`	string	No	ระดับการแสดงตัวตนของผู้ร้องเรียน (`N` = ไม่เปิดเผยข้อมูล)	`N`
`complaint_attachment`	string	No	รูปภาพหลักฐานแนบแบบ Base64 — ส่งเป็น Base64 ล้วน หรือเป็น Data URI ที่ขึ้นต้นด้วย `data:image/` ก็ได้	`iVBORw0KGgoAAAANSUhEUg...`

Complaint Type Values (`complaint_type_lv`)

Value	EN	TH
`01`	Corruption	ทุจริต
`02`	Breaking the rules	ไม่ปฏิบัติตามกฎระเบียบ
`03`	Bullied, Intimidated	ถูกกลั่นแกล้ง ข่มขู่
`04`	Work failed	ปฏิบัติงานผิดพลาด
`05`	Working behavior	พฤติกรรมการทำงาน
`06`	Others	อื่นๆ

Request Body Example


{
  "complaint_dt": "2026-03-30",
  "complaint_type_lv": "01",
  "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
  "informer_employee_code": "EMP001",
  "complaint_visible_lv": "N"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "ร้องเรียนสำเร็จ",
  "payload": {
    "complaint_id": "20251127D4573C421639",
    "complaint_dt": "2026-03-30",
    "complaint_type_lv": "01",
    "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
    "complaint_employee_id": "",
    "informer_employee_id": "20251127D4573C421639",
    "complaint_status_lv": "01",
    "complaint_visible_lv": "N",
    "complaint_attachment": null,
    "message": "ร้องเรียนสำเร็จ"
  }
}

ตัวอย่าง complaint_attachment เมื่อแนบรูปภาพมาด้วย:


"complaint_attachment": "https://cdn.humansoft.co.th/.../image/a1B2c3D4e5.png"

Response Fields

Field	Type	Description
`complaint_id`	string	รหัสเอกสารร้องเรียนที่สร้าง
`complaint_dt`	string	วันที่ร้องเรียน
`complaint_type_lv`	string	รหัสประเภทการร้องเรียน
`complaint_desc`	string	รายละเอียดการร้องเรียน
`complaint_employee_id`	string	ID ของพนักงานที่ถูกร้องเรียน
`informer_employee_id`	string	ID ของผู้ร้องเรียน
`complaint_status_lv`	string	สถานะเอกสาร (เริ่มต้นที่ `01` - รอพิจารณา)
`complaint_visible_lv`	string	ระดับการแสดงตัวตน
`complaint_attachment`	string \| null	URL ของรูปภาพหลักฐานแนบ (`null` หากไม่ได้แนบรูปภาพ)
`message`	string	ข้อความผลการทำรายการ (เหมือนกับ `message` ระดับบนสุด)

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "การตรวจสอบข้อมูลล้มเหลว",
  "errors": [
    "'complaint_dt' is required"
  ]
}

Error Response - Employee Not Found (HTTP 400)


{
  "code": 400,
  "message": "กระบวนการล้มเหลว",
  "error": "ไม่พบข้อมูลพนักงาน"
}

ข้อความใน message และ error เป็นภาษาไทยโดยค่าเริ่มต้น หากส่ง language_code=EN จะได้ข้อความภาษาอังกฤษ (เช่น Validation failed, Process failed, Employee not found) ส่วนรายการใน errors เป็นภาษาอังกฤษเสมอ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/complaint/submit" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "complaint_dt": "2026-03-30",
    "complaint_type_lv": "01",
    "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
    "informer_employee_code": "EMP001",
    "complaint_visible_lv": "N"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/complaint/submit',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      complaint_dt: '2026-03-30',
      complaint_type_lv: '01',
      complaint_desc: 'พบเห็นการทุจริตการเบิกจ่ายงบประมาณ',
      informer_employee_code: 'EMP001',
      complaint_visible_lv: 'N'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('สร้างเอกสารร้องเรียนสำเร็จ:', data.payload.complaint_id)
} else {
  console.error('Error:', data.errors || data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/complaint/submit"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "complaint_dt": "2026-03-30",
    "complaint_type_lv": "01",
    "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
    "informer_employee_code": "EMP001",
    "complaint_visible_lv": "N"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('สร้างเอกสารร้องเรียนสำเร็จ:', data['payload']['complaint_id'])
else:
    print('Error:', data.get('errors') or data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/complaint/submit";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "complaint_dt" => "2026-03-30",
    "complaint_type_lv" => "01",
    "complaint_desc" => "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
    "informer_employee_code" => "EMP001",
    "complaint_visible_lv" => "N"
];
 
$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 "สร้างเอกสารร้องเรียนสำเร็จ: " . $data['payload']['complaint_id'] . "\n";
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['error']);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

หากกำหนด complaint_visible_lv เป็น N ชื่อผู้ร้องเรียนในฟีดของ HR จะแสดงเป็น “ไม่เปิดเผยข้อมูล” (Anonymous)
รูปภาพที่ส่งมาเป็น Base64 ไม่ควรมีขนาดใหญ่มากเกินไป เพราะจะกระทบกับประสิทธิภาพ
ต้องระบุ informer_employee_code หรือ informer_employee_id อย่างน้อยหนึ่งค่า
พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64 encoded

Get List - ดูประวัติและรายการร้องเรียนพนักงานทั้งหมด
Get Detail - ดูรายละเอียดเรื่องร้องเรียนเฉพาะรายการ