跳到主要内容

cs.fin.query.settlement.list

核销记录列表,按创建时间倒序。

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

请求​

RSocket.rs({
"route" : "cs.fin.query.settlement.list",
"args" : {
"search" : {
"finJobId" : "FJ20260616001"
},
"pg" : {
"page" : 1,
"size" : 20
}
}
});

请求参数​

名称类型必须说明
searchObject否核销记录搜索条件
search.finJobIdString否归属资金档号
search.typeString否核销类型
  • NORMAL - 正常核销:资金账目与应计账目勾稽
  • ADVANCE - 预收/预付核销
  • REVERSE - 核销冲销:撤销既有核销
  • search.billIdString否账单号(匹配任一勾稽明细的 billId,用于查某张账单的收付款流水)
    search.tenantIdString否租户id
    search.legalEntityIdsString[]否法人主体id(可多选)
    search.customerIdString否客户id
    search.keywordString否模糊匹配关键字
    search.fromString否查询起始时间,时间样式为RFC3339格式,如:2019-04-18T00:13:39.649Z
    search.toString否查询终止时间,时间样式为RFC3339格式,如:2019-04-19T00:13:39.649Z
    pgObject否分页参数
    pg.pageNumber否页码,首页从0开始
    pg.sizeNumber否每页记录,默认为10
    pg.sortString[]否排序字段清单,默认为升序,需要指定降序时在字段名后面添加desc并用分号隔开。
    例如:["id", "crDate;desc"]

    返回​

    核销记录列表(按创建时间倒序)

    [
    {
    "settlementId" : "ST20260620001",
    "finJobId" : "FJ20260616001",
    "type" : "NORMAL",
    "remark" : "海运费收款核销应收",
    "links" : [
    {
    "cashEntryId" : "FE20260620001",
    "accrualEntryId" : "FE20260616001",
    "amount" : 11300.0,
    "fxRate" : 1,
    "fxDiff" : 0
    }
    ],
    "crBy" : "EMP2001",
    "crDate" : "2026-06-20T02:30:00Z"
    }
    ]

    返回属性​

    名称类型说明
    settlementIdString核销号(主键)
    finJobIdString主要归属资金档号(核销通常在票内)
    typeString核销类型
  • NORMAL - 正常核销:资金账目与应计账目勾稽
  • ADVANCE - 预收/预付核销
  • REVERSE - 核销冲销:撤销既有核销
  • linksObject[]勾稽明细
    links.[].cashEntryIdString资金账目 id(nature=CASH)
    links.[].accrualEntryIdString应计账目 id(nature=ACCRUAL)
    links.[].billIdString该笔勾稽所针对的账单号(可空)。账单金额仍由所含账目派生,此处仅用于回溯
    「这张账单的收付款流水」——账单头单向持有 entryIds,没有这个字段就查不到反向关系。
    links.[].amountNumber本次核销金额(应计账目原币)
    links.[].fxRateNumber结算汇率(资金账目币种 → 应计账目币种)
    links.[].fxDiffNumber汇兑差额(本位币),由记账汇率与结算汇率差异产生
    reverseOfString若为冲销,指向被冲销的核销号
    remarkString备注
    crByInfoObject创建人信息
    crByInfo.usernameString用户标识
    crByInfo.accountIdString用户集成帐户标识
    crByInfo.domainString用户集成域,默认为所属租户标识
    crByInfo.fullnameString用户姓名
    crByInfo.passwordString登录密码
    crByInfo.mobileString手机号码
    crByInfo.emailString邮件地址
    crByInfo.genderNumber用户性别
    crByInfo.statusNumber用户状态
    0 - disabled; 1 - enabled
    crByInfo.userTypesNumber[]用户类型,创建用户时指定,具体类型的值由调用方约定
    crByInfo.inviteCodeString邀请码
    特定用户类型对应的邀请码为<用户邀请码>-<用户类型标识>
    如用户邀请码为HbXm6Ls,则用户类型3对应的邀请码为HbXm6Ls-3
    crByInfo.extraObject
    crByInfo.associatedAccountsObject[]关联帐户信息
    crByInfo.associatedAccounts.[].authTypeNumber账号类型: 1 - 微信; 2 - 微博; 待扩展
    crByInfo.associatedAccounts.[].appIdString集成标识
    crByInfo.associatedAccounts.[].accountString账号
    crByInfo.associatedAccounts.[].extraObject其他扩展信息
    crByInfo.anonymousBoolean是否匿名用户
    crByInfo.crDateString创建时间
    crByInfo.tenantIdString租户ID
    legalEntityIdString法人主体id
    customerIdString客户id
    extraPropsObject扩展属性
    crByString创建者
    upByString最后修改者
    crDateString创建时间
    upDateString最后修改时间
    tenantIdString租户ID
    idVaries

    下载结果模型定义