申请单导入接口

说明

该接口用于进行申请单导入，在将单据导入到系统内时，会将单据自动保存到对应的员工下。 目前该接口中，仅支持部分主要字段，如果您所需要导入的字段不在文档内，请联系每刻工作人员。

接口限制

 10次/秒/企业

注意事项

1. 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
2. 若stagingFlag(暂存状态)为true，申请明细参数只会校验S级字段必填，其他必填字段可由提单人手动添加并提交。
3. 单据导入成功且为提交状态，将会自动执行该单据所配置的审批流程，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
4. 在提单时，会正常触发预算、费控占用等操作，与员工手动提单相同。
5. 若需导入申请明细，请调用申请明细导入接口
6. 导入时若stagingFlag为false且在表单“提交”按钮配置了外部地址，则会触发校验，若校验为失败，则单据导入失败。

接口地址

/api/openapi/receive/application

请求类型

POST

请求参数

参数说明

FormAssociatedList 关联单据类型

参数样例

{
   "formCode": "CODE01", 
   "formSubTypeBizCode": "FT1908191E6CRDA8",
   "requestUserEmpNo": "190013",
   "departmentBizCode": "DI1803221E22UHXF",
   "preConsumeName": "申请事由1",
   "comment": "我是备注",
   "appliedAmount": {  
      "currencyCode": "CNY", 
      "amount": "1.00" 
   },
   "comsumeTime": {
      "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"
      }
   }],
   "submittedTime": 1566305356934,
   "preConsumeCodeList": [
      "MK211101001"
   ],
   "formAssociatedList": [
      {
         "bizCode": "MK23050266",
         "type": "APPL"
      },{
         "bizCode": "MK23050267",
         "type": "APPL"
      }
   ],
   "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": "我是单行文本"
      }]
   },
   "submittedTime":1566305356934,
   "formAssociatedList": [
      {
         "bizCode": "mk1oo8611",
         "type": "APPL"
      }
   ],
   "tradingPartnerBizCode": "ds2091-99",
   "disableContractCodes": ["LL241011105"],
   "contractEndTime": 1728876017930,
   "stagingFlag":true
}

响应参数

响应参数说明

参数样例

1. 正常响应参数示例

   {
    "code": "ACK",
    "message": "操作成功",
    "data": "formCode", 
    "success": true
   }
   

2. 每刻校验异常响应参数示例
   当每刻系统的智能审核、多维费控、预算校验异常时会返回失败

level 异常等级

{
  "code": "NACK",
  "message": "系统校验失败",
  "data": [
    {
      "level": "ERROR", 
      "targetClassify": "REIMBURSE_EXPENSE", 
      "targetKey": "CODE01", 
      "ruleClassify": "BUDGET_MATCH", 
      "message": "预算组织-打车预算科目 额度870.00 报销10000.00", 
      "needReason": false 
    }
  ],
  "success": false
}

修改记录

2023-02-08  新增申请单导入文档
2024-09-23  新增是否关联预提合同字段
2024-10-09  新增停用合同字段