报销单更新接口

说明

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

接口限制

 10次/秒/企业

注意事项

  1. 只支持更新以下状态的报销单:暂存、驳回、驳回直达、召回状态。
  2. 无特殊说明的字段不传入或传入null表示不更新、传入空字符串或者空列表表示删除(清除该值)
  3. 只支持单合同的修改
  4. 暂不支持行程、参与人的修改

接口地址

/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表示不更新,传空字符串表示删除收款明细,传值表示更新(不更新或删除时会先考虑付款账户是否需要更新)
collectionSchedule CollectionTradingType 多人收款,由paymentSceneBizCode控制多人收款更新与否
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表示删除
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表示删除)
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
      }
    }
  ],
  "paymentSceneBizCode": "XXXXX",
  "expenseCodes": [
    "expenseCode1",
    "expenseCode2"
  ],
  "preConsumeCodeList": [
    "MKXXXX"
  ],
  "contractCode": "MKXXXX",
  "nonCheckContractAgent": false,
  "reimburseFormDataPlanPayTime": 1766381949798,
  "acceptCcyCode": "CNY",
  "associatedForm": [
    {
      "formCode": "MK23030069",
      "formType": "PRECONSUME",
      "formSubTypeBizCode": "FT24739297869438025",
      "formSubTypeName": "测试申请单",
      "isMine": true
    }
  ],
  "loanFormCodes": [],
  "loanDeductionHistoryList": [],
  "remittanceRemark": "汇款备注1",
  "invoiceBagCode": "23121231",
  "budgetOccupyTime": 1766381950000,
  "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  新增报销单修改文档
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-05-21 10:07:06

results matching ""

    No results matching ""

    results matching ""

      No results matching ""