核心功能与用法
kenya-tax-rates 是一个专为肯尼亚薪资场景设计的 Node.js 计算库，提供从毛薪到净薪的完整链条计算。核心入口包括 calculatePayroll() 返回完整薪资拆解（应税收入、各项扣除、雇主缴纳部分），以及 getNetSalary() 快速获取净薪数字。支持模块化调用单项计算器：PAYE（5档累进10%-35%）、SHIF（2.75%无上限，最低KES 300）、NSSF（自动识别2024/2025两档上限）、住房税（1.5%）。
显著优点
- 时效性强：内置2024年10月SHIF取代NHIF、2025年2月NSSF新上限等最新政策，通过日期参数自动切换税率版本，避免手动更新。
- 计算粒度完整：不仅计算员工扣除项，同时返回雇主缴纳的NSSF和住房税，满足双向对账需求。
- 税务优化支持：内置个人减免（KES 2,400/月）、保险减免（保费15%上限KES 5,000）及养老金扣除（上限KES 30,000），可合法降低应税基数。
- TypeScript友好：提供完整类型定义，IDE 自动补全降低配置错误。
潜在局限与风险
- 地域单一：仅适配肯尼亚税法，跨境多辖区场景需额外集成。
- 依赖政策同步：虽自动切换版本，但若肯尼亚政府临时调整税率（如年中修订），需等待库作者更新 npm 包。
- 边缘场景覆盖：未明确说明年终奖、离职补偿金等特殊收入的税务处理；外币薪资汇率转换需调用方预处理。
- 精度风险：金融计算涉及浮点数，文档未说明是否采用整数分（cents）精确运算，高薪资场景建议审计验证。
适合人群
- 肯尼亚本地企业 HR/财务系统的开发者
- 跨境支付平台（如 Deel、Remote）需集成肯尼亚薪资模块的工程师
- 为肯尼亚雇员提供薪资计算工具的自雇人士或会计师
常规风险提示
- 合规依赖：开源库非官方 KRA（肯尼亚税务局）产品，关键计算结果建议与 KRA iTax 系统交叉校验。
- 数据隐私：处理真实员工薪资时，注意 Node.js 运行环境的日志脱敏，避免将
grossSalary等敏感字段输出到未加密日志。 - 版本锁定：生产环境建议锁定具体 npm 版本，防止自动升级引入未预期的税率变更。