小规模纳税人报税指引 small-taxpayer-tax-guide
帮小规模纳税人算清本期增值税：免税额度判断 + 应纳税额测算 + 申报期与流程提示。
何时使用
- 用户是小规模纳税人，问本期要交多少增值税、能不能免
- 想知道开专票/普票分别怎么计税
- 不清楚申报期、按季还是按月、怎么在电子税务局申报
创作流程
Step 1 收集输入（缺项向用户确认，不要猜）
按 references/policy-notes.md 口径问清：
| 输入项 | 说明 |
|---|---|
| 申报方式 | 按季(quarterly，默认) 还是按月(monthly) |
| 本期销售额(sales) | 普票+未开票+专票合计，单位元 |
| 其中专票销售额(special_tax_sales) | 开增值税专用发票的部分，可缺省 |
写成 key: value 每行一项的临时文件。
Step 2 跑脚本测算
python3 scripts/tax_calc.py --file 你的数据.txt
python3 scripts/tax_calc.py --file 你的数据.txt --json # 机器可读
脚本按现行优惠口径计算：
- 征收率减按 1%；按季免税额度 30万、按月 10万
- 未超额度：普票/未开票部分免征，专票部分照缴
- 超过额度：本期全部销售额计税
- 输出免税销售额、计税销售额、应缴增值税与申报期提示
Step 3 结合政策要点解释
读 references/policy-notes.md：征收率、免税额度、专票不免税、申报期、常见情形。向用户解释"为什么这么算"，并提醒零申报也要报。
Step 4 输出报税指引
- 先给测算结果（脚本输出整理）
- 再给申报步骤：登录电子税务局 → 增值税及附加税费申报表（小规模纳税人适用）→ 填销售额 → 核对税额 → 申报缴款/零申报
- 提示申报截止时间与渠道
输出格式
【测算结果】
申报方式 按季/按月 | 免税额度 xx元 | 征收率 1%
本期销售额 xx元（其中专票 xx元）
免税销售额 xx元 | 计税销售额 xx元
应缴增值税 xx元
【说明】为什么免/为什么缴（结合专票规则）
【申报指引】申报期 + 电子税务局操作步骤 + 缴款/零申报提示
脚本用法
| 命令 | 作用 |
|---|---|
python3 scripts/tax_calc.py --file data.txt |
测算并输出 |
python3 scripts/tax_calc.py --file data.txt --json |
JSON 输出 |
python3 scripts/tax_calc.py --sample |
输出示例数据文件 |
退出码：输入数据错误（负数/专票大于总额/period 非法）为 1；正常测算为 0。
边界与说明
- 政策税率与免税额度以最新政策与主管税务机关口径为准，本技能按现行延续口径测算，优惠到期或调整需更新
- 只做增值税简易测算，不含企业所得税、个税、印花税、附加税费明细与差额征税、免税项目等复杂情形
- 复杂情形（兼营5%征收率业务、差额征税、即征即退等）请咨询主管税务机关或专业会计
- 结果仅供参考，不构成税务申报依据
