Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Submit Employee Plan

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

Endpoint

POST /api/v1/open-apis/salary/update-data-filter?path_action=submit_employee_plan

Request Body

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
work_cycle_plan_idstringYesรหัสแผนกะ (Base64 encoded)"MjAyNjAxMTZDNzU4RDI2RjcyRkU"
  • ต้องกรอกข้อมูลกะงานหรือประเภทวันหยุดครบทุกวันในช่วงวันที่ของแผนก่อนส่ง
  • แผนต้องยังไม่อยู่ในสถานะที่ส่งแล้วหรือปิดแล้ว
  • หากต้องการแก้ไขหลังจากส่งแล้ว ต้องเรียกใช้ Unsubmit Employee Plan ก่อน

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": { "work_cycle_plan_id": "20260116C758D26F72FE", "employee_id": "202503219741427917A0", "employee_code": "EMP001", "submitted": true } }

Response Fields

FieldTypeDescription
work_cycle_plan_idstringรหัสแผนกะ (plain text 20 ตัวอักษร)
employee_idstringรหัสพนักงานในระบบ
employee_codestringรหัสพนักงาน
submittedbooleanสถานะการส่ง (true = ส่งสำเร็จ)

Error Responses

กรอกข้อมูลไม่ครบ (400)

{ "code": 400, "message": "กรุณากรอกแผนครบทุกวันก่อนส่งอนุมัติ (กรอกกะงานหรือประเภทวันหยุดทุกวัน)", "payload": [] }

หากได้รับ Error นี้ ให้ตรวจสอบและบันทึกข้อมูลกะงานหรือวันหยุดให้ครบทุกวันก่อนส่งอีกครั้ง

ไม่พบพนักงาน (404)

{ "code": 404, "message": "Employee not found with code: EMP001", "payload": [] }

ไม่พบแผนกะ (404)

{ "code": 404, "message": "Work cycle plan not found", "payload": [] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=submit_employee_plan" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "work_cycle_plan_id": "MjAyNjAxMTZDNzU4RDI2RjcyRkU" }'

Notes

  • การส่งแผนกะเป็นการยืนยันความพร้อมของข้อมูล ข้อมูลจะถูกล็อกไม่ให้แก้ไขระหว่างรออนุมัติ
  • ตรวจสอบสถานะ all_fill_set จาก Get Employee Plans by Month ว่าเป็น Y ก่อนส่ง
  • หากต้องการแก้ไขหลังจากส่งแล้ว ต้องเรียกใช้ Unsubmit Employee Plan ก่อน (เฉพาะกรณียังไม่ถูกอนุมัติ)

  • Save Employee Plan - บันทึกข้อมูลแผนกะรายวัน (ก่อนส่ง)
  • Unsubmit Employee Plan - ยกเลิกการส่งแผนกะ (เพื่อแก้ไข)
  • Get Employee Plan Detail - ดูรายละเอียดและความครบถ้วนของแผน
Last updated on