Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Work Certificate List

ดึงรายการเอกสารหนังสือรับรองการทำงาน พร้อมตัวกรองโครงสร้างองค์กร สายการอนุมัติ และการแบ่งหน้า

ผลลัพธ์จัดกลุ่มตามพนักงาน แต่ละพนักงานมี profile และ docs array รองรับการแสดงผลบน Dashboard หรือ Mobile App

Endpoint

GET /api/v1/open-apis/work-certificate/get-list

หรือ

POST /api/v1/open-apis/work-certificate/get-list

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
document_flow_lvstringYesสถานะเอกสาร (ดู Option Values)"01"
req_yearstring (YYYY)Yesปีที่ขอเอกสาร (4 หลัก)"2026"

Optional Parameters

ParameterTypeDefaultDescriptionExample
req_monthstring (MM)-เดือนที่ขอเอกสาร (01-12)"03"
from_dtstring (YYYY-MM-DD)-วันที่เริ่มต้นช่วงกรอง"2026-01-01"
to_dtstring (YYYY-MM-DD)-วันที่สิ้นสุดช่วงกรอง"2026-03-31"
authorize_linebooleanfalseเปิดกรองตามสายการอนุมัติtrue
platformstring-ระบุ platform"web-hrs"
select_channel_idstring (base64)-รหัส channel (base64 encoded)"MjAyNDExMTM0OTVDMEFDNDZGREU="
hashtagsarray-กรองตาม hashtag["งานขาย", "IT"]
employee_listsarray-กรองตามพนักงาน (array ของ {id})ดูตัวอย่าง
company_listsarray-กรองตามบริษัท (array ของ {id})ดูตัวอย่าง
branch_listsarray-กรองตามสาขา (array ของ {id})ดูตัวอย่าง
department_listsarray-กรองตามแผนก (array ของ {id})ดูตัวอย่าง
division_listsarray-กรองตามฝ่าย (array ของ {id})ดูตัวอย่าง
section_listsarray-กรองตามแผนกย่อย (array ของ {id})ดูตัวอย่าง
position_listsarray-กรองตามตำแหน่ง (array ของ {id})ดูตัวอย่าง
_PAGEinteger1หน้าปัจจุบัน1
_NUMBER_PER_PAGEinteger-จำนวนรายการต่อหน้า (1-1000)20

List Parameters Structure

ทุก *_lists parameter ต้องเป็น array ของ object ที่มี id เป็น base64 encoded:

[ {"id": "MjAyNjAzMDk0NjI1RUY2NUVGQ0E="}, {"id": "MjAyNjAzMDk0NjI1RUY2NUVGQ0I="} ]

Document Flow Level Values

Valueความหมาย (TH)ความหมาย (EN)กรองรวม
01รออนุมัติPending Approvalรวม 01, 06, 07-11
02อนุมัติแล้วApprovedเฉพาะ 02
03ไม่อนุมัติNot Approvedเฉพาะ 03
04ส่งเอกสารแล้วSent Documentเฉพาะ 04
05ได้รับเอกสารแล้วReceive Documentเฉพาะ 05
07หัวหน้าอนุมัติManager Approvedรวม 07-11

เมื่อกรองด้วย 01 ระบบจะรวมสถานะ 01, 06, 07-11 (ทุกสถานะที่ยังไม่ผ่านการอนุมัติขั้นสุดท้าย) from_dt และ to_dt มีลำดับความสำคัญสูงกว่า req_year / req_month

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": [ { "profile": { "employee_id": "20260309462FEF65EFCA", "employee_code": "EMP001", "photograph": "images/userPlaceHolder.png", "employee_name": "ธาวัน", "employee_last_name": "รายเดือน", "employee_nickname": "วัน", "position_name": "นักพัฒนาระบบ", "department_name": "ฝ่ายไอที", "division_name": "", "section_name": "", "branch_name": "สำนักงานใหญ่", "count_docs": 2 }, "docs": [ { "doc_type": "Work_Certificate", "doc_id": "20260305WC000000001", "employee_id": "20260309462FEF65EFCA", "approve_by": "สมชาย ผู้จัดการ", "header": "ขอหนังสือรับรองการทำงาน", "detail": "เพื่อใช้สมัครงานใหม่", "status_detail": "รออนุมัติ", "status": "รออนุมัติ", "authorize_flag": true, "created": "2026-03-09 11:00:00", "created_format": "09/03/2026 11:00", "send_doc_address": "บริษัท ABC จำกัด", "document_flow_lv": "01", "doc_approver_name": null, "doc_detail": { "...": "..." } } ] } ], "_PAGINATION": { "_TOTAL_RECORDS": 5, "_PAGE": 1, "_NUMBER_PER_PAGE": 20 } }

