Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Visa Certificate List

ดึงรายการเอกสารขอหนังสือรับรองเพื่อยื่นขอวีซ่า รองรับตัวกรองหลากหลาย เช่น สถานะเอกสาร โครงสร้างองค์กร วันที่ พร้อมระบบแบ่งหน้า (Pagination)

Endpoint

GET /api/v1/open-apis/visa-certificate/get-list POST /api/v1/open-apis/visa-certificate/get-list

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
document_flow_lvstringYesสถานะเอกสาร"01"
req_yearstringYesปีที่ขอเอกสาร (YYYY)"2026"

Optional Parameters

ParameterTypeRequiredDescriptionExample
req_monthstringNoเดือนที่ขอเอกสาร (MM)"04"
from_dtstringNoวันที่เริ่มต้น (YYYY-MM-DD)"2026-04-01"
to_dtstringNoวันที่สิ้นสุด (YYYY-MM-DD)"2026-04-30"
authorize_linebooleanNoดึงสำหรับผู้อนุมัติพิจารณา ค่าเริ่มต้น: falsetrue
hashtagsarrayNoกรอง hashtag พนักงาน["IT"]
employee_listsarrayNoกรองพนักงาน (Base64 id)[{"id": "..."}]
company_listsarrayNoกรองเฉพาะบริษัท (Base64 id)[{"id": "..."}]
branch_listsarrayNoกรองตามสาขา (Base64 id)[{"id": "..."}]
department_listsarrayNoกรองตามแผนก (Base64 id)[{"id": "..."}]
division_listsarrayNoกรองตามฝ่าย (Base64 id)[{"id": "..."}]
_PAGEintegerNoหน้าที่ต้องการดึง ค่าเริ่มต้น: 11
_NUMBER_PER_PAGEintegerNoจำนวนรายการต่อหน้า20

Document Flow Level Values

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

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": [ { "profile": { "employee_id": "20260309462FEF65EFCA", "employee_code": "EMP001", "employee_name": "Tawan", "employee_last_name": "Raiduen", "position_name": "Software Developer", "department_name": "IT", "branch_name": "Head Office", "count_docs": 1 }, "docs": [ { "doc_type": "Visa_Certificate", "doc_id": "20260312VC000000001", "employee_id": "20260309462FEF65EFCA", "header": "ขอหนังสือรับรองสำหรับวีซ่า", "detail": "ยื่นที่สถานทูตญี่ปุ่น", "status_detail": "Pending Approval", "status": "Pending Approval", "authorize_flag": true, "created": "2026-03-12 10:00:00", "created_format": "12/03/2026 10:00", "send_doc_address": "Embassy of Japan", "document_flow_lv": "01", "doc_detail": { "passport_no": "AA1234567", "country_visit": "Japan" } } ] } ], "_PAGINATION": { "_TOTAL_RECORDS": 1, "_PAGE": 1, "_NUMBER_PER_PAGE": 20 } }

Error Response - Validation Failed (HTTP 400)

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

Response Fields

FieldTypeDescription
profileobjectข้อมูลประวัติพนักงานที่จัดกลุ่ม
profile.employee_idstringรหัสพนักงาน
profile.employee_codestringรหัสพนักงาน (code)
profile.employee_namestringชื่อพนักงาน
profile.employee_last_namestringนามสกุลพนักงาน
profile.position_namestringชื่อตำแหน่ง
profile.department_namestringชื่อแผนก
profile.branch_namestringชื่อสาขา
profile.count_docsnumberจำนวนเอกสารของพนักงาน
docsarrayรายการเอกสารทั้งหมดในกลุ่ม
docs[].doc_idstringรหัสเอกสาร
docs[].document_flow_lvstringสถานะเอกสาร
docs[].statusstringชื่อสถานะ
docs[].authorize_flagbooleanสิทธิ์อนุมัติ
docs[].doc_detailobjectรายละเอียดเอกสาร (passport_no, country_visit)
_PAGINATIONobjectข้อมูลการแบ่งหน้า
_PAGINATION._TOTAL_RECORDSnumberจำนวนรายการทั้งหมด
_PAGINATION._PAGEnumberหน้าปัจจุบัน
_PAGINATION._NUMBER_PER_PAGEnumberจำนวนรายการต่อหน้า

Code Examples

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/get-list?document_flow_lv=01&req_year=2026&_PAGE=1&_NUMBER_PER_PAGE=20" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

หมายเหตุ:

  • ข้อมูลจะถูกจัดกลุ่มตามพนักงาน โดยแต่ละกลุ่มมี profile และ docs แยกกัน
  • เมื่อกรองสถานะ 01 ระบบจะรวมเอกสารสถานะ 01, 06, 07-11 มาแสดงด้วย
  • รองรับตัวกรองโครงสร้างองค์กร เช่น company_lists, branch_lists, department_lists, division_lists
  • ชื่อและตำแหน่งของพนักงานจะถูกแปลงภาษาตามการตั้งค่าอัตโนมัติ
  • Get Detail - ดูรายละเอียดเอกสารแต่ละฉบับ
  • Approve - อนุมัติเอกสาร
  • Update - แก้ไขเอกสาร
Last updated on