背景说明:为了提升流程模板签署服务API接口的逻辑连贯性和准确性,现对流程模板的两个参数逻辑进行优化。
优化时间:2024年01月04日
优化点:
- 1.签署的短信/邮件通知:noticeTypes 逻辑优化(见下文)
- 2.签署终端类型:availableSignClientTypes 逻辑优化(见下文)
影响范围:所有使用《流程模板签署服务API》接口的客户都可能受到影响,请确认接口参数是否需要修正。
解决方法:按照新逻辑指定接口参数。
1.签署的短信通知:noticeTypes 逻辑优化
noticeTypes(通知类型)参数见:通过流程模板创建合同拟定和签署流程

原有逻辑:
- noticeTypes没有指定或者指定了""空字符串,填写的短信/邮件通知不触发,但签署的短信/邮件通知依然会发送。
优化后逻辑:
- noticeTypes没有指定或者指定了""空字符串,填写和签署的短信/邮件通知都不发送。
短信样式参考:
填写短信:

签署短信:

2.签署终端类型:availableSignClientTypes 逻辑优化
availableSignClientTypes(签署终端类型)参数见:通过流程模板创建合同拟定和签署流程
clientType(指定客户端类型)参数见:获取填写页面链接


原有逻辑:
①若入参:"availableSignClientTypes":"1(网页打开)",通过短信/邮件进入填写链接,会展示中间页,可以选择支付宝端或网页端。--需修正
②若入参:"availableSignClientTypes":"2(支付宝打开)",通过短信/邮件进入填写链接,会展示中间页,可以选择支付宝端或网页端。--需修正
③若入参:"availableSignClientTypes":“1(网页打开)”,通过接口获取填写链接,入参"clientType":"ALL",会展示中间页,可以选择支付宝端和网页端。--需修正
④若入参:"availableSignClientTypes":“1,2(网页和支付宝均可打开)”,通过接口获取填写链接,入参"clientType":"PC"或“H5”,不会展示中间页,直接进入网页端填写。--需修正
⑤若入参:"availableSignClientTypes":“1(网页打开)”通过接口获取填写链接,入参"clientType":"PC"或“H5”,不会展示中间页,直接进入网页端填写。--无需修正
⑥若入参:"availableSignClientTypes":“1,2(网页和支付宝均可打开)”入参"clientType":"ALL",会展示中间页,可以选择支付宝端和网页端。--无需修正
优化后逻辑:
①若入参:"availableSignClientTypes":"1(网页打开)",通过任何方式拿到的链接,均不需要展示中间页,直接进入网页端填写。
②若入参:"availableSignClientTypes":"2(支付宝打开)",通过任何方式拿到的链接,均展示中间页,但中间中只展示打开支付宝填写(PC是支付宝扫码)。
③若入参:"availableSignClientTypes":“1,2(网页和支付宝均可打开)”,通过任何方式拿到的链接,均展示中间页,且中间中同时展示打开支付宝填写和打开浏览器打开(PC是支付宝扫码和网页填写)。
availableSignClientTypes控制的中间页样式参考:
H5端页面:

PC端页面:
