常见问题与实操指引
本文整理用户真实问过或高频遇到的具体操作问题，采用「问题 → 步骤 → 注意」格式，便于查阅。
明细与产品库
报价单明细里如何显示产品库的某个属性？（Foreign 外键）
场景：产品库有「海关编码」「材质」「品牌」等字段，希望报价单（或销售单、采购单、出运单）明细表格里多一列，选产品后自动显示该属性。
原理：明细行通过 产品 Link 关联 CProduct；在明细实体（如 报价明细 CQuoteItem）上增加 Foreign（外键） 字段，link = product，field = 产品上的字段名。系统把这类字段当作 传输字段（transport）：从 product 读出展示，不必写入子表（与内置的 productCode、specification 相同机制）。
操作步骤：
- 在产品库加字段（若还没有）
- 管理 → 实体管理器 → 产品库 CProduct → 字段 → 添加字段
- 例：名称
customsCode，标签「海关编码」，类型 单行文本 -
保存
-
在报价明细加 Foreign 字段
- 管理 → 实体管理器 → 报价明细 CQuoteItem → 字段 → 添加字段
- 类型选 Foreign（关联字段只读）
- 配置：
- Label：海关编码（界面列名）
- Link：product（关联产品）
- Field：customsCode（与 CProduct 上字段 Name 一致）
- Read-only：是（推荐）
- Not Storable：是（推荐；系统对
foreign + link=product也会按传输字段处理）
-
保存
-
把列加到报价单明细表格
- 管理 → 实体管理器 → 报价明细 CQuoteItem → 布局
- 打开 listQuote（报价单内明细表专用布局，不是普通 List）
- 在合适位置 添加字段「海关编码」
-
保存
-
清除缓存：管理 → 清除缓存，刷新浏览器
-
验证：编辑报价单 → 明细行选择产品 → 新列应显示产品库中该字段的值
其它单据：销售明细 CSalesOrderItem 用布局 listSales；采购明细 listPurchase；出运明细 listShipping。Foreign 字段配置方式相同。
打印到 PDF/Excel：
- 单证明细占位符使用产品行键名，如
{{productsData[customsCode]}}（若 Foreign 字段 Name 为customsCode） - 在 Excel 单证模板 编辑页「可用占位符」中按中文标签复制
注意：
- Foreign 字段 随产品库当前值变化；若改产品后希望报价单保留历史快照，应改用 可存储字段（varchar 等）并在选产品时通过公式/复制逻辑写入（见下一问）
- 字段 Name 不要用
product、quantity等系统保留名
明细里要显示「可修改、与产品无关」的列怎么办？
场景：同一产品在 A 报价写「红色包装」，B 报价写「蓝色包装」，不能只用产品库只读字段。
做法：在 CQuoteItem（或对应 Item）添加 varchar / text 等 可存储 字段（不要选 Foreign），加入 listQuote* 布局。业务员在明细行手工填写。
若希望 选产品时默认带出、仍可改：在产品库加字段，同时在明细加 同名可存储 varchar（不用 Foreign），需自行维护或接受手工录入；Bring 默认 productLineItemFieldCopy 仅复制 name、unit、单价等（见系统配置），自定义复制需开发扩展，一般企业用「Foreign 只读」或「纯手工列」即可。
报价/销售/采购/出运明细列不一样怎么配？
各单据明细表使用 不同布局名：
| 单据 | 明细实体 | 布局名 |
|---|---|---|
| 报价单 | CQuoteItem | listQuote |
| 销售单 | CSalesOrderItem | listSales |
| 采购单 | CPurchaseOrderItem | listPurchase |
| 出运单 | CShippingOrderItem | listShipping |
在对应实体的该布局里分别加列，互不影响。
单证与自定义字段
报价单上自定义字段如何打印到 PDF？
详见 制作 PDF 单证模板。
Excel 单证里如何用自定义字段？
- 字段加在对应实体（报价单/销售单/出运单）
- 管理 → Bring外贸 → Excel单证模板 → 编辑页选实体类型 → 可用占位符 复制
- 粘贴到
.xlsx单元格，重新上传模板
详见 其它 Excel 单证模板。
财务与收付款
收款/付款凭证只能传一张图，如何多张图片或 PDF？
原因：系统预置 收款记录 CReceipts 的 receiptImage、付款记录 CPayments 的 paymentImage，类型为 Image（单图），只能存一张图片。
推荐做法：用 多附件 字段。
操作步骤：
- 管理 → 实体管理器 → 收款记录 CReceipts → 字段 → 添加字段
- 类型：Attachment-Multiple（多附件）
- Label：付款凭证附件（或「收款凭证」）
- Name：如
receiptAttachments - 可选：Accept 限制为图片+PDF，或留空允许所有类型
- 布局 → 编辑 / 详情：把新字段放到「凭证」区域（可与原
receiptImage并存，或逐步弃用单图字段） - 清除缓存
- 编辑收款记录 → 上传多个文件（银行回单 JPG、合并 PDF 等）
付款记录 CPayments 同理，加 paymentAttachments 等多附件字段。
注意：
- 多附件字段 不会自动出现在 旧版 PDF 模板占位符里，除非模板单独设计；日常 查阅、审计、下载 用附件即可
- 若必须在 PDF 单证上列出附件，需定制模板或继续用单图字段作「封面图」
相关：字段类型详解 - Attachment-Multiple
为什么看不到「应收账款 / 利润」等财务菜单？
Bring 外贸专业版 才包含财务模块（应收、应付、收付款、利润、退税、资金账户等）。免费版仅 1 用户 + 基础报价订单。
处理：管理 → Bring外贸 → Bring外贸专业版许可 激活；或联系客服试用/购买。
应收详情「去收款」后要注意什么？
- 打开 应收账款 详情 → 去收款
- 填写金额、日期、资金账户、收款类型（预付款/尾款/退税款等）
- 上传凭证：单图用
receiptImage，多张用自定义 多附件 字段 - 保存后应收 已收/余额 自动更新
业务流转
报价单上没有「转换销售单」按钮？
常见原因：
| 原因 | 处理 |
|---|---|
| 免费版或未开自动化 | 激活 专业版 |
| 报价已转订单 | 状态为「已转订单」或已有关联销售单 |
| 无编辑权限 | 检查角色对 CQuote、CSalesOrder 权限 |
有权限时可手动 创建销售订单 并关联报价单。
公海客户在哪里？怎么领取？
- 客户 列表 → 筛选 公海客户（指派用户为空）
- 打开客户 → 领取客户；或列表批量 一键领取
需 专业版 公海功能。详见 客户与公海。
导入导出与模板
列表没有「按模板导入」？
专业版 功能。检查许可后，在实体列表找 按模板导入；模板在 管理 → Bring外贸 → 导入模板。
详见 导入数据/导出数据。
详情没有「打印到 Excel」？
同时满足：
- 专业版 已激活
- 该实体有 启用 的 Excel 单证模板（管理 → Bring外贸 → Excel单证模板）
- 清除缓存后刷新
PDF 打印免费版可用。详见 其它 Excel 模板。
系统与运维
改了字段/布局前台不生效？
- 管理 → 清除缓存
- 浏览器 Ctrl+F5 强刷
- 仍异常时 管理 → Rebuild