cs.fin.report.suggest
按款项账目或往来方组合条件查询认领匹配建议。
- 请求路由:
cs.fin.report.suggest- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "cs.fin.report.suggest",
"data" : {
"cashEntryId" : "FE20260620001"
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
cashEntryId | String | 否 | 款项账目号;提供时优先使用该账目的方向、币种、往来方及未认领余额。 |
partyId | String | 否 | 往来方 ID;未提供 cashEntryId 时必填。 |
flow | String | 否 | 应收或应付方向;仅在未提供 cashEntryId 时作为可选查询条件。 |
currency | String | 否 | 币种;仅在未提供 cashEntryId 时作为可选查询条件。 |
返回
按组内待分配金额合计升序排列的全部资金档分组,包含业务标题及全部有效匹配账目
[
{
"finJobId" : "FJ20260616001",
"bizJobId" : "JOB20260616001",
"customerName" : "深圳市鹏海国际货运",
"entries" : [
{
"entryId" : "FE20260616001",
"finJobId" : "FJ20260616001",
"party" : {
"role" : "CUSTOMER",
"id" : "CUST10086",
"name" : "深圳市鹏海国际货运"
},
"amount" : 11300.0,
"currency" : "CNY",
"baseAmount" : 11300.0,
"occurAt" : "2026-06-16T08:00:00Z",
"flow" : "AR",
"nature" : "ACCRUAL",
"stage" : "ACTUAL",
"chargeCode" : "OCEAN_FREIGHT",
"chargeInfo" : {
"name" : "海运费",
"nameEn" : "Ocean Freight"
},
"settledAmount" : 0,
"remark" : "海运费应收(金额匹配,建议核销)"
}
]
}
]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
finJobId | String | 资金档号,作为分组的稳定标识;同一客户的不同资金档分别返回。 |
bizJobId | String | 资金档对应的业务工作单号。 |
customerName | String | 资金档业务快照中的客户名称,不取账目的往来方名称。 |
entries | Object[] | 本资金档的全部有效匹配账目,包含费用项目名称;按匹配优先级排序,完整返回。 |
entries.[].entryId | String | 账目号(主键) |
entries.[].finJobId | String | 所属资金档号 |
entries.[].source | Object | 业务来源引用 |
entries.[].source.type | String | 来源类型,例如 ATD / AN / BOOKING / ENTRUST / CHANGE / MANUAL |
entries.[].source.bizId | String | 业务单据 id(工作单号/提单号/委托号等) |
entries.[].source.eventRef | String | 触发该记账的事件/调用引用,用于幂等与审计 |
entries.[].party | Object | 往来对象 |
entries.[].party.role | String | 角色 |
entries.[].party.id | String | 往来对象 id(客户/供应商/代理/组织 id) |
entries.[].party.name | String | 名称快照 |
entries.[].receiptEntity | Object | 实际收款主体快照,仅用于收款,可与数据所属 legalEntityId 不同;提供时 ID、名称均必填。 |
entries.[].receiptEntity.id | String | 实际收款主体 ID,提供主体信息时必填。 |
entries.[].receiptEntity.name | String | 登记时的主体名称,后续主体更名不回写历史账目。 |
entries.[].receiptAccount | Object | 实际收款账号快照,仅用于收款;提供时开户名称、银行名称、账号均必填。 |
entries.[].receiptAccount.accountName | String | 开户名称,提供账号信息时必填。 |
entries.[].receiptAccount.bankName | String | 开户银行名称,提供账号信息时必填。 |
entries.[].receiptAccount.bankCode | String | 银行联行号。 |
entries.[].receiptAccount.bankAccount | String | 银行账号,提供账号信息时必填。 |
entries.[].receiptAccount.currency | String | 账号币种快照,不用于替代本笔账目的记账币种。 |
entries.[].receiptAccount.swiftCode | String | 国际汇款使用的 SWIFT 代码。 |
entries.[].receiptAccount.address | String | 银行账号地址信息。 |
entries.[].invoices | String[] | 关联发票的内部 invoiceId 数组,可为空;所有流向和账目性质均可登记,仅保存单向引用。 |
entries.[].amount | Number | 原币含税往来金额(价税合计,带符号)。收付款与往来余额均以此为准。 |
entries.[].currency | String | 币种 |
entries.[].fxRate | Number | 记账汇率(原币 → 本位币) |
entries.[].baseAmount | Number | 本位币含税金额(带符号)= amount × fxRate |
entries.[].direction | String | 借贷方向(预留会计科目映射,不参与余额计算) |
entries.[].occurAt | String | 业务发生时间 |
entries.[].priceType | String | 价税类型 |
entries.[].taxRate | Number | 税率(如 0.06 / 0.09 / 0) |
entries.[].taxAmount | Number | 原币税额(带符号) |
entries.[].netAmount | Number | 原币不含税净额(带符号)= amount − taxAmount |
entries.[].flow | String | 资金流向 AR/AP |
entries.[].nature | String | 账目性质 |
entries.[].stage | String | 阶段:预估/实际 |
entries.[].chargeCode | String | 费用项目编码 |
entries.[].chargeInfo | Object | 认领匹配查询时按费用编码关联的当前中英文名称;只读映射接收聚合结果,但不写入账目存储。 |
entries.[].chargeInfo.name | String | 费用项目中文名称。 |
entries.[].chargeInfo.nameEn | String | 费用项目英文名称。 |
entries.[].tags | String[] | 标签(URN 前缀字符串,如 term:PP、src:ATD、region:POL、org:SHA) |
entries.[].settledAmount | Number | 已核销额(原币,正值) |
entries.[].reverseOf | String | 红冲指向的被冲账目号 |
entries.[].remark | String | 备注 |
entries.[].legalEntityId | String | 法人主体id |
entries.[].customerId | String | 客户id |
entries.[].extraProps | Object | 扩展属性 |
entries.[].crBy | String | 创建者 |
entries.[].upBy | String | 最后修改者 |
entries.[].crDate | String | 创建时间 |
entries.[].upDate | String | 最后修改时间 |
entries.[].tenantId | String | 租户ID |
entries.[].id | Varies | 返回账目主键,供统一数据访问与查询映射使用。 |