售楼资金回笼方案

erp相关

背景介绍

  针对资金回笼需求，云ERP2.0需要支撑在移动端（云助手APP）收到消息提醒后，打开链接查询对应ERP信息并在该页面填写批示信息，点击提交，将批示信息传递至ERP。

售楼产品注册

接口注册

交互过程

消息推送

打开消息

各产品需要实现的功能

$\color{green}{售楼}$: 表单获取，填充，校验，回填全部由售楼自己在erp中实现对应业务接口;
$\color{green}{云助手云端}$: 需要实现两个转发接口,分别实现页面和接口的转发;
$\color{green}{接口管家}$: 需要实现一个erp api转发接口（这个之前是没有的，以后所有的erp api都统一走这个转发);
$\color{green}{管理简讯}$: 简讯支持配置自定义页面，$\color{red}{url支持配置可变参数}$,参数名={参数值},{参数值}为erp表消息表中的任意字段，比如;PageUrl
$\color{blue}{补充说明}$: 考虑到管理简讯可能还会托管到了其他APP(企业微信，钉钉等）,要考虑在这些应用上使用资金回笼也能正常使用，固本方案不涉及云助手APP的任何调整；

方案实现

erp消息写入

消息表：p_TaskWake
关键字段信息：SELECT UserGUID,WakeSubject,BusinessType FROM dbo.p_TaskWake

配置管理简讯

  在管理简讯后台-erp消息同步中，配置管理简讯即可，不用关联报表，使用自定义页面功能，将简讯消息打开的页面配置成云助手的云端页面转发地址

云助手云端页面转发接口

$\color{green}{请求页面}$
云端通过tenant_id查询到当前租户接口管家地址，调用接口管家的统一转发接口参考这里，接口管家调用erp接口，将erp页面信息返回到云助手APP，云助手APP通过WebView渲染页面

接口地址(在云助手APP中打开管理简讯消息对应的跳转地址):

https://www.fdccloud.com/$\color{green}{\{tenant\_id\}}$
/api/route/erp-page-route?&product_id=10000&page_id=10000&api_code=1314

传参方式:

GET
参数说明：

云助手云端API转发接口

$\color{green}{请求接口}$
云端通过tenant_id查询到当前租户接口管家地址，调用接口管家的统一转发接口参考这里，接口管家调用erp接口，将请求结果返回给前端页面

接口地址(erp表单页面调用云端接口实现业务数据的处理):

ERP中使用变量的形式{YZS_ERP_API_URL},云助手会替换此变量为云助手的转发接口

传参方式:

POST

{
    "product_id":"10000",
    "api_code":"1314",
    "signature":"d1dasfjsafaljfajf",
    "params":{
       "key":"value"
    }
}

参数说明：

<input type="hidden" name="signature" value="{YZS_ERP_SIGNATURE}"> 

返回格式

云助手检测异常

 {
    "isSuccess": 0,
    "message": "没有配置该接口",
    "result": [],
    "sub_ticket": ""
}

云助手检测正常

{
    "isSuccess": 1,
    "message": "ok",
    "result": {
        "errcode": -10,
        "errmsg": "邮箱不存在"
    },
    "sub_ticket": ""
}
result中的值是售楼对应接口返回的信息，需要售楼自己根据返回值来后续操作

接口管家转发接口

此接口负责将请求代理到erp，并将erp接口的返回值返给给调用方

$\color{red}{注:云助手云端调用接口管家路由转发接口时，需充分考虑接口安全认证}$

接口地址:

{接口管家地址}/api/Public/ApiRoute.asmx

传参方式:

POST

{
    "erp_api_address":"api/.../....",
    "params":{
       "key":"value"
    }
}

参数说明：

售楼erp-获取表单页面接口

此接口负责返回表单页面html，此html中可通过调用云助手云端API转发接口，间接访问erp接口.

接口地址:

售楼团队自定义

传参方式:

POST

{
    "page_id":"10000"
}

参数说明：

售楼erp-业务接口(表单数据获取，表单校验，表单回填等)

此接口实现表单数据的获取，表单校验，表单回填

接口地址:

售楼团队自定义

传参方式:

POST

{
    售楼团队根据实际业务场景自定义，接口管家负责参数的转发
}