webhook节点推送说明

说明

配置该接口后，可以将每刻审批单的全数据推送至外部系统，外部系统接收到审批单数据后，可以执行您在该节点需要的操作，例如可唤起OA流程实例，发起对应的OA审批，或者在您的系统中保存单据，保存财务信息等。

步骤说明

1. 地址配置：首先我们需要在每刻报销->设置->单据与流程->选择某一流程->外部推送节点-> 填写接口地址
2. 节点类型+推送模式配置：需要在该节点根据实际业务做选择，不同组合效果说明可点击外部系统推送说明

1. 在配置好接口地址后，可以在系统内提交单据，当流程到达该外部节点时，即会请求您的接口，可以在本地查看每刻推送的报文。
2. 由于不同的单据类型会有不同的数据列/参数格式，因此每刻推送的数据相关key/结构也会有差异，所以需要针对各个自定义表单进行开发处理。每个单据类型的固定组件key说明可以参考表单formData格式说明 。
3. 自定义组件查看方法：在表单编辑器中打开开发者模式，选择某一自定义控件，根据右侧出现的开发者选项内容中的业务编码去修改为自己所需要的key值（保证在表单内唯一），这样webhook推送数据的时候就会按照用户设置的业务编码作为字段key值推送出去。注：新增字段在未保存前是没有样例数据的。样例数据是该字段在webhook推送出去时所模拟的数据结构，方便用户开发。

WebHook接口说明

请求方式

POST

请求参数

参数说明

Task类型字段说明

ViewLink 类型字段说明

Log 类型字段说明

参数示例

{
   "entCode": "xxxxxxxxx",
   "processInstanceId": "xxxxxxxx",
   "formDataCode": "xxxxxxxx",
   "formCode": "xxxxxxxx",
   "formType": "xxxxxx",
   "taskId": "95ec969a-276e-11ee-b919-0a580af4735b",
   "tasks": [
      {
         "procInstId": "id",
         "taskId": "id",
         "state": "TEST",
         "operators": [
            {
               "code": "zhangsan01",
               "name": "张三",
               "userEmployeeId": "employee_id",
               "description": "部门名称",
               "sourceAvatar": "https://static.dingtalk.com/media/lADPDgQ9qTGE0sPNA2LNA2I_866_866.jpg"
            }
         ],
         "taskName": "审批或节点",
         "freeNode": false,
         "skip": false,
         "category": "审批",
         "countersign": false
      }
   ],
   "formData": {
      xxxxx
   },
   "viewLinks": [
      {
         "appKey": "COMMON",
         "url": "https://dt-uat2.maycur.com/h5/?platform=countrygarden&corpId=EC1803221E23UHXD&webHashRoute=/home/lite/view/LIT19092423N9OC1S/null/MINE&H5HashRoute=/liteView/view/LIT19092423N9OC1S"
      }
   ],
   "logs": [
      {
         "log": "[xxx]审批通过",
         "comment": "备注",
         "operatorName": [
            "aa",
            "bb"
         ],
         "processNodeSubType": "审批节点",
         "taskName": "领导审批",
         "optTime": 123141231
      }
   ]
}

响应参数

参数说明

参数示例

{
   "success": true,
   "errorMsg": "xxxxx",
   "data": {
      "formCode": "",
      "externalProcInstId": ""
   }
}