taiwan-payroll
開源的台灣勞健保勞退法定費用計算引擎。輸入薪資與身份，算出勞保（含就保）、健保、勞退、職災與二代健保補充保費的各方負擔——並涵蓋薪資所得扣繳、月中到職／離職破月、健保補充保費申報媒體檔，以及勞保老年給付試算。
示意：在支援 MCP 的 AI 助理（Claude / Cursor 等）中呼叫 taiwan-payroll
- 🧮 線上試算：https://taiwan-payroll.vercel.app（免安裝，瀏覽器直接算）
- 🔌 三種介面：TypeScript（npm）、Python（PyPI，純 stdlib）、MCP server（給 AI 助理呼叫）
- 📑 官方對證：級距表與費率逐級取自主管機關公告，計算結果對官方範例黃金向量逐位元驗證
- 🔁 跨語言一致：TS 與 Python 讀同一份
data/、跑同一套testdata/，結果逐位元相同 - 📦 零執行期依賴：core 不帶任何 runtime 套件
定位是「計算引擎」而非「法遵保證」。 內建民國 113–115（2024–2026）年度官方參數。
安裝
npm install taiwan-payroll # TypeScript / Node
pip install taiwan-payroll # Python快速上手
import { createPayrollEngine } from 'taiwan-payroll';
const engine = createPayrollEngine({ year: 2026 });
const r = engine.calculate({
monthlySalary: 42000,
identity: 'category1',
dependents: 1,
employmentInsurance: true,
pensionSelfContribution: 0.06,
});
console.log(r.employee); // { labor: 1050, health: 1302, pensionSelf: 2520, total: 4872 }
console.log(r.employer.occupational); // 職災雇主負擔二代健保補充保費與破月計算
// 補充保費（六類所得：bonus/parttime/professional/dividend/interest/rent）
engine.calculateSupplementary({ type: 'bonus', amount: 200000, monthlyInsuredSalary: 42000 });
// → { type: 'bonus', chargeable: 32000, rate: '0.0211', premium: 675 }
// 月中到職／離職（勞保/職保/勞退按日；健保採官方「月底歸屬」原則）
engine.calculateProrated({ monthlySalary: 29500, startDate: '2026-03-08' });
// → { ..., days: { insured: 23 }, healthCharged: true }
