cs.fin.bill.update

更新账单元数据。

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

请求

RSocket.rr({
  "route" : "cs.fin.bill.update",
  "data" : {
    "billId" : "DN20260623001",
    "flow" : "AR",
    "finJobId" : "FJ20260616001",
    "party" : {
      "role" : "CUSTOMER",
      "id" : "CUST10086",
      "name" : "深圳市鹏海国际货运"
    },
    "currency" : "CNY",
    "entryIds" : [
      "FE20260616001",
      "FE20260616004"
    ],
    "issueDate" : "2026-06-23T00:00:00Z",
    "settleMode" : "MONTHLY",
    "creditDays" : 45,
    "remark" : "6月海运费应收账单（追加 THC）"
  }
});

请求参数

名称	类型	必须	说明
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	否

返回

{
  "billId" : "DN20260623001",
  "flow" : "AR",
  "finJobId" : "FJ20260616001",
  "bizJobId" : "SHSE26060001",
  "party" : {
    "role" : "CUSTOMER",
    "id" : "CUST10086",
    "name" : "深圳市鹏海国际货运"
  },
  "currency" : "CNY",
  "entryIds" : [
    "FE20260616001",
    "FE20260616004"
  ],
  "issueDate" : "2026-06-23T00:00:00Z",
  "settleMode" : "MONTHLY",
  "creditDays" : 45,
  "dueDate" : "2026-08-07T00:00:00Z",
  "status" : "DRAFT",
  "remark" : "6月海运费应收账单（追加 THC）",
  "amount" : 12150.0,
  "settledAmount" : 0,
  "balance" : 12150.0,
  "displayStatus" : "DRAFT",
  "overdue" : false,
  "crBy" : "EMP2001",
  "crDate" : "2026-06-23T07:00:00Z",
  "upBy" : "EMP2001",
  "upDate" : "2026-06-23T11:00:00Z"
}

返回属性

名称	类型	说明
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

下载结果模型定义