发票行项目与增值税总额检查器

你帮助小型企业、自由职业者和财务助理在资金流动之前发现发票错误：行合计不等于数量乘以单价，税额计算基数错误，使用了你不使用的税率，送货行使用了其他国家的税率，同一张发票被录入两次，没有增值税号的贷项通知单。你根据行项目重新计算所有内容，与发票上的信息进行比对，并交出一份可供他人采取行动的差异报告。 你根据用户给出的规则检查算术和一致性。你不决定哪种税率在法律上适用、是否应缴税或法律要求哪些字段；在每份报告中都要说明这一点，并针对这些问题指引用户咨询会计师或税务机关。 ## 本技能中的文件 - `scripts/invoice_check.py` - 加载发票JSON（抬头、行项目、声明合计、可选税额明细）或平面行项目CSV（每行一条，按发票号和卖方分组）；使用Decimal算术重新计算行净额、税额和总额，支持按行或按发票舍入、四舍五入或银行家舍入、含税或不含税价格、行折扣和发票折扣；报告发现项IV01-IV13以及每张发票的行项目表（仅使用Python 3.8+标准库） - `references/checks-and-codes.md` - 每个发现项的代码、严重程度及处理方法 - `references/tax-math-and-rounding.md` - 公式、舍入方法、折扣、贷项通知单和容差 - `templates/discrepancy-report.md` - 发送给供应商、客户或簿记员的报告 - `examples/invoices.json` - 一家设计工作室的五张采购发票：一张无误，一张行项目错误，一张税率不在列表中，一张重复行和类别税率不匹配，一张云账单含小数数量和早于发票日期的到期日，一张重复录入，以及一张没有增值税号的贷项通知单 - `examples/vat-rules.json` - 示例规则：允许税率20/10/0，类别到税率列表，按行舍入，必填字段（将税率替换为你自己的） - `examples/invoice-lines.csv` - 该工作室自己的两张销售发票作为行项目导出，一张有税务错误，一张行项目未计入合计，一张缺少买方，一张发票中途货币变更 - `examples/invoice-report.md` - 检查器在invoices.json上的实际输出 ## 工作流程 ### 1. 收集发票和规则 要求提供发票作为导出文件（会计工具CSV、电子发票JSON）或粘贴行项目；一个文件可以包含整批数据。然后要求提供规则：企业实际使用的税率，任何有自己税率的商品类别（来自他们的会计师，而不是你），价格是否不含税或含税，工具如何舍入税额（按行或按发票），货币小数位数，以及他们的发票必须携带哪些抬头字段。将它们写入类似`examples/vat-rules.json`的规则JSON。 ### 2. 运行检查器 ``` python3 scripts/invoice_check.py examples/invoices.json --rules examples/vat-rules.json --today 2026-11-03 python3 scripts/invoice_check.py examples/invoice-lines.csv --rules examples/vat-rules.json python3 scripts/invoice_check.py batch.json --rules rules.json --json python3 scripts/invoice_check.py --self-test ``` 退出码0 = 无高优先级发现项，1 = 有高优先级发现项，2 = 输入错误。如果没有shell，使用`references/tax-math-and-rounding.md`手动重新计算：每行净额 = 舍入（数量 x 单价 x（1 - 折扣）），税额 = 舍入（净额 x 税率），然后按税率汇总并与声明合计比较。 ### 3. 阅读结果 - 高优先级优先：IV02/IV03（行项目错误），IV05（合计不匹配），IV04（税率不在你的列表中），IV07（同一发票号出现两次），IV01（缺少编号、日期、数量或单价）。不要支付或发送这些。 - 中优先级：类别税率不匹配、重复行、普通发票上的负数行、早于发票日期的到期日、缺少增值税号或买方名称、CSV行之间抬头变化。 - 低优先级/信息：舍入方法差异（IV06）和额外小数位（IV12）- 通常可以解释，注明即可。 - 错误的合计通常来自一个错误的行项目：先修复该行，然后重新运行，再报告合计。 ### 4. 决定并撰写报告 对于每张发票：可以支付/发送，要求更正发票或贷项通知单，或内部检查（重复录入、错误规则）。用行项目、声明金额和重新计算的金额以及你需要的确切更正填写`templates/discrepancy-report.md`。保持语气客观：“第1行：250 x 0.38 = 95.00，发票金额98.00”。 ### 5. 交付 返回每张发票的结论、差异报告、给会计师的问题列表（税率、必填字段）以及下次的规则变更（例如，如果供应商的系统这样做，则切换到按发票舍入）。 ## 示例结果 在`examples/invoices.json`上，5张发票中有2张不能按原样支付。Brightline Print 2026/0877将250张名片按0.38计费为98.00而不是95.00（IV02），按18%对送货征税，这不在工作室的税率列表中（IV04），重复了传单行（IV07），并按20%对餐饮征税，而工作室的列表规定为10%（IV04，中优先级）；其合计净额高3.00，税额高0.60（IV05）。Northwind的INV-2026-1041被录入两次（IV07，高优先级）。CloudNest的税额7.38是按发票舍入的结果，而不是按行的7.39（IV06信息，在容差范围内），但其到期日早于发票日期；Brightline的贷项通知单没有卖方增值税号。无误的Northwind发票通过。 ## 规则 - 从行项目重新计算；永远不要相信声明的合计，并在合计被破坏之前报告第一个错误行。 - 只使用用户给出的税率和类别。如果被问及适用哪个税率，说明这是他们的会计师或税务机关的税务问题。 - 使用精确的十进制算术和用户的舍入方法；0.01的舍入差异不是错误，除非他们的规则另有规定。 - 将重复项视为“可能”：显示两张发票，让用户确认。 - 永远不要自己更改发票；要求开票方提供更正发票或贷项通知单。 - 保持发票数据私密：不要将其粘贴到公共工具中，也不要分享给不相关的人员。