Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Update Work Certificate

แก้ไขเอกสารหนังสือรับรองการทำงาน รองรับทั้งการแก้ไขข้อมูลและเปลี่ยนสถานะเอกสาร

สำหรับการอนุมัติ/ปฏิเสธเอกสารโดยเฉพาะ แนะนำใช้ Approve API แทน

Endpoint

POST /api/v1/open-apis/work-certificate/update

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
work_certificate_letter_idstring (base64)Yesรหัสเอกสาร (base64 encoded)"MjAyNjAzMDVXQzAwMDAwMDAwMQ=="

Optional Parameters (ต้องระบุอย่างน้อย 1 ฟิลด์)

ParameterTypeDescriptionExample
request_topicstringหัวข้อคำขอ"ขอหนังสือรับรองการทำงาน"
request_purposestringวัตถุประสงค์"เพื่อใช้ยื่นวีซ่า"
send_doc_addressstringที่อยู่จัดส่ง"สถานทูตญี่ปุ่น กรุงเทพฯ"
doc_languagestringภาษาเอกสาร (TH/EN)"EN"
publish_flagstringสถานะเผยแพร่ (Y/N)"Y"
document_flow_lvstringเปลี่ยนสถานะเอกสาร"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

FieldTypeNullableDescription
work_certificate_letter_idstringNoรหัสเอกสาร (plain text)
employee_idstringNoรหัสพนักงาน (plain text)
employee_first_namestringNoชื่อพนักงาน
employee_last_namestringNoนามสกุลพนักงาน
request_purposestringNoวัตถุประสงค์ที่อัปเดต
send_doc_addressstringNoที่อยู่จัดส่งที่อัปเดต
document_flow_lvstringNoสถานะเอกสารล่าสุด
doc_languagestringNoภาษาเอกสาร

Code Examples

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 แทน
  • Get Detail - ดูรายละเอียดเอกสารก่อนแก้ไข
  • Approve - อนุมัติเอกสาร (แนะนำใช้แทน update สำหรับการอนุมัติ)
  • Get List - ดูรายการเอกสารเพื่อเลือกแก้ไข
Last updated on