2023/12/28-流程模板签署通知和签署终端类型逻辑优化通知

更新时间:2023-12-28 10:04:10

背景说明:为了提升流程模板签署服务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端页面:


我要纠错