cs.fin.invoice.list

分页查询发票登记，默认按创建时间倒序，以内部编号倒序稳定同一时间的顺序。

请求路由: cs.fin.invoice.list

交互模型: Request Stream

访问限制: 无

请求

RSocket.rs({
  "route" : "cs.fin.invoice.list",
  "args" : {
    "search" : {
      "keyword" : "20261102",
      "invoiceFrom" : "2026-10-31T16:00:00Z",
      "invoiceTo" : "2026-11-30T15:59:59.999Z"
    },
    "pg" : {
      "page" : 1,
      "size" : 20
    }
  }
});

请求参数

名称	类型	必须	说明
`search`	Object	否	发票搜索条件，可省略
`search.keyword`	String	否	内部编号或票面号码关键字。
`search.invoiceType`	String	否	发票类型，精确匹配。
`search.currency`	String	否	票面币种。 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
`search.invoiceFrom`	String	否	开票时间下限，包含该时刻；按日期查询时由调用方转换为所在地当天起始时刻。
`search.invoiceTo`	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"]

符合条件的分页发票列表

[
  {
    "invoiceId" : "INV202611020001",
    "invoiceNo" : "202611020001",
    "invoiceType" : "增值税普通发票",
    "invoiceDate" : "2026-11-02T00:00:00Z",
    "currency" : "CNY",
    "amount" : 1060.0,
    "attachments" : [
      {
        "title" : "发票.pdf",
        "binaryId" : [
          "FILE001"
        ]
      }
    ]
  }
]

返回属性

名称	类型	说明
`invoiceId`	String	系统生成的内部记录编号，与票面号码分开。
`invoiceNo`	String	票面发票号码，登记时必填。
`invoiceType`	String	发票类型，登记时必填；直接保存调用方提供的名称，不限定枚举。
`invoiceDate`	String	票面开票日期，登记时必填
`currency`	String	票面币种，新增时未提供则使用人民币；更新时省略表示不修改。 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
`amount`	Number	票面价税合计，登记时必填；直接录入，不由税率或税额推算。
`taxRate`	Number	登记税率，例如 0.06 表示 6%；多税率发票可不填写。
`taxAmount`	Number	票面税额，直接录入，不做自动计算。
`attachments`	Object[]	附件元信息及文件引用；更新时传空数组清空，省略则保留。
`attachments.[].title`	String	附件标题
`attachments.[].description`	String	附件说明
`attachments.[].binaryId`	String[]	附件id
`remark`	String	发票登记备注。
`legalEntityId`	String	法人主体id
`customerId`	String	客户id
`extraProps`	Object	扩展属性
`crBy`	String	创建者
`upBy`	String	最后修改者
`crDate`	String	创建时间
`upDate`	String	最后修改时间
`tenantId`	String	租户ID
`id`	Varies	返回用于定位登记记录的内部编号。

下载结果模型定义

请求​

请求参数​

返回​

返回属性​

请求

请求参数

返回

返回属性