技能介绍

你要解决的具体问题

财务或税务工程师拿到企业导出的进销项发票 Excel 后，常需要手工做几类重复工作：从几十到几百个工作表或字段中筛掉红冲、作废、异常票，逐行核对税率与税额，再按月、按税率、按供应商和客户交叉汇总，最后把结果粘贴成一份格式统一的分析报告。这个过程中一旦列名有空格、Sheet 名称不标准，或某一列缺失，脚本就可能在合并单元格处抛 MergedCell 异常，导致整份报告生成失败，返工成本很高。

技能如何工作

generate_invoice_report.py 把这套流程拆成可复用的步骤，输入为进项和销项两个 Excel 文件，分别通过 --jin 和 --xiao 指定，并支持 --year、--company、--out 等命令行参数。核心能力包括：

数据读取与清洗：默认读取 信息汇总表 Sheet，找不到时自动降级到第一个可用 Sheet；校验 开票日期、金额、税额、价税合计、发票状态 等必需列，缺失时明确报错并列出现有列；过滤无效票并区分正数与红字发票。
八大分析维度：输出包含 经营概览、月度趋势分析、税率结构分析、进项供应商分析、销项客户分析、商品结构分析、异常预警台账、专票抵扣分析 共 8 个 Sheet，覆盖税负率、集中度、抵扣性质等关键指标。
参数化报告生成：create_report() 将 --company 写入报告标题与封面，--year 作为年度标签，--out 控制输出路径，--sheet 和 --silent 分别用于自定义数据 Sheet 和减少终端输出。
错误处理与校验：文件或 Sheet 不存在时给出友好提示并退出；缺少可选列（如 销方名称）时降级运行，不会直接崩溃；apply_table_style() 和 set_col_widths() 会跳过合并单元格等易触发异常的区域。

适用边界与注意点

该技能适用于任意企业导出的规范 Excel 进销项数据，但要求源文件包含上述必需列，且 发票状态 取值能被脚本识别。它只做离线分析，不联网调用税局接口，也不处理 PDF、CSV 等非 Excel 格式。报告封面 报告编制 字段固定为“中税云检（宁夏）企业管理咨询有限公司”，如需修改可直接编辑 create_report() 中的 ws['A2']。运行环境需 Python 3.8+，依赖 pandas、openpyxl 和 argparse。许可证限定为中税云检及其客户使用，允许自行修改扩展，但不得商业转售。