京号导入开票模板

要解决什么问题

京号在腾讯文档里维护「9月发票登记」这类 sheet，财务侧却要按 (V260401版)批量开票-导入开票模板.xlsx 的列结构批量导入。手工抄购方信息、明细数量金额不难，真正容易出错的是：每条明细的 19 位货物类税收分类编码——京号里的「品类」列只是人工标记，商品名称也可能和开票项目名称不一致，一旦选了服务类、无形资产类编码，或把接线端子当成普通电子元件，后续开票会被打回。

技能如何工作

技能把整条链路写成固定工作流，并在 SKILL 里把规则写死，执行时不需要反复向用户确认：

1. 读源表：通过腾讯文档 MCP（sheet.get_sheet_info / get_cell_data，CSV）从文档 eiUvlFnWWfZM 的 9月发票登记（sheet_id kbr50m）按行读取；购方名称、税号、地址、单位、数量、金额等按列映射到模板对应字段。
2. 补商品上下文：对 col 10 的京东商品链接逐条抓取页面标题（失败则退回京号商品名），用于理解实物功能，但不能单独作为编码依据。
3. 查编码：在 ~/Desktop/工作文件/税务编码及税点.xls（2111 行，xlrd）里匹配。先查内置编码速查表（历史校验过的关键词→编码，命中则不再全表搜）；否则在「货物和劳务名称 / 分类简称 / 关键字」列做全表关键词搜索，逐条验证是否跨大类，再选最贴近项；无精确匹配则向上归纳到「其他XXX」，并标注 ⚠️ 无精确匹配，已向上归纳。
4. 写模板：用 openpyxl 填「1-发票基本信息」「2-发票明细信息」；明细 B 列项目名称由模型根据商品本质自主命名（材质+功能，约 10 字内），不照搬 col 11；I 列税率固定 0.01，禁止用编码表里的税率。
5. 输出前自检：逐条核对是否为货物类、是否与速查表冲突、是否被 col 12 误导；通过后保存为 (V260401版)批量开票-导入开票模板-{起始行}至{结束行}行.xlsx。

适用边界与注意点

• 业务前提：京号销售的是实体货物；技能明确禁止服务、建筑、无形资产、不动产等编码。
• 路径依赖：模板与税务编码表默认在 ~/Desktop/工作文件/，脚本需用 os.path.expanduser('~') 展开，不能写死某台机器的用户目录。
• 列权威性：col 11 商品名、col 12 品类仅为参考；编码决策以商品实际物理功能 + 规则三搜索流程为准。
• Sheet 名称：当前工作流绑定「9月发票登记」sheet；换月份或 sheet 名需改读取配置。