社区论坛

交流工具使用、配置与问题

【官方教程】发票生成器 V2(列表批量模式)

官方教程 发票生成器V2(列表) 2026-05-25 00:40:05 0 回复

一、功能名称

发票生成器 V2(列表)(feature_id:invoice_v2_list

从数据库货件列表中勾选并批量生成发票,适合同一出厂日期或同一批货件集中出票。

二、实现逻辑

  • 入口:制作工具 → 发票制作 → 发票生成器V2(列表)
  • 界面:dialogs/invoice_generator_v2_list_gui.py
  • 通过 ShipmentQueryEngine 加载「备货物流信息」表,列表展示可筛选货件
  • 批量调用与输入版相同的 InvoiceServiceV2 生成逻辑

三、数据 / 字段 / 配置支撑

与输入版相同,依赖 数据库.xlsx 各业务表及 configs/invoice/ 下货代 JSON。

列表模式额外依赖「备货物流信息」中完整行数据(货件号、合同号、出厂日期、平台等列)。

权限 feature_id:invoice_v2_list

四、使用教程

  1. 打开列表版发票生成器,等待货件列表加载。
  2. 按出厂日期、平台或关键字筛选需要出票的货件。
  3. 勾选目标行,选择货代配置。
  4. 执行批量生成,在日志中查看每张发票结果。
  5. output/ 对应日期文件夹验收文件。

五、常见异常

异常情况解决方法
提示「请先选择出厂日期」在日期筛选器中选择目标出厂日期,等待列表刷新。
提示「请先选择要生成发票的货件」勾选列表中至少一行货件后再点击生成。
列表为空或加载失败确认「备货物流信息」表有数据且含出厂日期列;菜单重新加载数据库。
预览区警告「重复仓库代码」在「海外仓地址库」清理重复的仓库代码,保留正确地址行。
单票生成失败(同输入版各类错误码)查看日志中具体错误码:补全数据库缺失字段、渠道、VAT 或 SKU 信息,参考输入版教程第五节。
批量生成部分成功部分失败逐条查看日志失败原因;常见为个别货件缺字段或 SKU 未维护,修正后仅重跑失败货件。
「输出目录不存在」在界面指定有效输出路径,或检查 tools_config.json 记忆的上次目录是否仍存在。

全部回复 (0)

暂无回复,来抢沙发吧。