跳到主要内容

cs.fin.invoice.get.{id}

按内部记录编号读取票面信息及附件元信息。

  • 请求路由: cs.fin.invoice.get.{id}
  • 交互模型: Request Response
  • 访问限制: 无

请求​

RSocket.rr({
"route" : "cs.fin.invoice.get.INV202611020001"
});

请求参数​

名称类型必须说明
idString是内部记录编号

返回​

发票详情,记录不存在时返回空结果

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

返回属性​

名称类型说明
invoiceIdString系统生成的内部记录编号,与票面号码分开。
invoiceNoString票面发票号码,登记时必填。
invoiceTypeString发票类型,登记时必填;直接保存调用方提供的名称,不限定枚举。
invoiceDateString票面开票日期,登记时必填
currencyString票面币种,新增时未提供则使用人民币;更新时省略表示不修改。
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 币种中文名称
  • symbol - 币种货币符号
  • code - 获取币种代码(枚举名),用于序列化。
  • amountNumber票面价税合计,登记时必填;直接录入,不由税率或税额推算。
    taxRateNumber登记税率,例如 0.06 表示 6%;多税率发票可不填写。
    taxAmountNumber票面税额,直接录入,不做自动计算。
    attachmentsObject[]附件元信息及文件引用;更新时传空数组清空,省略则保留。
    attachments.[].titleString附件标题
    attachments.[].descriptionString附件说明
    attachments.[].binaryIdString[]附件id
    remarkString发票登记备注。
    legalEntityIdString法人主体id
    customerIdString客户id
    extraPropsObject扩展属性
    crByString创建者
    upByString最后修改者
    crDateString创建时间
    upDateString最后修改时间
    tenantIdString租户ID
    idVaries返回用于定位登记记录的内部编号。

    下载结果模型定义