跳转至

Bring 外贸实体关系总表

理解 实体（Entity） 与 关系（Relationship） 是配置字段、布局、权限和模板占位符的基础。本节说明 BringCRM 中主要业务对象如何关联。

参考 Espo：Entity Manager - Relationships

关系类型说明

Espo 类型 中文 含义 界面表现
belongsTo 多对一 当前记录「属于」一条父记录 Link 字段（下拉选一个）
hasMany 一对多 当前记录「拥有」多条子记录 底部关系面板列表
hasOne 一对一 当前记录对应唯一一条关联记录 Link 或专用面板
hasChildren 子实体 通用子记录（如附件） 附件面板
linkMultiple 多选关联 多对多快捷选择 Teams 等多选字段

核心业务链路（数据流）

flowchart LR
  Account[客户 Account] --> CQuote[报价单 CQuote]
  Account --> CSample[样品 CSampleShipment]
  CQuote --> CSales[销售单 CSalesOrder]
  CSample --> CSales
  CSales --> CPurchase[采购单 CPurchaseOrder]
  CSales --> CShip[出运单 CShippingOrder]
  CSales --> CRecv[应收账款 CReceivables]
  CSales --> CProfit[利润 CProfit]
  CSales --> CTax[退税 CTaxRefund]
  CPurchase --> CPay[应付 CPayables]
  CShip --> CPay
  CRecv --> CReceipt[收款 CReceipts]
  CPay --> CPayment[付款 CPayments]

主数据实体

客户（Account）

关系名 类型 关联实体 说明
assignedUser belongsTo User 指派业务员；空 = 公海
teams hasMany Team 团队
contacts hasMany Contact 联系人（Espo 原生）
quotes hasMany CQuote 报价单
cSalesOrders hasMany CSalesOrder 销售订单
cSampleShipments hasMany CSampleShipment 样品寄送

Bring 扩展字段：followUpProgress（跟进进度）、customerLevel（客户级别）、assignedAt（领取时间）等。

产品库（CProduct）

独立主数据，通过各单据的 productsData（jsonArray 明细行）引用，并持久化到 *Item 明细实体（专业版）。

供应商（CSupplier） / 货代（CForwarder）

实体 主要被引用方
CSupplier 采购单 CPurchaseOrder
CForwarder 出运单 CShippingOrder、样品寄送

销售前端单据

报价单（CQuote）

关系名 类型 关联实体 说明
account belongsTo Account 客户（必填业务场景）
contact belongsTo Contact 联系人
assignedUser belongsTo User 负责人
salesOrder belongsTo CSalesOrder 转化后的销售单（通常一对一）
sampleShipments hasMany CSampleShipment 由报价转的样品
quoteItems hasMany CQuoteItem 持久化明细行（专业版）

productsData：编辑态明细（jsonArray），含产品、数量、单价等；打印模板用 {{#each productsData}}。

样品寄送（CSampleShipment）

关系名 类型 关联实体
account belongsTo Account
quote belongsTo CQuote
salesOrder belongsTo CSalesOrder
forwarder belongsTo CForwarder

销售订单（CSalesOrder）— 核心枢纽

关系名 类型 关联实体 说明
account belongsTo Account 客户
quote belongsTo CQuote 来源报价
sampleShipment belongsTo CSampleShipment 来源样品
purchaseOrders hasMany CPurchaseOrder 一对多采购
shippingOrders hasMany CShippingOrder 一对多出运
receivable hasOne CReceivables 应收账款（专业版自动）
profit belongsTo CProfit 利润清单（专业版自动）
taxRefund hasOne CTaxRefund 退税款项
salesOrderItems hasMany CSalesOrderItem 明细行

采购与出运

采购单（CPurchaseOrder）

关系名 类型 关联实体
supplier belongsTo CSupplier
salesOrder belongsTo CSalesOrder
payables hasOne / 关联 CPayables
purchaseOrderItems hasMany CPurchaseOrderItem

出运单（CShippingOrder）

关系名 类型 关联实体
salesOrder belongsTo CSalesOrder
forwarder belongsTo CForwarder
payables 关联 CPayables
shippingOrderItems hasMany CShippingOrderItem

财务实体（专业版）

实体 主要关系 说明
CReceivables 应收 account, salesOrder 1:1 销售单
CPayables 应付 supplier/forwarder, purchaseOrder/shippingOrder 采购或出运来源
CReceipts 收款 account, receivable, fundAccount 回写应收余额
CPayments 付款 payables, fundAccount 回写应付余额
CTaxRefund 退税 salesOrder 退税申报
CProfit 利润 salesOrder 预期/真实利润
CFundAccount 资金账户 receipts, payments 余额汇总
CFundAdjustment 资金调账 fundAccount 手工调账

明细行实体（*Item）

明细实体 父实体 用途
CQuoteItem CQuote 报价明细分析、导入
CSalesOrderItem CSalesOrder 订单明细分析
CPurchaseOrderItem CPurchaseOrder 采购明细
CShippingOrderItem CShippingOrder 出运明细

明细由保存父单据时从 productsData 同步持久化（专业版 tab 可见）。

模板与配置实体

实体 说明
Template Espo PDF 模板
ExcelTemplate Bring Excel 单证（专业版）
ImportTemplate Bring 导入列映射（专业版）

占位符中的关系字段写法

PDF / Excel 模板可通过 点号 访问关联实体字段：

占位符示例 含义
{{account.name}} 客户名称
{{account.contactName}} 客户主联系人
{{contact.emailAddress}} 联系人邮箱
{{salesOrder.name}} 出运单上关联的销售单号
{{salesOrder.account.name}} 出运单 → 销售单 → 客户
{{supplier.name}} 采购单供应商

Excel 占位符列表在模板编辑页按中文标签生成，见 其它 Excel 模板。

自定义关系（管理员）

如需新建实体或增加关系：

  1. 管理 → 实体管理器 → {实体} → 关系
  2. 选择关系类型（一对多、多对多等）
  3. 保存后在 布局 → 底部面板 或 详情布局 加入 Link 字段 / 关系面板

详见 实体管理器 - 关系。

勿随意删除 Bring 预置关系

删除 account、salesOrder 等核心关系会导致自动化、利润、应收应付失效。

相关文档

← Espo 平台配置概述