kz-tax-code — 哈萨克斯坦税务助手

权威信源

所有回答均严格基于 data/ 目录中《哈萨克斯坦共和国税法典》（НК РК）原文文本。 不内置任何税率或数值——仅使用原始法律文本中明确记载的内容。 若未找到对应条款，将如实告知用户。

不在《哈萨克斯坦共和国税法典》中的内容

以下指标由单项法律另行规定，在《哈萨克斯坦共和国税法典》正文中并无体现：

法律文件编号、URL 及最新已知数值详见 data/laws.json（需每年更新）。

上述数值每年调整——切勿凭记忆填写，务必始终从原始法律文本中读取。

获取最新数值

1. 阅读 data/laws.json，获取法律文件编号、URL 及最新已知数值
2. 下载所需法律文件（语言依用户查询语言而定）：

# 俄语查询（МРП、МЗП）
# 请在 workspace 根目录下执行；--out 路径相对于当前工作目录（CWD）
node skills/kz-tax-code/scripts/fetch.js 
  --doc=Z2500000065 --lang=ru --out=skills/kz-tax-code/data/budget-current-ru.md --insecure

# 哈萨克语查询（АЕК、ЕАМ）
node skills/kz-tax-code/scripts/fetch.js 
  --doc=Z2500000065 --lang=kaz --out=skills/kz-tax-code/data/budget-current-kaz.md --insecure

3. 通过关键词搜索定位数值：

# --file 路径相对于 CWD（即 workspace 根目录）
node skills/kz-tax-code/scripts/search.js 
  --file=skills/kz-tax-code/data/budget-current-ru.md --keyword="месячный расчётный показатель"

node skills/kz-tax-code/scripts/search.js 
  --file=skills/kz-tax-code/data/budget-current-kaz.md --keyword="АЕК мөлшері"

若该文件此前已下载，可直接复用，无需重复下载。

若无法完成下载，请告知用户需前往 egov.kz 或 adilet.zan.kz 核实最新数值，并引用 laws.json 中的 knownValues 作为参考值，同时明确标注“需核实”。

个性化计算

若用户请求涉及具体个人（例如：“我需要缴纳多少税？”、“请帮我计算我的税额”、“我被扣缴了 ИПН”），且未提供年龄信息，则需主动询问：

“请确认您的年龄——这将影响相关税额计算。”

为何年龄至关重要

⚠️ 各项费率（如 ОПВ、ВОСМС 等）及法定退休年龄均由法律动态调整。下表所列仅为撰写本文时的参考值。实际适用费率必须始终取自 data/laws.json → knownValues；法定退休年龄则须通过 fetch.js 获取《养老保险法》最新文本确认。

补充说明：所有签订劳动合同的雇员，无论年龄大小，在达到法定退休年龄前均须缴纳 ОПВ；未签订劳动合同的学生不缴纳 ОПВ，并非因其年龄，而是因不存在劳动关系。

若未知晓用户年龄，则 ОПВР 计算可能出错（ОПВР 仅适用于 1975 年以后出生人员）。

税法典版本管理

现行版与历史版元数据存于 data/versions.json。

代理程序在命令中不得硬编码年份，仅允许使用 --version=current 或 --version=outdated。 当前哪一版税法典生效，应以 versions.json 内容为准，并向用户明确说明（响应脚本中 versionName 字段即为此信息）。

语言识别

语言由系统自动识别，依据用户查询内容判断，无需手动指定 --lang 参数。

哈萨克语术语对照：ЖТС（ИПН）、КТС（КПН）、ҚҚС（НДС）、ӘС（СН）、АЕК（МРП）、ЕАМ（МЗП）、МЖЖ（ОПВ）、МЖЖЖ（ОПВР）、ӘА（СО）、МӘМС（ВОСМС/ОСМС）

工作流程（Workflow）

1. 确定税法典版本

• 默认使用：--version=current
• 仅当用户明确提及过往期间或“旧版税法典”时，才切换为 --version=outdated

2. 选择搜索模式（按精确度由高到低）

# 已知条文编号 → 使用 article 模式（最精确）
node skills/kz-tax-code/scripts/search.js --article=363
node skills/kz-tax-code/scripts/search.js --article=363 --version=outdated

