Skip to content

导入导出与打印 ​

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 修改后上传,也支持套打和多份打印格式。

打印模板

新增单据打印:

  1. 后端 printDocs(doc, 标题, 模板标识),单据的值一律通过参数 / 数据源传入。
  2. 前端在 utils/printTemplates.js 的 PRINT_TYPES 中登记字段、列、签字栏名称(匹配键为中文名称,显示时按语言翻译),与 doc 中一致。

电商相关的打印:

打印模板 / 实现
拣货单ecom.pickList:按仓库分组,按库位区域 → 拣货顺序 → 编码汇总
装箱单、箱唛ecom.packingList、ecom.cartonLabel(头程货件装箱)
面单物流商接口返回的 PDF 保存在附件目录,批量打印时用 OpenPDF 合并
FNSKU 标签前端 utils/labels.js 的 label.fnsku(Code128)

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com