cs.fin.query.entry.list
账目明细列表,按发生 时间倒序。
- 请求路由:
cs.fin.query.entry.list- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "cs.fin.query.entry.list",
"args" : {
"search" : {
"finJobId" : "FJ20260616001",
"flow" : "AR",
"tags" : [
"term:PP"
]
},
"pg" : {
"page" : 1,
"size" : 20
}
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
search | Object | 否 | 账目搜索条件 |
search.finJobId | String | 否 | 所属资金档号 |
search.partyId | String | 否 | 往来对象 id |
search.flow | String | 否 | 资金流向 AR/AP |
search.nature | String | 否 | 账目性质 |
search.stage | String | 否 | 阶段:预估/实际 |
search.chargeCode | String | 否 | 费用项目编码 |
search.priceType | String | 否 | 价税类型 |
search.currency | String | 否 | 币种 |
search.tags | String[] | 否 | 任一标签命中(URN 前缀字符串) |
search.occurFrom | String | 否 | 业务发生时间起(含) |
search.occurTo | String | 否 | 业务发生时间止(含) |
search.tenantId | String | 否 | 租户id |
search.legalEntityIds | String[] | 否 | 法人主体id(可多选) |
search.customerId | String | 否 | 客户id |
search.keyword | String | 否 | 模糊匹配关键字 |
search.from | String | 否 | 查询起始时间,时间样式为RFC3339格式,如:2019-04-18T00:13:39.649Z |
search.to | String | 否 | 查询终止时间,时间样式为RFC3339格式,如:2019-04-19T00:13:39.649Z |
pg | Object | 否 | 分页参数 |
pg.page | Number | 否 | 页码,首页从0开始 |
pg.size | Number | 否 | 每页记录,默认为10 |
pg.sort | String[] | 否 | 排序字段清单,默认为升序,需要指定降序时在字段名后面添加desc并用分号隔开。 例如:["id", "crDate;desc"] |
返回
账目明细列表(按发生时间倒序)
[
{
"entryId" : "FE20260616001",
"finJobId" : "FJ20260616001",
"source" : {
"type" : "ATD",
"bizId" : "SHSE26060001",
"eventRef" : "evt-ar-0001"
},
"party" : {
"role" : "CUSTOMER",
"id" : "CUST10086",
"name" : "深圳市鹏海国际货运"
},
"amount" : 11300.0,
"currency" : "CNY",
"fxRate" : 1,
"baseAmount" : 11300.0,
"occurAt" : "2026-06-16T08:00:00Z",
"priceType" : "TAX_INCLUSIVE",
"taxRate" : 0.06,
"taxAmount" : 639.62,
"netAmount" : 10660.38,
"flow" : "AR",
"nature" : "ACCRUAL",
"stage" : "ACTUAL",
"chargeCode" : "OCEAN_FREIGHT",
"tags" : [
"src:ATD",
"term:PP"
],
"settledAmount" : 0,
"remark" : "海运费应收"
}
]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
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 | 角色 |
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 | 账号币种快照,不用于替代本笔账目的记账币种。 |
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 | 币种 |
fxRate | Number | 记账汇率(原币 → 本位币) |
baseAmount | Number | 本位币含税金额(带符号)= amount × fxRate |
direction | String | 借贷方向(预留会计科目映射,不参与余额计算) |
occurAt | String | 业务发生时间 |
priceType | String | 价税类型 |
taxRate | Number | 税率(如 0.06 / 0.09 / 0) |
taxAmount | Number | 原币税额(带符号) |
netAmount | Number | 原币不含税净额(带符号)= amount − taxAmount |
flow | String | 资金流向 AR/AP |
nature | String | 账目性质 |
stage | String | 阶段:预估/实际 |
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 | 返回账目主键,供统一数据访问与查询映射使用。 |