Kenya Tax Rates

核心功能与用法

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 版本，防止自动升级引入未预期的税率变更。

核心用法

本 Skill 为纯文档型技能，通过引导用户安装 kenya-tax-rates npm 包实现功能。主要提供两类用法：快速净薪资计算（getNetSalary）和完整薪资明细拆解（calculatePayroll）。用户可获取包含个人免税额、保险减免、养老金扣除等优惠后的应纳税收入，以及雇主与雇员双方应承担的社保费用明细。

显著优点

1. 税率实时更新：已整合2024年10月SHIF取代NHIF、2025年2月NSSF上限调整等重大税改变化，自动根据日期选择适用税率。
2. 计算维度全面：涵盖肯尼亚现行全部法定薪资扣除项——5级累进PAYE、2.75%社会健康保险、双层养老金制度、1.5%住房税及四类税收减免。
3. API设计简洁：提供单一函数快速估算与完整对象明细两种模式，满足从粗略估算到财务审计的不同精度需求。
4. 开源可审计：GitHub 仓库完全公开，用户可独立验证计算逻辑与官方KRA规定的一致性。

潜在缺点与局限性

• 地域高度专一：仅适用于肯尼亚税务体系，无法迁移至其他国家或地区。
• 法规依赖性强：作为封装库，其准确性完全取决于作者能否及时跟进KRA政策调整，存在滞后风险。
• 无官方背书：非肯尼亚税务局（KRA）官方工具，计算结果仅供参考，正式申报仍需以官方渠道为准。
• 个人维护者：由单一开发者维护，长期更新承诺与大型机构相比存在不确定性。

适合的目标群体

• 在肯尼亚运营的中小企业HR与财务部门
• 为肯尼亚雇员提供远程薪资服务的国际公司
• 需要预估税后收入的肯尼亚本地求职者与雇员
• 开发肯尼亚本土化薪资系统的软件工程师

使用风险

1. 供应链风险：npm 包可能被劫持或作者账号被盗，建议安装前核对 GitHub 源码与 npm 发布者一致性，并使用版本锁定。
2. 计算准确性风险：税务法规解释可能存在歧义，建议与KRA官方计算器交叉验证关键数据，尤其是涉及税收减免的边界情况。
3. 合规风险：本工具不构成税务或法律建议，企业使用时应咨询持牌税务顾问，避免因理解偏差导致申报错误。
4. 维护中断风险：个人项目存在停止维护可能，建议fork仓库或做好替代方案准备。