cs.fin.ledger.register-cash

收付款登记：登记一笔不经账单的实际收款/付款，落入所属法人主体的暂挂资金档，等待认领核销。

• 请求路由: cs.fin.ledger.register-cash
• 交互模型: Request Response
• 访问限制: 无

收款可不指定付款方（不明款项），只填付款户名或都不填；付款必须指定收款方。 同一银行流水号在同流向下只能登记一次（原登记红冲后可重新登记）。

legalEntityId 决定数据归属及暂挂档，receiptEntity 单独记录实际收款主体，两者可以不同。 收款主体、账号及发票均可省略；提供时分别要求主体 ID/名称、账号户名/银行名称/账号、 每张发票号码/类型/非负税率齐全。新增快照在详情和列表中返回，登记后不支持单独补录修改。

请求

RSocket.rr({
  "route" : "cs.fin.ledger.register-cash",
  "data" : {
    "flow" : "AR",
    "legalEntityId" : "LE001",
    "party" : {
      "role" : "CUSTOMER",
      "id" : "CUST10090",
      "name" : "青岛远大进出口"
    },
    "receiptEntity" : {
      "id" : "LE002",
      "name" : "实际收款公司"
    },
    "receiptAccount" : {
      "accountName" : "实际收款公司",
      "bankName" : "示例银行",
      "bankAccount" : "DEMO-001",
      "currency" : "USD"
    },
    "invoices" : [
      {
        "invoiceNo" : "INV-DEMO-001",
        "invoiceType" : "增值税普通发票",
        "taxRate" : 0.06
      }
    ],
    "amount" : 5000.0,
    "currency" : "USD",
    "occurAt" : "2026-10-23T02:00:00Z",
    "method" : "T/T 电汇",
    "bankRef" : "BOC20261023000123",
    "eventRef" : "ui-cash-AR-1761184800000",
    "remark" : "客户合并付款 9 月海运费"
  }
});

请求参数

名称	类型	必须	说明
flow	String	否	资金流向：AR 收款 / AP 付款 AR - 应收 AP - 应付
legalEntityId	String	否	数据所属法人主体，为空时归入租户默认暂挂档；与实际收款主体 receiptEntity 相互独立
party	Object	否	往来单位。收款可只填名称或不填（不明款项）；付款须指定 id
party.role	String	否	角色 CUSTOMER - 客户（直客/收货人） SUPPLIER - 供应商（船东/拖车行/报关行/仓库等） AGENT - 海外代理 ORG - 内部组织（口岸/部门）
party.id	String	否	往来对象 id（客户/供应商/代理/组织 id）
party.name	String	否	名称快照
receiptEntity	Object	否	实际收款主体快照，仅用于收款，可与数据所属 legalEntityId 不同；提供时 ID、名称均必填。
receiptEntity.id	String	否	实际收款主体 ID，提供主体信息时必填。
receiptEntity.name	String	否	登记时的主体名称，后续主体更名不回写历史账目。
receiptAccount	Object	否	实际收款账号快照，仅用于收款；提供时开户名称、银行名称、账号均必填。
receiptAccount.accountName	String	否	开户名称，提供账号信息时必填。
receiptAccount.bankName	String	否	开户银行名称，提供账号信息时必填。
receiptAccount.bankCode	String	否	银行联行号。
receiptAccount.bankAccount	String	否	银行账号，提供账号信息时必填。
receiptAccount.currency	String	否	账号币种快照，不用于替代本笔账目的记账币种。 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
receiptAccount.swiftCode	String	否	国际汇款使用的 SWIFT 代码。
receiptAccount.address	String	否	银行账号地址信息。
invoices	Object[]	否	收款关联发票快照，可为空或多张；每张须包含号码、类型和税率，不参与账目价税计算。
invoices.[].invoiceNo	String	否	发票号码，关联发票时必填。
invoices.[].invoiceType	String	否	调用方提供的发票类型值，关联发票时必填，暂不限制为固定枚举。
invoices.[].taxRate	Number	否	非负发票税率，关联发票时必填；例如 0.06 表示 6%，允许零税率。 不替代账目自身的 taxRate，也不据此计算收款税额。
amount	Number	否	金额（原币，必须为正）
currency	String	否	币种 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
occurAt	String	否	到账/付款日期，为空取当前时间
method	String	否	收付款方式（如 T/T 电汇、支票），记为 method: 标签
bankRef	String	否	银行流水号/回单号，记为来源单据号并据此判重
eventRef	String	否	本次提交的幂等键，重复提交返回已登记的账目
remark	String	否	摘要

返回

已登记的款项账目

