Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Create Calculate Queue

ส่งคำขอคำนวณโควตาเข้าคิวเพื่อประมวลผลแบบ Asynchronous เหมาะสำหรับการคำนวณจำนวนพนักงานมาก

Endpoint

POST /api/v1/open-apis/salary/update-data-filter

Request Body

ParameterTypeRequiredDescriptionExample
path_actionstringYesต้องเป็น create_calculate_quota_queue"create_calculate_quota_queue"
quota_yearstringYes*ปีโควตา (YYYY) ต้องระบุอย่างน้อยหนึ่ง field"2026"
year_monthstringYes*เดือน/ปี (YYYY-MM) ต้องระบุอย่างน้อยหนึ่ง field"2026-03"
company_idstringNoกรองตามบริษัท (Base64)-
branch_idstringNoกรองตามสาขา (Base64)-
department_idstringNoกรองตามแผนก (Base64)-
position_idstringNoกรองตามตำแหน่ง (Base64)-
employee_idstringNoเฉพาะพนักงานคนเดียว (Base64)-
keywordstringNoค้นหาพนักงาน-

ต้องระบุ quota_year หรือ year_month อย่างน้อยหนึ่งตัว


Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": { "queue_id": "20260220QU01A2B3C4D5", "status": "queued", "created_at": "2026-02-20 16:00:00" } }

Response Fields

FieldTypeDescription
queue_idstringID คิว (plain text)
statusstringสถานะ: "queued" = อยู่ในคิว
created_atstringวันเวลาที่สร้างคิว

Error Response

{ "code": 400, "message": "ไม่สำเร็จ", "errors": ["Missing required parameter: 'quota_year' or 'year_month'"] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "path_action": "create_calculate_quota_queue", "quota_year": "2026" }'

Notes

  • ข้อมูลจะถูกประมวลผลแบบ Asynchronous API จะตอบกลับทันทีหลัง validate สำเร็จ
  • ใช้แทน Calculate Quota เมื่อมีพนักงานจำนวนมากเพื่อหลีกเลี่ยง timeout
  • ผลลัพธ์จะถูกอัปเดตในระบบเมื่อประมวลผลเสร็จ

  • Calculate Quota - คำนวณโควตาแบบ Synchronous (พนักงานน้อย)
  • Calculate Year - ปรับปีที่นับโควตา
  • Reset Quota - รีเซ็ตโควตา
Last updated on