报销单更新接口

说明

该接口用于进行报销单修改,需先调用报销单导入接口将单据导入到系统后,才能调用此接口。
目前该接口中,仅支持部分主要字段,如果您所需要导入的字段不在文档内,请联系每刻工作人员。

接口限制

 10次/秒/企业

注意事项

  1. 只支持更新以下状态的报销单:暂存、驳回、驳回直达、召回状态。
  2. 无特殊说明的字段不传入或传入null表示不更新、传入空字符串或者空列表表示删除(清除该值)
  3. 只支持单合同的修改
  4. 暂不支持行程、参与人的修改
  5. 此接口更新成功之后,需再调用报销单提交接口将单据提交进入审批流程

接口地址

/api/openapi/receive/reimburse/update

请求类型

POST

请求参数

参数说明

字段名称 字段类型 是否必填 字段说明
formCode String 是 报销单导入接口返回的单据号
reimburseName String 否 报销单事由
legalEntityBizCode String 否 公司抬头编码,支持不更新,不支持删除
coverUserEmployeeId String 否 承担人工号,支持不更新,不支持删除
coverDepartmentBizCode String 否 承担部门编码,支持不更新,不支持删除
comments String 否 备注
payeeAccount PayeeAccount 否 收款账户,表单中收款类型为对公账户(往来单位)时,必传往来单位tradingPartnerBizCode。不传表示不更新,传空对象表示删除(不更新或删除时会先考虑多人付款是否需要更新)
tradingPartnerBizCode String 否 往来单位编码
paymentSceneBizCode String 否 多人收款场景(支付场景)表单业务编码,需要填写多人收款时必填,不传或者传null表示不更新,传空字符串表示删除收款明细,传值表示更新(不更新或删除时会先考虑付款账户是否需要更新)
installmentExpectDateZoneId String 否 分期预计日期对应的 IANA 时区 ID,如 Asia/Shanghai
collectionSchedule CollectionTradingType 否 多人收款,由paymentSceneBizCode控制多人收款更新与否;支持临时往来单位,字段见CollectionTradingType说明
expenseCodes List<String> 否 费用的每刻内码Code列表,最多50条,传null表示不更新,空列表表示清空
preConsumeCodeList List<String> 否 报销单关联申请单号,传null表示不更新,空列表表示清空
contractCode String 否 报销单关联的合同单号(只支持单合同的修改)
nonCheckContractAgent bool 否 不需要校验合同责任人,true-不校验,false-校验(默认校验)
contractPaymentPlans List<contractPaymentPlan> 否 关联的付款合同含分期,需指定本期发起的期数和金额,格式见contractPaymentPlan说明
contractPayRecords List<contractPayRecords> 否 关联的付款合同含费用明细,可以指定占用支付金额以及到票金额(注:填写的明细行金额需要大于0,不填写的合同明细行默认金额为0。
reimburseFormDataPlanPayTime Long 否 报销单计划付款时间,null表示不更新,0表示删除
reimburseFormDataPlanPayTimeZoneId String 否 报销单计划付款时间对应的 IANA 时区 ID,如 Asia/Shanghai
acceptCcyCode String(3) 否 单据收款币种(不传取更新后收款账户的收款币种(此时要求账户的收款币种只有一个)),该币种需要在抬头和收款账户的限制收款币种内
associatedForm List<AssociatedForm> 否 关联单据组件,关联单据数量需要遵循表单配置,仅限关联每刻内部单据,传null表示不更新,空列表表示清空
loanFormCodes List<String> 否 核销借款,由此字段控制借款更新与否,传null表示不更新,空列表表示清空
loanDeductionHistoryList List<DeductionHistory> 否 自定义核销金额(使用该组件,必须配合loanFormCodes使用,且本组件核销单据号必须在loanFormCodes内)。
需开启“核销借款”组件的“支持手动修改本次核销金额”开关
remittanceRemark String 否 汇款备注
invoiceBagCode String 否 发票袋编号
reportPositionBizCode String 否 职位编码
budgetOccupyTime Long 否 预算使用月份(时间戳,null表示不更新,0表示删除)
budgetOccupyTimeZoneId String 否 预算使用月份对应的 IANA 时区 ID,如 Asia/Shanghai
customObject CustomObject 否 自定义字段

contractPayRecords 参数说明

字段名称 字段类型 是否必填 字段说明
expenseCode String 是 合同费用编码
payAmount AmountInput 是 本次支付金额
receiveAmount AmountInput 是 本次到票金额

contractPaymentPlan 参数说明

字段名称 字段类型 是否必填 字段说明
code String 是 合同付款计划行code
paymentPlanAmountNow AmountInput 是 付款计划行本次支付金额
receiptAmountNow AmountInput 是 付款计划行本次到票金额

参数样例

{
  "formCode": "MKXXXXX",
  "reimburseName": "事由",
  "submittedUserEmployeeId": "XXXX",
  "legalEntityBizCode": "ELCXXXXX",
  "coverUserEmployeeId": "XXXX",
  "coverDepartmentBizCode": "DIXXXXXXXXXX",
  "comments": "备注",
  // "payeeAccount": {
  //   "accountType": "PERSONAL",
  //   "paymentType": "ALIPAY",
  //   "bankAcctName": "XXX",
  //   "bankAcctNumber": "XXX",
  //   "bankBranchNo": ""
  // },
  "collectionSchedule": [
    {
      "payeeAccount": {
        "bankAcctName": "张三",
        "bankAcctNumber": "123456789123456789",
        "paymentType": "BANK",
        "accountType": "PERSONAL",
        "bankBranchNo": "XXXX"
      },
      "collectionTradingPartnerBizCode": "015108m",
      "amountRatio": 100,
      "amount": {
        "amount": 100,
        "currency": "CNY"
      },
      "collectionUserEmployeeId": "190016",
      "collectionUserName": "张三",
      "collectionUserTargetScope": "EMPLOYEE",
      "collectionType": "BANK",
      "acceptanceDraftCode": "789562787687234",
      "acceptanceIssueDate": "2024-06-20",
      "installmentInfo": {
        "installmentExpectDate": 1602569779579,
        "installmentExpectDateZoneId": "Asia/Shanghai"
      }
    }
  ],
  "paymentSceneBizCode": "XXXXX",
  "expenseCodes": [
    "expenseCode1",
    "expenseCode2"
  ],
  "preConsumeCodeList": [
    "MKXXXX"
  ],
  "contractCode": "MKXXXX",
  "nonCheckContractAgent": false,
  "reimburseFormDataPlanPayTime": 1766381949798,
  "reimburseFormDataPlanPayTimeZoneId": "Asia/Shanghai",
  "acceptCcyCode": "CNY",
  "associatedForm": [
    {
      "formCode": "MK23030069",
      "formType": "PRECONSUME",
      "formSubTypeBizCode": "FT24739297869438025",
      "formSubTypeName": "测试申请单",
      "isMine": true
    }
  ],
  "loanFormCodes": [],
  "loanDeductionHistoryList": [],
  "remittanceRemark": "汇款备注1",
  "invoiceBagCode": "23121231",
  "budgetOccupyTime": 1766381950000,
  "budgetOccupyTimeZoneId": "Asia/Shanghai",
  "customObject": {
    "CF850": {
      "currentTime": 1766373652332
    },
    "CF598": {
      "amount": 33.43,
      "currency": "CNY"
    },
    "CF852": {
      "userEmpNos": [
        "XXX"
      ]
    },
    "CF846": "单行文本",
    "CF847": "多行文本1\n多行文本2\n多行文本3"
  }
}

响应参数

响应参数说明

字段 字段类型 字段说明
code String 返回结果
message String 返回提示
data Json 返回结果
success boolean 是否成功

参数样例

  1. 正常响应参数示例
{
  "code": "ACK",
  "message": "操作成功",
  "data": "formCode",
  "success": true
}
  1. 可编辑性校验异常响应参数示例
{
  "code": "NACK",
  "message": "系统校验失败: A不可编辑\nB不可编辑",
  "success": false
}

修改记录

2025-02-30  新增报销单修改文档
2026-08-13  新增 reimburseFormDataPlanPayTimeZoneId、budgetOccupyTimeZoneId、installmentExpectDateZoneId 字段
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""