{
  "entryId" : "FE2026102300001",
  "finJobId" : "FJSUS-cgla-LE001",
  "source" : {
    "type" : "RECEIPT",
    "bizId" : "BOC20261023000123",
    "eventRef" : "ui-cash-AR-1761184800000"
  },
  "party" : {
    "role" : "CUSTOMER",
    "id" : "CUST10090",
    "name" : "青岛远大进出口"
  },
  "receiptEntity" : {
    "id" : "LE002",
    "name" : "实际收款公司"
  },
  "receiptAccount" : {
    "accountName" : "实际收款公司",
    "bankName" : "示例银行",
    "bankAccount" : "DEMO-001",
    "currency" : "USD"
  },
  "invoices" : [
    {
      "invoiceNo" : "INV-DEMO-001",
      "invoiceType" : "增值税普通发票",
      "taxRate" : 0.06
    }
  ],
  "amount" : 5000.0,
  "currency" : "USD",
  "fxRate" : 7.12,
  "baseAmount" : 35600.0,
  "direction" : "CREDIT",
  "occurAt" : "2026-10-23T02:00:00Z",
  "priceType" : "NON_TAXABLE",
  "taxRate" : 0,
  "flow" : "AR",
  "nature" : "CASH",
  "stage" : "ACTUAL",
  "tags" : [
    "src:RECEIPT",
    "method:T/T 电汇"
  ],
  "settledAmount" : 0,
  "remark" : "客户合并付款 9 月海运费"
}

返回属性

名称	类型	说明
entryId	String	账目号（主键）
finJobId	String	所属资金档号
source	Object	业务来源引用
source.type	String	来源类型，例如 ATD / AN / BOOKING / ENTRUST / CHANGE / MANUAL
source.bizId	String	业务单据 id（工作单号/提单号/委托号等）
source.eventRef	String	触发该记账的事件/调用引用，用于幂等与审计
party	Object	往来对象
party.role	String	角色 CUSTOMER - 客户（直客/收货人） SUPPLIER - 供应商（船东/拖车行/报关行/仓库等） AGENT - 海外代理 ORG - 内部组织（口岸/部门）
party.id	String	往来对象 id（客户/供应商/代理/组织 id）
party.name	String	名称快照
receiptEntity	Object	实际收款主体快照，仅用于收款，可与数据所属 legalEntityId 不同；提供时 ID、名称均必填。
receiptEntity.id	String	实际收款主体 ID，提供主体信息时必填。
receiptEntity.name	String	登记时的主体名称，后续主体更名不回写历史账目。
receiptAccount	Object	实际收款账号快照，仅用于收款；提供时开户名称、银行名称、账号均必填。
receiptAccount.accountName	String	开户名称，提供账号信息时必填。
receiptAccount.bankName	String	开户银行名称，提供账号信息时必填。
receiptAccount.bankCode	String	银行联行号。
receiptAccount.bankAccount	String	银行账号，提供账号信息时必填。
receiptAccount.currency	String	账号币种快照，不用于替代本笔账目的记账币种。 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
receiptAccount.swiftCode	String	国际汇款使用的 SWIFT 代码。
receiptAccount.address	String	银行账号地址信息。
invoices	Object[]	收款关联发票快照，可为空或多张；每张须包含号码、类型和税率，不参与账目价税计算。
invoices.[].invoiceNo	String	发票号码，关联发票时必填。
invoices.[].invoiceType	String	调用方提供的发票类型值，关联发票时必填，暂不限制为固定枚举。
invoices.[].taxRate	Number	非负发票税率，关联发票时必填；例如 0.06 表示 6%，允许零税率。 不替代账目自身的 taxRate，也不据此计算收款税额。
amount	Number	原币含税往来金额（价税合计，带符号）。收付款与往来余额均以此为准。
currency	String	币种 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
fxRate	Number	记账汇率（原币 → 本位币）
baseAmount	Number	本位币含税金额（带符号）= amount × fxRate
direction	String	借贷方向（预留会计科目映射，不参与余额计算） DEBIT - 借 CREDIT - 贷
occurAt	String	业务发生时间
priceType	String	价税类型 TAX_INCLUSIVE - 含税：amount 为价税合计，税额从中拆出 TAX_EXCLUSIVE - 不含税：amount 为不含税净额，税额在其上，归一化后 amount 提升为含税合计 NON_TAXABLE - 不征税：免税 / 代收代付，无税额
taxRate	Number	税率（如 0.06 / 0.09 / 0）
taxAmount	Number	原币税额（带符号）
netAmount	Number	原币不含税净额（带符号）= amount − taxAmount
flow	String	资金流向 AR/AP AR - 应收 AP - 应付
nature	String	账目性质 ACCRUAL - 应计：产生债权/债务 CASH - 资金：实际收付款 SETTLE - 核销：勾稽产生的账目（预留，当前核销以 Settlement 记录） ADJUST - 调整：折让/坏账/汇兑损益等
stage	String	阶段：预估/实际 EST - 预估 ACTUAL - 实际
chargeCode	String	费用项目编码
tags	String[]	标签（URN 前缀字符串，如 term:PP、src:ATD、region:POL、org:SHA）
settledAmount	Number	已核销额（原币，正值）
reverseOf	String	红冲指向的被冲账目号
remark	String	备注
legalEntityId	String	法人主体id
customerId	String	客户id
extraProps	Object	扩展属性
crBy	String	创建者
upBy	String	最后修改者
crDate	String	创建时间
upDate	String	最后修改时间
tenantId	String	租户ID
id	Varies	返回账目主键，供统一数据访问与查询映射使用。

下载结果模型定义