Update Work Certificate
แก้ไขเอกสารหนังสือรับรองการทำงาน รองรับทั้งการแก้ไขข้อมูลและเปลี่ยนสถานะเอกสาร
สำหรับการอนุมัติ/ปฏิเสธเอกสารโดยเฉพาะ แนะนำใช้ Approve API แทน
Endpoint
POST /api/v1/open-apis/work-certificate/updateRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
work_certificate_letter_id | string (base64) | Yes | รหัสเอกสาร (base64 encoded) | "MjAyNjAzMDVXQzAwMDAwMDAwMQ==" |
Optional Parameters (ต้องระบุอย่างน้อย 1 ฟิลด์)
| Parameter | Type | Description | Example |
|---|---|---|---|
request_topic | string | หัวข้อคำขอ | "ขอหนังสือรับรองการทำงาน" |
request_purpose | string | วัตถุประสงค์ | "เพื่อใช้ยื่นวีซ่า" |
send_doc_address | string | ที่อยู่จัดส่ง | "สถานทูตญี่ปุ่น กรุงเทพฯ" |
doc_language | string | ภาษาเอกสาร (TH/EN) | "EN" |
publish_flag | string | สถานะเผยแพร่ (Y/N) | "Y" |
document_flow_lv | string | เปลี่ยนสถานะเอกสาร | "02" |
Request Body Example
{
"work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
"request_purpose": "เพื่อใช้ยื่นวีซ่า",
"send_doc_address": "สถานทูตญี่ปุ่น กรุงเทพฯ"
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "แก้ไขเอกสารรับรองการทำงานสำเร็จ",
"payload": {
"work_certificate_letter_id": "20260305WC000000001",
"employee_id": "20260309462FEF65EFCA",
"employee_first_name": "ธาวัน",
"employee_last_name": "รายเดือน",
"request_purpose": "เพื่อใช้ยื่นวีซ่า",
"send_doc_address": "สถานทูตญี่ปุ่น กรุงเทพฯ",
"document_flow_lv": "01",
"doc_language": "TH"
}
}Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": ["Missing required parameter: 'work_certificate_letter_id'"]
}Error Response - Certificate Not Found (HTTP 404)
{
"code": 404,
"message": "Certificate not found"
}Error Response - Already Approved (HTTP 400)
{
"code": 400,
"message": "Cannot change approved certificate back to pending"
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
work_certificate_letter_id | string | No | รหัสเอกสาร (plain text) |
employee_id | string | No | รหัสพนักงาน (plain text) |
employee_first_name | string | No | ชื่อพนักงาน |
employee_last_name | string | No | นามสกุลพนักงาน |
request_purpose | string | No | วัตถุประสงค์ที่อัปเดต |
send_doc_address | string | No | ที่อยู่จัดส่งที่อัปเดต |
document_flow_lv | string | No | สถานะเอกสารล่าสุด |
doc_language | string | No | ภาษาเอกสาร |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/update" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
"request_purpose": "เพื่อใช้ยื่นวีซ่า",
"send_doc_address": "สถานทูตญี่ปุ่น กรุงเทพฯ"
}'Notes
ข้อควรทราบ:
work_certificate_letter_idใน request ต้องเข้ารหัส base64, ใน response เป็น plain text- ห้ามเปลี่ยนจากสถานะ
02(อนุมัติแล้ว) กลับเป็น01(รออนุมัติ) - ถ้ามีการเปลี่ยน
document_flow_lvจะประมวลผลเหมือน Approve API - สำหรับการอนุมัติ/ปฏิเสธโดยเฉพาะ แนะนำใช้ Approve API แทน
Related APIs
- Get Detail - ดูรายละเอียดเอกสารก่อนแก้ไข
- Approve - อนุมัติเอกสาร (แนะนำใช้แทน update สำหรับการอนุมัติ)
- Get List - ดูรายการเอกสารเพื่อเลือกแก้ไข
Last updated on