申请单更新接口

说明

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

注意事项

  1. 只支持更新以下状态的申请单:暂存、驳回、驳回直达、召回状态。
  2. 申请单更新传值,若不传则默认复用原值,传则按最新值进行更新。
  3. 以下特殊费用字段全覆盖且以最新传值进行更新,不复用旧值:
    • formAssociateUsers(申请单关联人)
    • customObject(自定义字段信息)

接口地址

/api/openapi/receive/application/update

请求类型

POST

请求参数

参数说明

字段名称 字段类型 是否必填 字段说明
formCode String 单据编码
preConsumeName String 申请单事由
departmentBizCode String 部门编码
comment String 备注
appliedAmount AmountInput 申请金额。币种以"申请币种字段"为准;如果申请金额取自申请明细且存在申请明细,取值以申请明细为准。
receiptCurrency String(3) 申请币种字段(刷新单据上所有币种为该币种)
consumeTime DateInput 预计消费日期
budgetSubjectBizCode String 预算科目编码
travelPartnerInfo TravelPartner 参与人
requestDepartmentBizCode String 提单人部门编码
legalEntityBizCode String 公司抬头编码
tradingPartnerBizCode String 往来单位编码,表单中配置为对公账户时,必须传往来单位
applicationExpenseCodes List<String> 单独填写时申请明细code列表,需调用申请明细导入接口接口导入。
配置为“申请明细单独填写”时使用,若配置为“需要在行程下填写申请明细”,请传入travelRouteList内的applicationExpenseCodeList
procurementDetails List<ProcurementDetail> 采购明细
formAssociateUsers List<String> 申请单关联人(“允许他人关联”组件)
relationAccrualContract boolean 是否关联预提合同(若为true,则表示该申请单为预提申请单,要求:1.申请单为预提申请单并且表单含有'关联预提合同'组件 2.未遵循'关联预提合同'组件范围限制 3.传入的applicationExpenseCodes必须全是合同预提明细生成接口 转化生成的费用
disableContractCodes List<String> 停用合同编码("停用合同"组件)
contractEndTime Long 合同终止时间("合同终止时间"组件)
formAssociatedList List<FormAssociatedList> 关联单据组件,关联单据数量需要遵循表单配置,仅限关联每刻内部单据
expectedPaybackDate Long 预计回款时间
loanAmount String 借款金额
payeeAccount PayeeAccount 收款信息
travelRouteList List<TravelRoute> 行程列表
customObject CustomObject 自定义字段,全量更新

FormAssociatedList 关联单据类型

字段名称 字段类型 是否必填 字段说明
bizCode String() 单据编码
type String(12) 单据类型
REIM 报销单;
APPL 申请单;
LOAN 借款单;
CONTR 合同;

请求参数样例

{
  "formCode": "CODE01",
  "formSubTypeBizCode": "FT1908191E6CRDA8",
  "departmentBizCode": "DI1803221E22UHXF",
  "preConsumeName": "申请事由1",
  "comment": "我是备注",
  "appliedAmount": {
    "currencyCode": "CNY",
    "amount": "1.00"
  },
  "consumeTime": {
    "currentTime": 1566204741186,
    "timeRange": {
      "startDate": 1566305347895,
      "endDate": 1566305356934
    }
  },
  "receiptCurrency": "CNY",
  "budgetSubjectBizCode": "BIZCODE",
  "legalEntityBizCode": "LEB001",
  "formAssociateUsers": [
    "MK003",
    "MW001"
  ],
  "procurementDetails": [
    {
      "commodityName": "商品名称",
      "specifications": "规格",
      "quantity": 1,
      "unit": "单位",
      "unitPrice": {
        "amount": "100",
        "currency": "CNY"
      },
      "totalAmount": {
        "amount": "100",
        "currency": "CNY"
      }
    }
  ],
  "preConsumeCodeList": [
    "MK211101001"
  ],
  "contractCode": "合同code",
  "acceptCcyCode": "CNY",
  "travelPartnerInfo": {
    "internalTravelPartner": [
      {
        "employeeId": "001",
        "departmentBizCode": "CODE01",
        "classPositionBizCode": "CPBIZCODE01",
        "gender": "MAN",
        "enName": {
          "firstName": "JIM",
          "middleName": "D",
          "lastName": "SMITH"
        },
        "idInfo": {
          "idType": "ID_CARD",
          "idNumber": "421XXXXXXX"
        },
        "customObject": {}
      }
    ],
    "externalTravelPartner": [
      {
        "name": "刘红",
        "gender": "WOMAN",
        "enName": {
          "firstName": "JIM",
          "middleName": "D",
          "lastName": "SMITH"
        },
        "peopleNum": 10,
        "idInfo": {
          "idType": "ID_CARD",
          "idNumber": "421XXXXXXX"
        },
        "customObject": {}
      }
    ]
  },
  "travelRouteList": [
    {
      "travelCities": {
        "departure": "北京市区",
        "destination": [
          "上海"
        ]
      },
      "travelTimeRange": {
        "startDate": {
          "currentTime": 1600085022912
        },
        "endDate": {
          "currentTime": 1600085022912
        }
      },
      "applicationExpenseCodeList": [
        "AE2312453"
      ],
      "tripWay": "SINGLE",
      "travelDays": 1,
      "customObject": {
        "CF2797": "您好",
        "CF2838": {
          "currencyCode": "CNY",
          "amount": "1.00"
        },
        "CF2839": {
          "currentTime": 1566204741186
        },
        "CF2829": {
          "index": 3
        }
      }
    }
  ],
  "applicationExpenseCodes": [
    "CODE01"
  ],
  "customObject": {
    "CF1393": "我是单行文本",
    "detail": [
      {
        "CF1400": "我是单行文本"
      }
    ]
  },
  "formAssociatedList": [
    {
      "bizCode": "mk1oo8611",
      "type": "APPL"
    }
  ],
  "tradingPartnerBizCode": "ds2091-99",
  "disableContractCodes": [
    "LL241011105"
  ],
  "contractEndTime": 1728876017930
}

响应参数

响应参数说明

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

参数样例

  1. 正常响应参数示例
{
  "code": "ACK",
  "message": "操作成功",
  "data": "formCode",
  "success": true
}
  1. 每刻校验异常响应参数示例
    当每刻系统的智能审核、多维费控、预算校验异常时会返回失败
字段 字段类型 字段说明
level String 异常级别
targetClassify String 触发校验类型
targetKey String 触发校验的那条数据的Code主键,校验类型为FORM时,该字段为空
ruleClassify String 校验触发的类型
message String 校验信息
needReason boolean 是否需要理由

level 异常等级

可取值 用法含义
WARNING 警告级别的信息,一般该类级别的信息不会阻止表单提交但需要提交者确认后才能继续提交(此时单据会暂存在提单人的“我的单据”内)
ERROR 错误级别的信息,出现此级信息会阻止表单提交(系统内不可见此单据)
{
  "code": "NACK",
  "message": "系统校验失败",
  "data": [
    {
      "level": "ERROR",
      "targetClassify": "REIMBURSE_EXPENSE",
      "targetKey": "CODE01",
      "ruleClassify": "BUDGET_MATCH",
      "message": "预算组织-打车预算科目 额度870.00 报销10000.00",
      "needReason": false
    }
  ],
  "success": false
}

修改记录

2026-03-31  新增申请单更新文档
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 ""