业务场景

该接口用于进行单据导入，在将单据导入到系统内时，会将单据自动保存到对应的员工下。

目前该接口中，仅支持部分主要字段，如果您所需要导入的字段不在文档内，请联系每刻工作人员。

注意事项：

1. 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
2. 单机导入成功且为提交状态，将会自动执行该单据所配置的审批流程，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
3. 单据导入成功且为提交状态，会正常触发智能审核等功能，与员工手动提单相同。
4. 若导入报销单stagingFlag(暂存状态)为true，则只校验单据的S级字段必填（参考文档的必填项为“是”的字段），其他必填字段由提单人手动添加并提交。

接口说明

请求类型

POST

接口地址

/api/openapi/receive/contract

请求参数说明

在各个表单中，分为系统字段、业务字段及普通字段，系统字段在表单配置界面中不会显示，如申请单中的requestUserEmpNo 字段。业务字段及普通字段，可以通过单据配置界面中的开发者模式来查看该字段导入时的的key值，其中普通字段的key值，也可以在界面中进行配置修改。

参数说明

FormAssociatedList 关联单据类型

contractDateDto 合同日期

请求参数示例

{
    "formCode": "FORM001",
    "formSubTypeBizCode": "FORMTYPE001",
    "requestUserEmployeeId": "001",
    "contractName": "每刻的合同名称",
    "contractNum": "合同号001",
    "comment": "我是备注",
    "paymentPlanBizCode": "dafault",
    "tradingPartnerBizCode": "BIZ001", 
    "responsibleUserEmployeeIds": ["001", "002"],
    "responsibleDepartmentBizCode": "DEPT001",
    "legalEntityBizCode": "LEB001",
    "contractAmount": {
        "amount": "100",
        "currency": "CNY"
    },
    "payeeAccount": {
        "bankAcctName": "杭州每刻银行",
        "bankAcctNumber": "6217000010001234123",
        "paymentType": "BANK",
        "accountType": "CORP"
    },
    "procurementDetails": [{
        "commodityName": "商品名称",
        "specifications": "规格",
        "quantity": 1,
        "unit": "单位",
        "unitPrice": {
            "amount": "100",
            "currency": "CNY"
        },
        "totalAmount": {
            "amount": "100",
            "currency": "CNY"
        }
    }],
    "paymentPlans": [{
        "periodNo": 1,  
        "paymentInfo": {
            "ratio": 100, 
            "amount": {
                "amount": "50.00",  
                "currency": "CNY"  
            }
        }, 
        "expectTime": 1566204741186, 
        "customObject": {  
            "note": "付款备注"  
        }
    }],
    "customObject": { 
        "CF1393": "我是单行文本",  
        "remarkText": "我是单行文本",  
        "detail": [{  
            "CF1400": "我是单行文本", 
            "remarkText": "我是单行文本"  
        }]
    },
    "submittedTime":1566305356934, 
    "stagingFlag":true,
    "contractDateDto": {
      "startDate": 1566305356934,
      "endDate": 1566305356938
     }, 
    "contractCcy": "USD",
    "formAssociatedList": [
      {
         "bizCode": "mk1oo8611",
         "type": "APPL"
      }
   ],
    "contractExpenseCodes": ["CE24050910I2V0YQ","CE24051010I2V0XY"],
    "preConsumeCodeList": [
    "mk00987"
  ]
}

响应参数说明

正常响应参数示例

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

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

level 异常等级

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

ruleClassify 枚举说明

修改记录

2023-09-07  新增合同到期日和合同外币
2024-05-10  新增合同费用明细关联