报销单导入接口

说明

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

接口限制

 1次/秒/企业

注意事项

1. 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
2. 若导入报销单stagingFlag(暂存状态)为true，则只校验费用S级字段必填（对私：消费日期、费用金额、费用类型编码；对公：基于对私，增加到票时间、业务场景、是否对公），其他必填字段由提单人手动添加并提交。
3. 单据导入成功且为提交状态，将会自动执行该单据所配置的审批流程，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
4. 在提单时，会正常触发预算占用、凭证、费控智能审核、自定义校验等校验，与员工手动提单相同。
   • 若触发了表单配置的系统校验（如智能审核、单据校验组件、单据提交外部事件），且错误等级为“ERROR”（错误）、“NEED_REASON”（警告但需填写理由），则该单据会暂存至提单人的“我的单据”。
5. 收款明细组件与单据级支付账户组件互斥：配置收款明细组件时，仅可在collectionSchedule明细中传入payerAccount；配置单据级支付账户组件时，仅可传入根级payerAccount。请求字段层级与表单组件不匹配，或同时传入两种层级的payerAccount，均会返回参数错误。

接口地址

/api/openapi/receive/reimburse

请求类型

POST

请求参数

参数说明

contractPayRecords 参数说明

contractPaymentPlan 参数说明

associatedForm 参数说明

ContractAssociated 参数说明

参数样例

{
   "formCode": "单据号",
   "formSubTypeBizCode": "FT1908191E6CRDA8",
   "submittedUserEmployeeId": "190013",
   "reimburseName": "报销事由",
   "legalEntityBizCode": "LEB001",
   "coverUserEmployeeId": "200066",
   "coverDepartmentBizCode": "DEPT001",
   "expenseCodes": [
      "EXP001",
      "EXP002"
   ],
   "reimburseFormDataPlanPayTime": 1787760000000,
   "tradingPartnerBizCode": "011506mk2020-06-20",
   "payeeAccount": { //收款账户组件
      "bankAcctName": "杭州每刻银行",
      "bankAcctNumber": "6217000010001234123",
      "paymentType": "BANK",
      "accountType": "PERSONAL"
   },
   "collectionSchedule": [  //收款明细组件（多人收款）
      {
         "payeeAccount": {
            "bankAcctName": "张三",
            "bankAcctNumber": "123456789123456789",
            "paymentType": "BANK",
            "accountType": "PERSONAL",
            "bankBranchNo": "105361048025"
         },
         "payerAccount": {
            "bankAcctName": "杭州每刻银行",
            "bankAcctNumber": "6217000010001234123",
            "paymentType": "BANK"
         },
         "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"
         }
      }
   ],
   "customObject": {
      "CF1393": "我是单行文本",
      "remarkText": "我是单行文本",
      "detail": [
         {
            "CF1400": "我是单行文本",
            "remarkText": "我是单行文本"
         }
      ]
   },
   "submittedTime": 1566305356934,
   "stagingFlag": true,
   "preConsumeCodeList": [
      "MK211101001"
   ],
   "contractCode": "合同code",
   "contractPaymentPlans": [
      {
         "code": "PPI2305061EKL7NK0",
         "paymentPlanAmountNow": {
            "amount": "6",
            "currency": "CNY"
         }
      }
   ],
   "acceptCcyCode": "CNY",
   "associatedForm": [
      {
         "formCode": "MK23030069",
         "formType": "PRECONSUME",
         "formSubTypeBizCode": "FT24739297869438025",
         "formSubTypeName": "测试申请单",
         "isMine": true
      }
   ],
   "budgetOccupyTime": 1566305356934,
   "budgetOccupyTimeZoneId": "Asia/Shanghai",
   "reimburseFormDataPlanPayTime": 1566305356934,
   "reimburseFormDataPlanPayTimeZoneId": "Asia/Shanghai"
}

单据级支付账户组件的请求示例（表单未配置收款明细组件）：

{
   "formSubTypeBizCode": "FT1908191E6CRDA8",
   "submittedUserEmployeeId": "190013",
   "reimburseName": "报销事由",
   "legalEntityBizCode": "LEB001",
   "coverUserEmployeeId": "200066",
   "coverDepartmentBizCode": "DEPT001",
   "expenseCodes": ["EXP001"],
   "payerAccount": {
      "bankAcctName": "杭州每刻银行",
      "bankAcctNumber": "6217000010001234123",
      "paymentType": "BANK"
   }
}

响应参数

响应参数说明

参数样例

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  新增报销单导入文档
2023-11-09  报销单增加参与人
2024-01-09  报销单导入接口支持行程
2024-03-21  报销单导入接口支持汇款备注
2024-10-08  报销单导入接口-入参，新增"预算使用月份"字段
2025-09-24  报销单导入接口-入参，新增多合同关联字段
2026-02-24  报销单导入接口-入参，新增关联单据支持外部单据
2026-06-10  新增提单失败自动删除暂存报销单及关联费用处理参数
2026-07-02  报销单导入接口-多人收款明细新增支付账户payerAccount
2026-07-12  报销单导入接口-入参，新增单据级支付账户字段及收款明细互斥规则
2026-08-13  新增 reimburseFormDataPlanPayTimeZoneId、budgetOccupyTimeZoneId、installmentExpectDateZoneId 字段
2026-08-27  DB-61517 明确选项组类型传自定义档案明细业务编码