cs.fin.bill.list

账单列表（金额派生），按出账日期倒序。

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

请求

RSocket.rs({
  "route" : "cs.fin.bill.list",
  "args" : {
    "search" : {
      "flow" : "AR",
      "status" : "SENT"
    },
    "pg" : {
      "page" : 1,
      "size" : 20
    }
  }
});

请求参数

名称	类型	必须	说明
search	Object	否
search.keyword	String	否	账单号/工作单号/提单号 关键字（模糊）
search.flow	String	否	资金流向（AR/AP） AR - 应收 AP - 应付
search.finJobId	String	否	资金档号
search.partyId	String	否	往来对象 ID
search.status	String	否	工作流状态 DRAFT - 草稿 APPROVED - 已审核 SENT - 已发送 CLOSED - 已关账
search.currency	String	否	账单币种 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
search.settleMode	String	否	结算方式 SPOT - 票结/见款放单（账期 0 天） MONTHLY - 月结 CUSTOM - 自定义账期
search.issueFrom	String	否	出账日期范围下限
search.issueTo	String	否	出账日期范围上限
search.tenantId	String	否	租户id
search.legalEntityIds	String[]	否	法人主体id（可多选）
search.customerId	String	否	客户id
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"]

返回

[
  {
    "billId" : "DN20260623001",
    "flow" : "AR",
    "finJobId" : "FJ20260616001",
    "bizJobId" : "SHSE26060001",
    "party" : {
      "role" : "CUSTOMER",
      "id" : "CUST10086",
      "name" : "深圳市鹏海国际货运"
    },
    "currency" : "CNY",
    "issueDate" : "2026-06-23T00:00:00Z",
    "settleMode" : "MONTHLY",
    "creditDays" : 30,
    "dueDate" : "2026-07-23T00:00:00Z",
    "status" : "SENT",
    "blNo" : "COSU6300260001",
    "route" : "CNSHA-USLAX",
    "amount" : 11300.0,
    "settledAmount" : 0,
    "balance" : 11300.0,
    "displayStatus" : "SENT",
    "overdue" : false
  }
]

返回属性

名称	类型	说明
billId	String	账单号（主键，DN 前缀）
flow	String	资金流向 AR（应收）/ AP（应付） AR - 应收 AP - 应付
finJobId	String	所属资金档号
bizJobId	String	业务工作单号（快照，便于展示）
party	Object	往来对象（应收=客户 / 应付=供应商）
party.role	String	角色 CUSTOMER - 客户（直客/收货人） SUPPLIER - 供应商（船东/拖车行/报关行/仓库等） AGENT - 海外代理 ORG - 内部组织（口岸/部门）
party.id	String	往来对象 id（客户/供应商/代理/组织 id）
party.name	String	名称快照
currency	String	账单币种 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
entryIds	String[]	所含账目（ACCRUAL）号集合——账单金额由此派生
issueDate	String	出账日期
settleMode	String	结算方式 SPOT - 票结/见款放单（账期 0 天） MONTHLY - 月结 CUSTOM - 自定义账期
creditDays	Number	账期天数
dueDate	String	到期日（= issueDate + creditDays）
status	String	工作流状态 DRAFT - 草稿 APPROVED - 已审核 SENT - 已发送 CLOSED - 已关账
blNo	String	提单号（快照）
polCode	String	起运港（快照）
podCode	String	目的港（快照）
route	String	航线（快照）
remark	String	备注
amount	Number	账单金额（原币，= 所含账目 amount 之和）
settledAmount	Number	已收/已付（原币，= 所含账目 settledAmount 之和）
balance	Number	欠款余额（原币，= amount − settledAmount）
displayStatus	String	展示状态：DRAFT/APPROVED/SENT/PARTIAL/SETTLED/CLOSED（部分/已结清由金额派生）
overdue	Boolean	是否逾期（dueDate < now 且 balance > 0）
legalEntityId	String	法人主体id
customerId	String	客户id
extraProps	Object	扩展属性
crBy	String	创建者
upBy	String	最后修改者
crDate	String	创建时间
upDate	String	最后修改时间
tenantId	String	租户ID
id	Varies

下载结果模型定义