导入导出与打印
Excel 导出
列表页工具栏的导出按钮按当前查询条件、当前显示的列导出(最多 1 万行,列设置中隐藏的列不导出),字典列导出标签。
- 页面把
useTable返回的exportAll传给TableToolbar的exporter;列定义加dict导出字典标签,或exportValue(record)自定义;一列合并显示多项信息时用exportColumns拆成多列(如订单列导出为订单号、店铺、下单时间)。 - 金额、数量导出原始数值(不带货币符号和千分位)。
- 订单导出按当前筛选(含标签、类型、地址问题、预估利润),前端分页取数,每页 500。
Excel 导入
电商的大部分数据可以用 Excel 导入,没有接口的平台靠它工作:
| 导入 | 接口 | 说明 |
|---|---|---|
| 在线商品 | POST /ecom/listing/import | 店铺 × 平台 SKU,可带映射物料与多件装 |
| SKU 配对 | /ecom/pairing/* | 店铺编码、平台 SKU、物料编码、数量 |
| 平台订单 | POST /ecom/order/import | 一行一个订单行,同一店铺 + 订单号合并为一张订单,已存在的跳过 |
| 平台结算 | POST /ecom/settlement/import | 一行一笔费用,原始类型经费用映射识别 |
| 广告报告 | POST /ecom/ads/report/import | 亚马逊广告后台下载的 xlsx / csv,按英文表头识别报告类型 |
| 平台仓库存 | POST /ecom/platform-stock/import | 与系统平台仓库存比对差异 |
| 回款流水 | POST /ecom/payout/import | 收款平台流水,自动匹配结算单 |
| 评价、竞品价格 | 各页面 | 平台不开放接口时导入 |
实现:前端 ImportModal(列可配置字典、名称查找、数字、日期、是否);后端接收 ImportRequest<T>,调用 ImportExecutor.run(req, 新增方法, 校验分组),与手工新增相同的校验,任何一行出错整批不导入并列出出错的行。
单据编号
「系统管理 → 编码规则」按单据配置前缀、日期格式、流水位数和重置周期。新单据取号用 DocNoService.next(规则标识),并在本模块的 XxxDocNos 中声明 DocNoCatalog(如 EcomDocNos、EcomOwhDocNos、EcomDevDocNos),未声明的标识按默认格式生成但不出现在页面中。

单据打印
后端用 JasperReports 生成 PDF,在预览窗口中打印或下载;「系统管理 → 打印模板」按单据配置纸张、方向、页边距、表头字段、明细列、签字栏,可下载默认 JRXML 用 Jaspersoft Studio 修改后上传,也支持套打和多份打印格式。

新增单据打印:
- 后端
printDocs(doc, 标题, 模板标识),单据的值一律通过参数 / 数据源传入。 - 前端在
utils/printTemplates.js的PRINT_TYPES中登记字段、列、签字栏名称(匹配键为中文名称,显示时按语言翻译),与 doc 中一致。
电商相关的打印:
| 打印 | 模板 / 实现 |
|---|---|
| 拣货单 | ecom.pickList:按仓库分组,按库位区域 → 拣货顺序 → 编码汇总 |
| 装箱单、箱唛 | ecom.packingList、ecom.cartonLabel(头程货件装箱) |
| 面单 | 物流商接口返回的 PDF 保存在附件目录,批量打印时用 OpenPDF 合并 |
| FNSKU 标签 | 前端 utils/labels.js 的 label.fnsku(Code128) |