Empty Result Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": [], "_PAGINATION": { "_TOTAL_RECORDS": 0, "_PAGE": 1, "_NUMBER_PER_PAGE": 0 } }

Error Response - Validation Failed (HTTP 400)

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

Response Fields

Profile (โปรไฟล์พนักงาน)

FieldTypeNullableDescription
employee_idstringNoรหัสพนักงาน (plain text)
employee_codestringNoรหัสพนักงาน
photographstringNoURL รูปภาพ
employee_namestringNoชื่อพนักงาน
employee_last_namestringNoนามสกุลพนักงาน
employee_nicknamestringNoชื่อเล่น
position_namestringNoตำแหน่ง
department_namestringNoแผนก
division_namestringYesฝ่าย
section_namestringYesแผนกย่อย
branch_namestringNoสาขา
count_docsintegerNoจำนวนเอกสาร

Docs (รายการเอกสาร)

FieldTypeNullableDescription
doc_typestringNoประเภทเอกสาร ("Work_Certificate")
doc_idstringNoรหัสเอกสาร (plain text)
employee_idstringNoรหัสพนักงาน
approve_bystringYesชื่อผู้อนุมัติ
headerstringNoหัวข้อเอกสาร
detailstringNoรายละเอียดเอกสาร
status_detailstringNoรายละเอียดสถานะ
statusstringNoชื่อสถานะเอกสาร
authorize_flagbooleanNoสิทธิ์อนุมัติตามสายงาน
createdstringNoวันเวลาสร้าง (YYYY-MM-DD HH:mm:ss)
created_formatstringNoวันเวลาสร้าง format (DD/MM/YYYY HH:mm)
send_doc_addressstringYesที่อยู่จัดส่ง
document_flow_lvstringNoสถานะเอกสาร (จัดกลุ่มแล้ว)
doc_approver_namestringYesชื่อผู้อนุมัติเอกสาร
doc_detailobjectNoข้อมูลเอกสารเต็ม

Pagination

FieldTypeNullableDescription
_TOTAL_RECORDSintegerNoจำนวนเอกสารทั้งหมด
_PAGEintegerNoหน้าปัจจุบัน
_NUMBER_PER_PAGEintegerNoจำนวนรายการต่อหน้า

Code Examples

# ดูรายการเอกสารรออนุมัติ ปี 2026 curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-list?document_flow_lv=01&req_year=2026&_PAGE=1&_NUMBER_PER_PAGE=20" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" # ดูเอกสารอนุมัติแล้ว เดือนมีนาคม 2026 curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-list?document_flow_lv=02&req_year=2026&req_month=03" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json"

Notes

ข้อควรทราบ:

  • ฟิลด์ _id ใน response เป็น plain text, ใน request (เช่น employee_lists, company_lists) ต้องเข้ารหัส base64
  • document_flow_lv ใน response จะถูกจัดกลุ่ม: สถานะ 01, 06, 07-11 จะแสดงเป็น 01
  • หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน ต่างจากหนังสือรับรองเงินเดือน
  • from_dt และ to_dt มีลำดับความสำคัญสูงกว่า req_year / req_month
  • Get Detail - ดูรายละเอียดเอกสาร (ใช้ doc_id จาก response)
  • Submit - สร้างเอกสารใหม่
  • Approve - อนุมัติเอกสารที่เลือกจากรายการ
  • Update - แก้ไขเอกสารที่เลือกจากรายการ
  • Delete - ลบเอกสารที่เลือกจากรายการ
  • Export PDF - สร้าง PDF ของเอกสาร
Last updated on