社区论坛
交流工具使用、配置与问题一、功能名称
报关资料制作（feature_id：customs_generator）
按合同号从数据库汇总 SKU，生成报关单、申报要素、发票、箱单、合同等 Excel 套装。
二、实现逻辑
- 入口：
CustomsGeneratorDialog（dialogs/customs_generator_dialog.py） - 从「备货物流信息」读取合同号列表，选中后查询关联货件与 SKU
- 按
configs/报关资料.json的模板路径、组合 SKU 规则、备注规则填充templates/报关资料模板.xlsx - 输出目录可在界面或
tools_config.json → customs_generator.output_dir配置
三、数据 / 字段 / 配置支撑
数据库.xlsx：备货物流信息、产品数据库（报关名称、HS、要素等）configs/报关资料.json：fixed_values、combo_sku、remarks_rules、sku_origintemplates/报关资料模板.xlsxconfigs/tools_config.json → customs_generator：output_dir、merge_mode
四、使用教程
- 维护数据库中合同号与货件、SKU 对应关系。
- 打开报关资料制作，在下拉框选择合同号。
- 确认预览数据无误后点击生成。
- 在 output/报关资料 或配置的目录查看生成的 Excel 套装。
- 组合 SKU 会自动拆分子 SKU；仅第一个子 SKU 填毛重/件数（见配置说明）。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 提示「报关资料生成器未初始化」 | 等待程序完成数据库加载；失败时菜单点「重新加载数据库」后重开工具。 |
| 提示「请选择出厂日期」/「请设置输出目录」/「请先选择要生成的合同」 | 依次选择出厂日期、确认输出目录、勾选要生成的合同行。 |
| 「数据校验失败」 | 查看校验详情：常见为模板路径无效、合同无关联货件、SKU 缺报关名称/HS/要素，或数量/箱数/单价/毛重 ≤ 0。 |
| 「共 N 个报关品名，超过模板上限 M 项」 | 拆分合同货件或调整 configs/报关资料.json 中 max_products；也可换更大容量的模板。 |
| 「未找到货件编号」或「合同 … 没有找到货件数据」 | 检查「备货物流信息」中该合同号是否有关联货件行，货件号列是否填写。 |
| 「没有生成任何文件」 | 查看日志区逐合同错误；修正数据后重新生成。 |
| 组合 SKU 毛重/件数异常 | 确认 combo_sku 配置正确；仅第一个子 SKU 填毛重/件数是预期行为。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复