{"version":"1.0.0","documentation":"https://www.havahr.com/developers","openapi":"https://www.havahr.com/openapi.json","mcp":"https://www.havahr.com/api/mcp","disclaimer":"Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","calculators":[{"name":"calculate_malaysia_payroll","title":"Malaysia payroll (full statutory)","description":"Calculate Malaysian net pay with EPF, SOCSO, EIS, SKBBK (Lindung 24 Jam), and PCB deductions plus employer contributions. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"A user asks what a Malaysian salary nets after statutory deductions, or wants a payslip breakdown.","endpoint":"https://www.havahr.com/api/v1/calculators/malaysia-payroll","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfGrossSalary":{"description":"Optional EPF wage base in RM (e.g. include bonus). Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"socsoGrossSalary":{"description":"Optional SOCSO wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"eisGrossSalary":{"description":"Optional EIS wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"skbbkGrossSalary":{"description":"Optional SKBBK (Lindung 24 Jam) wage base in RM. Defaults to socsoGrossSalary then grossSalary.","type":"number","exclusiveMinimum":0},"employeeAge":{"description":"Employee age in years. Default 30.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"isNonMalaysianMemberBefore1998":{"description":"Non-Malaysian EPF member before Aug 1998. Default false.","type":"boolean"},"epfEmployeeRate":{"description":"Optional EPF employee rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100},"maritalStatus":{"description":"For PCB. Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Spouse working (PCB). Default true.","type":"boolean"},"numberOfChildren":{"description":"Children for PCB relief. Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"daysInMalaysia":{"description":"Days in Malaysia for tax residency. Default 365.","type":"integer","minimum":0,"maximum":366},"omitPcb":{"description":"When true, PCB is zeroed and excluded from aggregates.","type":"boolean"},"payrollYear":{"description":"Payroll period year for SKBBK effective-date gating. Defaults to current UTC year.","type":"integer","minimum":2000,"maximum":2100},"payrollMonth":{"description":"Payroll period month (1–12) for SKBBK. Defaults to current UTC month.","type":"integer","minimum":1,"maximum":12},"socsoActive":{"description":"SOCSO coverage. When false, SKBBK is RM0. Default true.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR Lindung24 opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR Lindung24 resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["grossSalary"]}},{"name":"calculate_epf","title":"EPF (KWSP)","description":"Calculate Malaysian EPF (KWSP) employee and employer contributions from official Third Schedule rates. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Only the EPF/KWSP employee and employer contribution is needed.","endpoint":"https://www.havahr.com/api/v1/calculators/epf","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for EPF in RM"},"employeeAge":{"description":"Employee age. Default 30.","type":"integer","minimum":0,"maximum":120},"employeeRate":{"description":"Optional employee contribution rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100}},"required":["grossSalary"]}},{"name":"calculate_socso","title":"SOCSO (PERKESO)","description":"Calculate Malaysian SOCSO (PERKESO) contributions (Category 1 under 60, Category 2 for 60+). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Only the SOCSO/PERKESO contribution is needed, including the age 60+ Category 2 split.","endpoint":"https://www.havahr.com/api/v1/calculators/socso","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for SOCSO in RM"},"employeeAge":{"description":"Employee age. Under 60 = Category 1; 60+ = Category 2. Default 30.","type":"integer","minimum":0,"maximum":120}},"required":["grossSalary"]}},{"name":"calculate_eis","title":"EIS (SIP)","description":"Calculate Malaysian EIS (SIP) contributions with eligibility (citizen or PR, age 18–60). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Only the EIS/SIP contribution is needed, including eligibility by citizenship and age.","endpoint":"https://www.havahr.com/api/v1/calculators/eis","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for EIS in RM"},"employeeAge":{"description":"Employee age. Default under 60.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. When true, treated as EIS-eligible (same as citizen). Default false.","type":"boolean"}},"required":["grossSalary"]}},{"name":"calculate_skbbk","title":"SKBBK (Lindung 24 Jam)","description":"Calculate Malaysian SKBBK (Lindung 24 Jam / non-employment injury) employee contribution from the official PERKESO table (≈0.75% schedule, RM6,000 wage ceiling), with effective-date and opt-out eligibility. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Checking the Lindung 24 Jam (SKBBK) employee deduction for a specific wage month, including opt-out handling.","endpoint":"https://www.havahr.com/api/v1/calculators/skbbk","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wage":{"type":"number","minimum":0,"description":"Monthly SKBBK wage base in RM (basic + SKBBK-applicable earnings). Ceiling RM6,000."},"payrollYear":{"type":"integer","minimum":2000,"maximum":2100,"description":"Payroll period year"},"payrollMonth":{"type":"integer","minimum":1,"maximum":12,"description":"Payroll period month (1–12)"},"socsoActive":{"description":"SOCSO coverage. When false, contribution is RM0. Default true.","type":"boolean"},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["wage","payrollYear","payrollMonth"]}},{"name":"calculate_pcb","title":"PCB (MTD)","description":"Estimate Malaysian PCB / monthly tax deduction (MTD) from salary and tax category inputs. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Estimating monthly income tax withholding (PCB/MTD) for a salary and tax category.","endpoint":"https://www.havahr.com/api/v1/calculators/pcb","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfContribution":{"description":"Optional monthly EPF employee contribution in RM (used to infer EPF rate).","type":"number","minimum":0},"maritalStatus":{"description":"Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Default true.","type":"boolean"},"numberOfChildren":{"description":"Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"isResident":{"description":"Tax resident. Default true.","type":"boolean"}},"required":["grossSalary"]}},{"name":"calculate_employer_cost","title":"Employer hiring cost","description":"Calculate total employer outlay for a Malaysian salary: gross plus statutory employer contributions (SKBBK is employee-only). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"A user asks what an employee really costs the employer, or is budgeting a new hire.","endpoint":"https://www.havahr.com/api/v1/calculators/employer-cost","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfGrossSalary":{"description":"Optional EPF wage base in RM (e.g. include bonus). Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"socsoGrossSalary":{"description":"Optional SOCSO wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"eisGrossSalary":{"description":"Optional EIS wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"skbbkGrossSalary":{"description":"Optional SKBBK (Lindung 24 Jam) wage base in RM. Defaults to socsoGrossSalary then grossSalary.","type":"number","exclusiveMinimum":0},"employeeAge":{"description":"Employee age in years. Default 30.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"isNonMalaysianMemberBefore1998":{"description":"Non-Malaysian EPF member before Aug 1998. Default false.","type":"boolean"},"epfEmployeeRate":{"description":"Optional EPF employee rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100},"maritalStatus":{"description":"For PCB. Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Spouse working (PCB). Default true.","type":"boolean"},"numberOfChildren":{"description":"Children for PCB relief. Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"daysInMalaysia":{"description":"Days in Malaysia for tax residency. Default 365.","type":"integer","minimum":0,"maximum":366},"omitPcb":{"description":"When true, PCB is zeroed and excluded from aggregates.","type":"boolean"},"payrollYear":{"description":"Payroll period year for SKBBK effective-date gating. Defaults to current UTC year.","type":"integer","minimum":2000,"maximum":2100},"payrollMonth":{"description":"Payroll period month (1–12) for SKBBK. Defaults to current UTC month.","type":"integer","minimum":1,"maximum":12},"socsoActive":{"description":"SOCSO coverage. When false, SKBBK is RM0. Default true.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR Lindung24 opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR Lindung24 resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["grossSalary"]}},{"name":"calculate_overtime","title":"Overtime & public holiday pay","description":"Calculate Malaysian overtime pay under the Employment Act 1955: normal day 1.5x, rest day 2x/3x, public holiday 2x daily rate plus 3x hourly OT, with 45-hour week and 104-hour monthly OT compliance checks. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Working out Employment Act 1955 overtime, rest-day, or public-holiday pay, and the 45h/104h compliance limits.","endpoint":"https://www.havahr.com/api/v1/calculators/overtime","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlySalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly basic salary in RM (ordinary rate = salary / 26)"},"normalHoursPerDay":{"description":"Normal working hours per day. Default 8.","type":"number","exclusiveMinimum":0,"maximum":24},"normalDayOtHours":{"description":"OT hours on normal working days this month (paid 1.5x hourly). Default 0.","type":"number","minimum":0},"restDayOtHoursFirst8":{"description":"Hours worked on rest days within normal shift length (paid 2x hourly). Default 0.","type":"number","minimum":0},"restDayOtHoursBeyond8":{"description":"Rest-day hours beyond normal shift length (paid 3x hourly). Default 0.","type":"number","minimum":0},"publicHolidayWorkedDays":{"description":"Public holidays worked at the usual shift length (paid 2x daily rate per day). Default 0.","type":"number","minimum":0},"publicHolidayOtHours":{"description":"Extra hours beyond the usual shift on public holidays (paid 3x hourly). Default 0.","type":"number","minimum":0},"weeklyHours":{"description":"Normal weekly working hours, for the 45-hour compliance check. Default 45.","type":"number","minimum":0},"monthlyOtHours":{"description":"Total OT hours this month, for the 104-hour compliance check. Defaults to the sum of OT hours above.","type":"number","minimum":0}},"required":["monthlySalary"]}},{"name":"calculate_leave_proration","title":"Annual leave proration","description":"Prorate Malaysian annual leave entitlement for mid-year joiners or leavers by calendar or service year, with optional unpaid-leave adjustment. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Prorating annual leave for a mid-year joiner or leaver, or for an unpaid-leave adjustment.","endpoint":"https://www.havahr.com/api/v1/calculators/leave-proration","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"joinDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Employee join date (YYYY-MM-DD)"},"annualEntitlement":{"type":"number","minimum":0,"description":"Full-year annual leave entitlement in days"},"usedLeave":{"description":"Annual leave days already taken. Default 0.","type":"number","minimum":0},"cutoffDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Proration cutoff date, e.g. year end or termination date (YYYY-MM-DD)"},"basis":{"description":"Proration basis: calendar year or service year. Default calendar.","type":"string","enum":["calendar","service"]},"unpaidLeaveDays":{"description":"Unpaid leave days to reduce entitlement (1 month unpaid reduces ~1/12). Default 0.","type":"number","minimum":0},"useDayProration":{"description":"Use day-level proration instead of month-level (calendar basis only). Default false.","type":"boolean"}},"required":["joinDate","annualEntitlement","cutoffDate"]}},{"name":"check_employment_act_coverage","title":"Employment Act coverage check","description":"Check whether an employee is covered by the Malaysian Employment Act 1955 (RM4,000 threshold, manual labor, domestic work) with rationale and references. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Deciding whether Employment Act 1955 entitlements apply to a given employee.","endpoint":"https://www.havahr.com/api/v1/calculators/employment-act-coverage","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlySalary":{"type":"number","minimum":0,"description":"Monthly wages in RM (RM4,000 threshold applies to key entitlements)"},"isManualLabor":{"description":"Employee mainly performs manual labor. Default false.","type":"boolean"},"isDomesticServant":{"description":"Employee is a domestic servant/worker. Default false.","type":"boolean"},"hasSpecialExclusion":{"description":"Special exclusions apply (e.g. seafarers, statutory bodies). Default false.","type":"boolean"}},"required":["monthlySalary"]}},{"name":"calculate_hrd_corp_levy","title":"HRD Corp (HRDF) levy","description":"Calculate the Malaysian HRD Corp (HRDF) levy: mandatory 1% for 10+ Malaysian employees, voluntary 0.5% for 5-9, with monthly/annual levy and training budget. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.","whenToUse":"Working out the HRD Corp (HRDF) levy and the training budget it funds.","endpoint":"https://www.havahr.com/api/v1/calculators/hrd-corp-levy","method":"POST","currency":"MYR","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"totalWages":{"type":"number","minimum":0,"description":"Total eligible monthly wages in RM (basic + fixed allowances + commissions; excludes OT, bonus, reimbursements)"},"employeeCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Malaysian employees (foreign workers do not count toward the threshold)"},"isVoluntary":{"description":"Employer with 5-9 employees opting into voluntary registration at 0.5%. Default false.","type":"boolean"}},"required":["totalWages","employeeCount"]}}]}