Calculate Quota
คำนวณโควตาการลาจากข้อมูลการลาจริงในระบบ ใช้สำหรับ sync ข้อมูลและปรับยอดโควตาให้ตรงกับข้อมูลจริง
Endpoint
POST /api/v1/open-apis/salary/update-data-filterRequest Body
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
path_action | string | Yes | ต้องเป็น calculate_quota | "calculate_quota" |
quota_year | string | Yes | ปีโควตา (YYYY) | "2026" |
company_id | string | No | กรองตามบริษัท (Base64) | - |
branch_id | string | No | กรองตามสาขา (Base64) | - |
department_id | string | No | กรองตามแผนก (Base64) | - |
position_id | string | No | กรองตามตำแหน่ง (Base64) | - |
employee_id | string | No | คำนวณเฉพาะพนักงานคนเดียว (Base64) | - |
keyword | string | No | ค้นหาพนักงาน | - |
employee_type_code | array | No | กรองตามประเภทพนักงาน | ["01", "02"] |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"calculated_employees": 50,
"updated_quotas": 120
}
}Response Fields
| Field | Type | Description |
|---|---|---|
calculated_employees | number | จำนวนพนักงานที่คำนวณ |
updated_quotas | number | จำนวนโควตาที่อัปเดต |
Error Response
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": ["Missing required parameter: 'quota_year'"]
}Code Examples
cURL
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": "calculate_quota",
"quota_year": "2026"
}'Notes
- API นี้ sync ข้อมูลการลาจริงกับยอดโควตา ใช้เมื่อยอด actual ไม่ตรงกับข้อมูลจริง
- ถ้ามีพนักงานจำนวนมาก ให้ใช้ Create Calculate Queue แทนเพื่อประมวลผลแบบ Asynchronous
- ใช้ filter เพื่อจำกัดขอบเขตการคำนวณ
Related APIs
- Create Calculate Queue - คำนวณแบบ Asynchronous
- Reset Quota - รีเซ็ตและคำนวณโควตาใหม่
- Calculate Year - ปรับปีที่นับโควตา
Last updated on