Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Import Visa Certificate (Bulk)

นำเข้าเอกสารขอหนังสือรับรองเพื่อขอวีซ่าจำนวนมากพร้อมกัน (Bulk Import) ผ่าน JSON Array

ระบบจะตรวจสอบความถูกต้องของข้อมูลทั้งหมดก่อน รายการที่ถูกต้องจะถูกส่งไปประมวลผลในเบื้องหลัง รายการที่ผิดพลาดจะถูกแจ้งกลับพร้อม index และรายละเอียดข้อผิดพลาด

Endpoint

POST /api/v1/open-apis/visa-certificate/import

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
import_dataarrayYesชุดข้อมูลรายการเอกสารนำเข้าดูโครงสร้างด้านล่าง

โครงสร้างข้อมูลใน import_data

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
passport_nostringYesหมายเลขพาสปอร์ต"AA1234567"
country_visitstringYesประเทศที่จะเดินทาง"Japan"
travel_start_dtstringYesวันที่เริ่มเดินทาง (YYYY-MM-DD)"2026-04-10"
travel_end_dtstringYesวันที่สิ้นสุดการเดินทาง (YYYY-MM-DD)"2026-04-15"
request_purposestringYesวัตถุประสงค์การขอ"ท่องเที่ยว"
send_doc_addressstringYesสถานที่จัดส่งเอกสาร/สถานทูต"Embassy of Japan"
doc_languagestringYesภาษาบนเอกสาร (TH หรือ EN)"EN"
return_dtstringNoวันที่เดินทางกลับ (YYYY-MM-DD)"2026-04-16"
publish_flagstringNoเผยแพร่เอกสาร (Y / N)"Y"

Response Format

Success Response - All Valid (HTTP 200)

{ "code": 200, "message": "Successfully enqueued for processing", "payload": { "valid_items_count": 1, "invalid_items": [] } }

Success Response - Partial (HTTP 200)

{ "code": 200, "message": "Successfully enqueued for processing", "payload": { "valid_items_count": 0, "invalid_items": [ { "index": 0, "data": { "employee_code": "999999", "doc_language": "TH" }, "errors": ["Employee not found: '999999'", "Missing 'request_purpose'"] } ] } }

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": ["No valid data to import"] }

Response Fields

FieldTypeDescription
valid_items_countnumberจำนวนรายการที่ถูกต้องและส่งไปประมวลผล
invalid_itemsarrayรายการที่ไม่ถูกต้องพร้อมรายละเอียดข้อผิดพลาด
invalid_items[].indexnumberลำดับ index ของรายการที่ผิดพลาด
invalid_items[].dataobjectข้อมูลบางส่วนของรายการที่ผิดพลาด
invalid_items[].errorsarrayรายการข้อผิดพลาด

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/import" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "import_data": [ { "employee_code": "EMP001", "passport_no": "AA1234567", "country_visit": "Japan", "travel_start_dt": "2026-04-10", "travel_end_dt": "2026-04-15", "return_dt": "2026-04-16", "request_purpose": "For tourist visa application", "send_doc_address": "Embassy of Japan, Bangkok", "doc_language": "EN" } ] }'

Notes

ข้อกำหนดสำคัญ:

  • import_data ต้องเป็น Array อย่างน้อย 1 รายการ
  • employee_code ต้องเป็นรหัสพนักงานที่มีอยู่ในระบบ
  • travel_end_dt ต้องมากกว่าหรือเท่ากับ travel_start_dt
  • รายการที่ถูกต้องจะถูกส่งไปประมวลผลในเบื้องหลัง (Async) เสมือนการเรียก Submit ทีละรายการ
  • รายการที่ผิดพลาดจะถูกแจ้งกลับพร้อม index ช่วยให้ตรวจสอบได้ง่าย
  • Get List - ดูรายการเอกสารทั้งหมดหลังนำเข้า
  • Submit - สร้างเอกสารทีละ 1 ฉบับ
Last updated on