Excel 单证模板
Excel 单证模板用于从业务记录一键导出带格式的 .xlsx（形式发票、装箱单、报关资料等），支持 自定义字段 占位符。
入口
管理 → Bring外贸 → Excel单证模板
预装模板
| 名称 | 实体类型 | 典型用途 |
|---|---|---|
| 报价单 | 报价单 CQuote | 对客户报价 Excel |
| 形式发票 | 销售订单 CSalesOrder | Proforma Invoice |
| 装箱单 | 出运单 CShippingOrder | Packing List |
| 报关单 | 出运单 CShippingOrder | 报关资料 |
销售合同、需要再改条款的形式发票 / 报价单见 Word 单证模板 预装样例。
新建或修改模板
- 点击 创建 Excel单证模板 或编辑已有记录
- 填写：
| 字段 | 说明 |
|---|---|
| 名称 | 如下拉显示「形式发票」 |
| 实体类型 | 报价单 / 销售单 / 出运单 / 采购单等 |
| 状态 | 启用 后才会在详情页出现 |
| 模板文件 | 上传 .xlsx |
| 可用占位符 | 只读帮助区，见下文 |
- 保存
占位符使用方法
第一步：在系统中复制占位符
- 编辑 Excel 模板记录时，先选择 实体类型
- 下方 可用占位符（可复制到模板单元格） 区域出现下拉
- 按中文标签选择字段（含 自定义字段）
- 复制显示的占位符，如
{{name}}、{{quoteDate}}
第二步：粘贴到 Excel 文件
- 用 Microsoft Excel 或 WPS 打开
.xlsx - 在目标单元格粘贴占位符（可与其他文字混排，如
PO: {{customerPoNo}}） - 保存文件，回到系统 重新上传 模板文件
占位符类型
| 类型 | 示例 | 说明 |
|---|---|---|
| 单字段 | {{totalPrice}} |
单据头字段 |
| 关联字段 | {{account.name}} |
客户公司名 |
| 关联字段 | {{account.contactName}} |
联系人 |
| 明细字段 | {{productsData[quantity]}} |
产品行数量（按行展开） |
| 明细字段 | {{productsData[name]}} |
产品名称 |
| 日期 | {{today}} |
导出当天 |
| 时间 | {{now}} |
导出时刻 |
明细可用键以编辑页列表为准；报价/销售/出运单明细通常含：名称、数量、单价、金额、规格、箱数、重量等。
自定义字段
在报价单添加 paymentTerms 后，占位符列表会出现对应中文项，复制 {{paymentTerms}} 放入 Excel 即可。
业务端：导出 Excel
- 打开已保存的报价单 / 销售单 / 出运单等 详情
- 点击 打印到 Excel（该实体有 启用 的模板时显示）
- 选择模板
- 浏览器下载
.xlsx，默认文件名为 模板名称-单号.xlsx（例如形式发票-QT2026001.xlsx）
Excel 不能在浏览器里预览，也不能从网页直接唤起本机 Excel / WPS。点导出就是下载；下载完成后用本机软件打开。
若按钮不存在：
- 管理 → Bring外贸 → Excel 单证模板 中该实体至少有一个 启用 的模板
- 当前用户对该实体有 read/export 权限
- 管理 → 清除缓存 后刷新浏览器
采购单 Excel 模板（扩展）
系统未强制预装采购单 Excel，可自行：
- 制作
.xlsx，单元格写入{{name}}、{{supplier.name}}、{{productsData[...]}}等 - 创建 Excel单证模板，实体类型选 采购订单 CPurchaseOrder
- 启用后在采购单详情 打印到 Excel
与 PDF 模板对比
| PDF 模板 | Excel 模板 | |
|---|---|---|
| 编辑 | HTML 在系统内 | 本地 Excel |
| 公式/合并单元格 | 不支持 | 支持 |
| 占位符 | {{field}} |
同左，明细用 [key] |
| 入口 | 打印 PDF | 打印到 Excel |
常见问题
Q：详情没有「打印到 Excel」？
- 该实体在 Excel 单证模板 中需有 启用 的模板
- 用户需有 read/export 权限
- 管理 → 清除缓存 后刷新
Q：导出后占位符没替换？
- 占位符必须与列表中完全一致，勿有多余空格
- 重新上传修改后的 xlsx
Q：明细只填充一行？
- 明细占位符应放在模板设计的数据行；多行产品会向下扩展
Q：能否一个实体多个模板？
- 可以；导出时弹窗选择