Word 单证模板

Word 单证模板与 Excel 单证模板平行：上传带占位符的 Word 文件，业务详情页一键导出并填入单据数据。

入口

管理 → Bring外贸 → Word单证模板

详情页按钮：打印到 Word（该实体至少有一个启用的模板时显示）。

安装或升级扩展后会写入下列通用样例（不是某家客户的品牌稿）。已有同名模板时升级不会覆盖你改过的文件。

名称	实体类型	典型用途
销售合同	销售订单 CSalesOrder	中英对照 Sales Contract：明细、付款、保险/检验/不可抗力/仲裁等条款、银行账户、双方签字。导出后再改条款最常见。
形式发票	销售订单 CSalesOrder	Word 版 Proforma Invoice，方便改付款、银行信息和备注后再发给客户或开证。
报价单	报价单 CQuote	Word 版报价，带有效期与买方确认栏。

装箱单、报关单、商业发票更常走 Excel / PDF；订舱、提单、装船通知一般由货代出具，系统不预装。华科东尼等客户定制稿请单独上传，不要当默认模板。

条款、仲裁地、保险比例等请导出后按公司法务要求修改。也可在 管理 → Bring外贸 → Word单证模板 打开记录、下载文件改版式后重新上传。

导出格式与上传文件一致：传 .docx 就下 .docx，传 .doc 就下 .doc。默认文件名为 模板名称-单号。

与 Excel 同一套：

{{name}}
{{account.name}}
{{today}}
{{productsData[name]}}
{{productsData[quantity]}}
{{productsData[unitPrice]}}

单据级字段用 {{字段}} 或 {{关联.字段}}
汇总表明细（一行一条）：占位符写在同一表格行各单元格，例如 {{productsData[name]}}。导出时按产品条数复制该行，不用 #each；每行填对应产品，不会重复第一行
产品图片：{{productsData[productImageId]}}、{{productsData[cImage2Id]}} 等同段可写多个；有图则各占一行，无图则跳过（不插图，表格格内仍保留空段落以免 Word 报错）。可与文字混排，例如先图再写「技术参数：」+ {{productsData[cTechParams]}}
多行文本（规格、描述、技术参数等）：CRM 里用回车分行；富文本 <div> / <p> / <br> 也会还原为多段。导出时一行一段 Word 段落（不是 Shift+Enter 软换行）。若行距偏大，把该段的「段后间距」设为 0
产品参数 / 图文介绍（表格外、多段一块）：必须用下面这对标记圈住整块，且各单独成段（不要跟正文写在同一段里）：

{{#each productsData}}
（这里是一条产品的标题、图片、简介、技术参数……）
{{/each}}

导出时整块按产品条数复制；标记本身不会出现在成品里。漏写则参数只会填第一条。 - 上面汇总表、下面参数介绍可以同时用：表循环行，#each 循环块 - 占位符一次敲完，少改中途字体，避免 Word 把 {{name}} 拆开

只收 .docx 与 Word 97–2003 .doc，不收 .docm。

填值引擎只处理 .docx。上传 .doc 时，系统用本机 LibreOffice（soffice）转成 .docx 再填值，导出时再转回 .doc。

Word / Excel 不能在浏览器里预览，也不能从网页直接唤起本机 Word / WPS。点导出就是下载；下载完成后用本机软件打开。PDF 仍可在新标签预览。

Q：详情没有「打印到 Word」？

Q：上传 .doc 报找不到 LibreOffice？

Q：产品参数只填了第一条？

Q：表格循环每行都是第一个产品？

已按行填各产品。若仍不对，确认占位符在同一表格行，且重新上传了模板。

Q：产品图片格子只出现一串 ID？

占位符须写完整 {{productsData[productImageId]}}（两个 }）。产品须已有图片。可与「技术参数」等文字写在同一格。

Q：占位符没替换？