cs.fin.invoice.create

新增发票登记，系统生成内部记录编号，未提供币种时默认人民币。

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

金额和税额按录入值保存，附件使用公共 Attachment 数组，仅登记元信息和文件引用。

请求

RSocket.rr({
  "route" : "cs.fin.invoice.create",
  "data" : {
    "invoiceNo" : "202611020001",
    "invoiceType" : "增值税普通发票",
    "invoiceDate" : "2026-11-02T00:00:00Z",
    "currency" : "CNY",
    "amount" : 1060.0,
    "taxRate" : 0.06,
    "taxAmount" : 60.0,
    "attachments" : [
      {
        "title" : "发票.pdf",
        "binaryId" : [
          "FILE001"
        ]
      }
    ],
    "remark" : "手工登记"
  }
});

请求参数

名称	类型	必须	说明
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	否	返回用于定位登记记录的内部编号。

返回

保存后的发票登记记录

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

返回属性

名称	类型	说明
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	返回用于定位登记记录的内部编号。

下载结果模型定义