# Keyword 模式 —— 语言依据查询文本内容自动识别
node skills/kz-tax-code/scripts/search.js --keyword="дивиденды нерезидент"
node skills/kz-tax-code/scripts/search.js --keyword="ҚҚС мөлшерлемесі"

# Topic 模式 —— 语言同样自动识别
node skills/kz-tax-code/scripts/search.js --topic="НДС экспорт освобождение"
node skills/kz-tax-code/scripts/search.js --topic="жалақыдан ЖТС есептеу"

# 在其他法律中搜索（如 АЕК/МРП、МЖЖ/ОПВ、МӘМС/ВОСМС 等）
# --file 路径相对于 CWD（workspace 根目录）
node skills/kz-tax-code/scripts/search.js --file=skills/kz-tax-code/data/budget-current-ru.md --keyword="месячный расчётный"
node skills/kz-tax-code/scripts/search.js --file=skills/kz-tax-code/data/budget-current-kaz.md --keyword="АЕК мөлшері"

优先级顺序：--article > --keyword > --topic

3. 解析结果并组织回复

从 JSON 响应中提取以下字段：

• versionName —— 回复中须注明所依据的税法典版本
• results[].article + results[].title —— 引用条款编号与标题
• results[].text —— 条款全文（仅在 article 和 title_match 模式下返回）
• results[].context —— 匹配词周边高亮片段（仅在 keyword_exact、keyword_fallback、topic 模式下返回）
• 规则：若存在 text，应以其为准；若仅有 context，则上下文已足够

回复中必须清晰注明：所依据的税法典（versionName）、具体条款编号及项次。 涉及税额计算时：须准确查找出相关条款（税率、扣除项、计税方法等），严格依据税法典原文公式进行计算，严禁主观臆断或自行推导。

回复格式规范

务必使用脚本响应中的 versionName 字段值，禁止硬编码年份。

俄语回复示例：

根据 {{versionName}} 版本《哈萨克斯坦共和国税法典》第 363 条，居民纳税人就不超过 8 500 МРП 的收入缴纳 ИПН 的税率为 10%；超过部分，按超额金额适用 15% 税率。 （第 363 条第 1 款）

哈萨克语回复示例：

ҚР Салық кодексінің 363-бабына сәйкес（{{versionName}}），резиденттер үшін 8 500 АЕК-ке дейінгі кірістер бойынша ЖТС мөлшерлемесі — 10%，одан жоғары — 15%。 （363-бап, 1-тармақ）

若响应中含 externalHints 字段，表明该术语不属于《税法典》范畴，须向用户说明，并建议通过 fetch.js 获取相关法律依据。

若未检索到对应条款：

在 {{versionName}} 版本中未找到与该查询匹配的条款。请尝试确认具体条款编号或调整关键词。

税法典更新流程

当新版《哈萨克斯坦共和国税法典》颁布时：

推荐方式（安全可靠）：

1. 在浏览器中打开 adilet.zan.kz，查找新版税法典页面
2. 分别保存网页的俄语版和哈萨克语版 HTML 文件
3. 运行以下命令：

node skills/kz-tax-code/scripts/update.js 
  --doc=K2600000XXX --name="НК РК 2027" --effective=2027-01-01 
  --html-ru=./nk-ru.html --html-kaz=./nk-kaz.html

自动化下载方式（仅限可信网络环境，需添加 --insecure 参数）：

node skills/kz-tax-code/scripts/update.js 
  --doc=K2600000XXX --name="НК РК 2027" --effective=2027-01-01 --insecure

⚠️ --insecure 将禁用 TLS 证书校验（adilet.zan.kz 使用哈萨克斯坦国家认证中心 CA 签发证书，该 CA 未预置在 Node.js 的信任库中）。请勿在不可信网络环境中使用此参数。

该脚本将执行以下操作：

1. 解析 HTML → 转换为 Markdown
2. 将当前 current 版本移至 outdated
3. 将新版本设为 current
4. 更新 data/versions.json

文档编号（--doc）需从 adilet.zan.kz 页面 URL 中提取。