社区论坛

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

【官方教程】发票配置编辑器(菜单)

官方教程 配置文件相关 2026-05-25 00:40:05 0 回复

一、功能名称

发票配置编辑器(feature_id:menu.invoice_config_editor

图形化编辑 configs/invoice/ 下货代 JSON,无需手工改文本。

二、实现逻辑

  • 入口:主菜单 → 发票配置编辑器(InvoiceConfigEditorDialog
  • 加载/保存 JSON,校验关键字段(模板路径、列映射、selection_policy)
  • 保存后立即被发票 V2 服务读取

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

  • configs/invoice/*.json
  • configs/invoice/invoice_settings.json 全局币种/汇率/货件校验
  • 关联 templates/ 下 Excel 模板路径

四、使用教程

  1. 菜单打开发票配置编辑器,选择要编辑的货代 JSON。
  2. 修改模板路径、字段映射、选址策略等。
  3. 保存后重启或重新加载配置(若当前会话未自动刷新)。
  4. 建议复制 JSON 备份后再改;新货代可 duplicate 现有文件改名。

五、常见异常

异常情况解决方法
「配置文件不存在」/「读取配置失败」确认 configs/invoice/ 目录下有对应 JSON 文件且格式合法。
「未找到物流商配置,请点击新建货代」点击新建按钮创建配置,或复制现有货代 JSON 改名。
保存时「物流商名称/模板路径/Sheet名称不能为空」填写所有必填项后再保存。
「单元格格式无效」/「存在无效字段来源」检查单元格引用(如 A1)及字段来源语法(db:rule:fixed: 等)。
「起始行/行高必须是整数」行号相关字段只能填整数。
「保存失败」确认 JSON 文件未被其他程序占用;检查目录写入权限。
保存后发票生成仍报错确认 version: 2template 指向存在的 Excel 模板;重启发票工具窗口。

全部回复 (0)

暂无回复,来抢沙发吧。