Get Organization Settings Summary

GET /api/v1/open-apis/salary/get-data-filter?path_action=get_organization_settings_summary

{
  "code": 200,
  "message": "Success",
  "payload": {
    "year_month": "2026-10",
    "is_snapshot": true,
    "salary_report_id": "20251127D4573C421639",
    "salary_report_start_dt": "2026-09-26 00:00:00",
    "salary_report_end_dt": "2026-10-25 23:59:59",
    "salary_split_flag": "N",
    "common_settings": {
      "salary_calculation": {
        "payroll_round": {
          "start_day": "26",
          "end_day": "25"
        },
        "split_round": {
          "split_round_code": "A",
          "split_count": 1,
          "split_mode": "Auto",
          "rounds": [],
          "split_calculate_type": "A",
          "split_calculate_type_text": "งวดสุดท้าย = งวดเต็ม - ผลรวมของงวดแยกก่อนหน้า"
        },
        "days_per_month": "30",
        "hours_per_day": "08:00",
        "ot_block": true,
        "decimal_rounding": false,
        "daily_employee_paid_holiday": false,
        "social_insurance": {
          "employee_rate": 5,
          "company_rate": 5
        }
      },
      "leave_quota": {
        "hours_per_day_quota": "08:00"
      },
      "attendance_recording": {
        "duplicate_punch_prevent_minutes": 1,
        "scans_per_day_policy": "2",
        "scans_per_day_policy_text": "สแกนนิ้ว 2 ครั้ง/วัน",
        "incomplete_scan_penalty": "half",
        "incomplete_scan_penalty_text": "ตัดขาดงาน ครึ่งวัน"
      },
      "other": {
        "days_per_month_for_inout": null,
        "days_per_month_for_adjust": null,
        "show_absence_on_holiday": true,
        "document_cut_off": {
          "enabled": false,
          "rules": {
            "time_leave": { "active": false, "cutoff_day": 1, "period_type": "Full" },
            "time_adjust": { "active": false, "cutoff_day": 1, "period_type": "Full" },
            "overtime": { "active": false, "cutoff_day": 1, "period_type": "Full" },
            "holiday_change": { "active": false, "cutoff_day": 1, "period_type": "Full" },
            "work_cycle_change": { "active": false, "cutoff_day": 1, "period_type": "Full" },
            "prevent_change_holiday": { "active": false, "cutoff_day": 1, "scope": "All" },
            "prevent_change_work_cycle": { "active": false, "cutoff_day": 1, "scope": "All" },
            "prevent_change_tax_deduction": { "active": false }
          }
        },
        "document_request_quotas": {
          "enabled": true,
          "quotas": {
            "time_leave": { "active": false, "limit": 1 },
            "time_adjust": { "active": true, "limit": 2 },
            "overtime": { "active": false, "limit": 1 },
            "holiday_change": { "active": false, "limit": 1 },
            "work_cycle_change": { "active": false, "limit": 1 },
            "salary_certificate": { "active": false, "limit": 1 },
            "work_certificate": { "active": false, "limit": 1 },
            "visa_certificate": { "active": false, "limit": 1 },
            "welfare": { "active": false, "limit": 1 },
            "emp_withdraw": { "active": false, "limit": 1 },
            "petty_cash": { "active": false, "limit": 1 }
          }
        },
        "organization_labels": {
          "company": { "th": "บริษัท", "en": "Company" },
          "branch": { "th": "สำนักงานสาขา", "en": "Branch" },
          "department": { "th": "แผนก", "en": "Department" },
          "division": { "th": "ฝ่ายงาน", "en": "Division" },
          "section": { "th": "หน่วยงาน", "en": "Section" },
          "section_lv01": { "th": "", "en": "" },
          "section_lv02": { "th": "", "en": "" },
          "section_lv03": { "th": "", "en": "" },
          "section_lv04": { "th": "", "en": "" },
          "section_lv05": { "th": "", "en": "" }
        }
      }
    },
    "work_time_settings": {
      "receive": [
        {
          "type_code": "morning",
          "type_name": "มาเช้า",
          "rules": [
            {
              "employee_type": "EMP_MONTHLY",
              "employee_type_text": "พนักงานรายเดือน",
              "action_active": true,
              "calculation_method": "A",
              "calculation_method_text": "ตามเรทค่าแรง",
              "calculation_value": 1,
              "tax_include": true,
              "sso_include": true,
              "provident_include": false,
              "emp_welfare_fund_include": false,
              "round_decimal_type": "N"
            }
          ]
        }
      ],
      "deduct": [
        {
          "type_code": "late",
          "type_name": "สาย",
          "rules": [
            {
              "employee_type": "EMP_MONTHLY",
              "employee_type_text": "พนักงานรายเดือน",
              "action_active": true,
              "calculation_method": "B",
              "calculation_method_text": "เป็นนาที (2 บาท/นาที)",
              "calculation_value": 2,
              "tax_include": true,
              "sso_include": true,
              "provident_include": false,
              "emp_welfare_fund_include": false,
              "round_decimal_type": "N"
            }
          ]
        }
      ],
      "overtime": [
        {
          "ot_code": "OT_1_5",
          "ot_multiplier": 1.5,
          "ot_name": "โอที 1.5 เท่า",
          "use_with": {
            "day_type": "A",
            "day_type_text": "วันทำงาน",
            "time_period": "B",
            "time_period_text": "นอกเวลากะ"
          },
          "lunch_include": true,
          "request_rule": {
            "type": "A",
            "days": 1,
            "text": "ขอล่วงหน้า 1 วัน"
          },
          "rules": [
            {
              "employee_type": "EMP_MONTHLY",
              "employee_type_text": "พนักงานรายเดือน",
              "calculation_method": "A",
              "calculation_value": 1.5,
              "max_ot_hours": 8,
              "decimal_rounding": "1",
              "tax_include": true,
              "sso_include": true,
              "provident_include": false,
              "emp_welfare_fund_include": false
            }
          ]
        }
      ]
    },
    "leave_type_settings": [
      {
        "leave_type_id": "20241225A1B2C3D4E5F6",
        "leave_flag_code": "03",
        "leave_type_name": "ลาป่วยมีใบรับรองแพทย์",
        "time_unit": "Daily",
        "time_unit_text": "วัน",
        "calculate_type": "A",
        "calculate_type_text": "ตามขั้นบันได",
        "gender_restriction": "A",
        "work_age_count": "B",
        "request_rules": {
          "day_max": 30
        },
        "deduction_rules": {
          "monthly": {
            "tax_include": true,
            "sso_include": true,
            "provident_include": false,
            "emp_welfare_fund_include": false
          },
          "daily": {
            "tax_include": true,
            "sso_include": true,
            "provident_include": false,
            "emp_welfare_fund_include": false
          },
          "contractor": {
            "tax_include": false,
            "sso_include": false,
            "provident_include": false,
            "emp_welfare_fund_include": false
          }
        },
        "quota_tiers": {
          "monthly": [
            { "worked_month": 0, "quota": "30 วัน", "quota_value": 30 }
          ],
          "daily": [
            { "worked_month": 0, "quota": "30 วัน", "quota_value": 30 }
          ],
          "contractor": []
        }
      }
    ],
    "salary_type_settings": {
      "income": [
        {
          "salary_type_id": "20250101AAAA11112222",
          "salary_group_id": "20250101BBBB33334444",
          "salary_type_code": "ST0001",
          "salary_type_name": "คอมมิชชั่น",
          "salary_type_name_en": "Commission",
          "calculate_method": "Income",
          "tax_type": "1",
          "round_decimal": false,
          "order_no": 1,
          "tax_include": true,
          "sso_include": true,
          "social_insurance_include": true,
          "provident_include": false,
          "emp_welfare_fund_include": false,
          "tax_resign_include": true,
          "bank_link": {
            "bank_id": "0",
            "bank_name": "ไม่ผูกบัญชี"
          }
        }
      ],
      "expense": [
        {
          "salary_type_id": "20250101CCCC55556666",
          "salary_group_id": null,
          "salary_type_code": "employee_welfare_fund",
          "salary_type_name": "กองทุนสงเคราะห์ลูกจ้าง",
          "salary_type_name_en": "Employee Welfare Fund",
          "calculate_method": "Fund",
          "tax_type": "1",
          "round_decimal": false,
          "order_no": 2,
          "tax_include": false,
          "sso_include": false,
          "social_insurance_include": false,
          "provident_include": false,
          "emp_welfare_fund_include": false,
          "tax_resign_include": false,
          "bank_link": {
            "bank_id": "4",
            "bank_name": "KBANK"
          },
          "fund_data": {
            "fund_id": "20250101DDDD77778888",
            "salary_type_id": "20250101CCCC55556666",
            "fund_code": "FD0001",
            "fund_name": "กองทุนสงเคราะห์ลูกจ้าง",
            "fund_desc": null,
            "fund_balance": "125000.00",
            "bank_id": "4",
            "order_no": "1"
          }
        }
      ]
    }
  }
}

{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "'year_month' ไม่ถูกต้อง ต้องเป็นรูปแบบ YYYY-MM เช่น 2026-10"
  ]
}

{
  "code": 403,
  "message": "Forbidden: Insufficient permissions",
  "error": {
    "type": "PERMISSION_DENIED",
    "required_permission": "payroll:read:all",
    "resource": "payroll:read:all"
  }
}

{
  "statusCode": 401,
  "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}