跳到主要内容

cs.fin.report.suggest

按款项账目或往来方组合条件查询认领匹配建议。

  • 请求路由: cs.fin.report.suggest
  • 交互模型: Request Stream
  • 访问限制: 无

请求​

RSocket.rs({
"route" : "cs.fin.report.suggest",
"data" : {
"cashEntryId" : "FE20260620001"
}
});

请求参数​

名称类型必须说明
cashEntryIdString否款项账目号;提供时优先使用该账目的方向、币种、往来方及未认领余额。
partyIdString否往来方 ID;未提供 cashEntryId 时必填。
flowString否应收或应付方向;仅在未提供 cashEntryId 时作为可选查询条件。
  • AR - 应收
  • AP - 应付
  • currencyString否币种;仅在未提供 cashEntryId 时作为可选查询条件。
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 币种中文名称
  • symbol - 币种货币符号
  • code - 获取币种代码(枚举名),用于序列化。
  • 返回​

    按组内待分配金额合计升序排列的全部资金档分组,包含业务标题及全部有效匹配账目

    [
    {
    "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" : "海运费应收(金额匹配,建议核销)"
    }
    ]
    }
    ]

    返回属性​

    名称类型说明
    finJobIdString资金档号,作为分组的稳定标识;同一客户的不同资金档分别返回。
    bizJobIdString资金档对应的业务工作单号。
    customerNameString资金档业务快照中的客户名称,不取账目的往来方名称。
    entriesObject[]本资金档的全部有效匹配账目,包含费用项目名称;按匹配优先级排序,完整返回。
    entries.[].entryIdString账目号(主键)
    entries.[].finJobIdString所属资金档号
    entries.[].sourceObject业务来源引用
    entries.[].source.typeString来源类型,例如 ATD / AN / BOOKING / ENTRUST / CHANGE / MANUAL
    entries.[].source.bizIdString业务单据 id(工作单号/提单号/委托号等)
    entries.[].source.eventRefString触发该记账的事件/调用引用,用于幂等与审计
    entries.[].partyObject往来对象
    entries.[].party.roleString角色
  • CUSTOMER - 客户(直客/收货人)
  • SUPPLIER - 供应商(船东/拖车行/报关行/仓库等)
  • AGENT - 海外代理
  • ORG - 内部组织(口岸/部门)
  • entries.[].party.idString往来对象 id(客户/供应商/代理/组织 id)
    entries.[].party.nameString名称快照
    entries.[].receiptEntityObject实际收款主体快照,仅用于收款,可与数据所属 legalEntityId 不同;提供时 ID、名称均必填。
    entries.[].receiptEntity.idString实际收款主体 ID,提供主体信息时必填。
    entries.[].receiptEntity.nameString登记时的主体名称,后续主体更名不回写历史账目。
    entries.[].receiptAccountObject实际收款账号快照,仅用于收款;提供时开户名称、银行名称、账号均必填。
    entries.[].receiptAccount.accountNameString开户名称,提供账号信息时必填。
    entries.[].receiptAccount.bankNameString开户银行名称,提供账号信息时必填。
    entries.[].receiptAccount.bankCodeString银行联行号。
    entries.[].receiptAccount.bankAccountString银行账号,提供账号信息时必填。
    entries.[].receiptAccount.currencyString账号币种快照,不用于替代本笔账目的记账币种。
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 币种中文名称
  • symbol - 币种货币符号
  • code - 获取币种代码(枚举名),用于序列化。
  • entries.[].receiptAccount.swiftCodeString国际汇款使用的 SWIFT 代码。
    entries.[].receiptAccount.addressString银行账号地址信息。
    entries.[].invoicesString[]关联发票的内部 invoiceId 数组,可为空;所有流向和账目性质均可登记,仅保存单向引用。
    entries.[].amountNumber原币含税往来金额(价税合计,带符号)。收付款与往来余额均以此为准。
    entries.[].currencyString币种
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 币种中文名称
  • symbol - 币种货币符号
  • code - 获取币种代码(枚举名),用于序列化。
  • entries.[].fxRateNumber记账汇率(原币 → 本位币)
    entries.[].baseAmountNumber本位币含税金额(带符号)= amount × fxRate
    entries.[].directionString借贷方向(预留会计科目映射,不参与余额计算)
  • DEBIT - 借
  • CREDIT - 贷
  • entries.[].occurAtString业务发生时间
    entries.[].priceTypeString价税类型
  • TAX_INCLUSIVE - 含税:amount 为价税合计,税额从中拆出
  • TAX_EXCLUSIVE - 不含税:amount 为不含税净额,税额在其上,归一化后 amount 提升为含税合计
  • NON_TAXABLE - 不征税:免税 / 代收代付,无税额
  • entries.[].taxRateNumber税率(如 0.06 / 0.09 / 0)
    entries.[].taxAmountNumber原币税额(带符号)
    entries.[].netAmountNumber原币不含税净额(带符号)= amount − taxAmount
    entries.[].flowString资金流向 AR/AP
  • AR - 应收
  • AP - 应付
  • entries.[].natureString账目性质
  • ACCRUAL - 应计:产生债权/债务
  • CASH - 资金:实际收付款
  • SETTLE - 核销:勾稽产生的账目(预留,当前核销以 Settlement 记录)
  • ADJUST - 调整:折让/坏账/汇兑损益等
  • entries.[].stageString阶段:预估/实际
  • EST - 预估
  • ACTUAL - 实际
  • entries.[].chargeCodeString费用项目编码
    entries.[].chargeInfoObject认领匹配查询时按费用编码关联的当前中英文名称;只读映射接收聚合结果,但不写入账目存储。
    entries.[].chargeInfo.nameString费用项目中文名称。
    entries.[].chargeInfo.nameEnString费用项目英文名称。
    entries.[].tagsString[]标签(URN 前缀字符串,如 term:PP、src:ATD、region:POL、org:SHA)
    entries.[].settledAmountNumber已核销额(原币,正值)
    entries.[].reverseOfString红冲指向的被冲账目号
    entries.[].remarkString备注
    entries.[].legalEntityIdString法人主体id
    entries.[].customerIdString客户id
    entries.[].extraPropsObject扩展属性
    entries.[].crByString创建者
    entries.[].upByString最后修改者
    entries.[].crDateString创建时间
    entries.[].upDateString最后修改时间
    entries.[].tenantIdString租户ID
    entries.[].idVaries返回账目主键,供统一数据访问与查询映射使用。

    下载结果模型定义