小程序相关问题
客户小程序如何跳转到电子签小程序完成签署?
正式环境:
wx.navigateToMiniProgram({appId:'wxa023b292fd19d41d', // 电子签小程序的appIdpath:'pages/guide?from=SFY&to=CONTRACT_DETAIL&id=${flowId}&name=%E6%9D%A8%E5%B8%88&phone=MTc2MTI3Nzg1Mjk%3D', //${flowId}为流程 id,name、phone 按需给envVersion:'release’,success(res){// 打开成功}})
测试环境:
wx.navigateToMiniProgram({appId:'wx371151823f6f3edf', // 电子签小程序的appIdpath:'pages/guide?from=SFY&to=CONTRACT_DETAIL&id=${flowId}&name=%E6%9D%A8%E5%B8%88&phone=MTc2MTI3Nzg1Mjk%3D', //${flowId}为流程 id,name、phone 按需给envVersion:'release’,success(res){// 打开成功}})
path 里的参数(name,phone)均使用
~${base64url(value)}
统一编码。客户 App 如何跳转到电子签小程序完成签署?
1. Android App 请参见 官方文档。
2. iOS App 请参见 官方文档。
3. 所需参数:
正式环境:
电子签小程序 Appid:wxa023b292fd19d41d。
电子签小程序原始 ID:gh_da88f6188665。
电子签小程序合同详情页:path:pages/guide?from=app&to=CONTRACT_DETAIL&id=${flowId}&name=&phone=。
测试环境:
电子签小程序 Appid:wx371151823f6f3edf。
电子签小程序原始 ID:gh_39a5d3de69fa。
电子签小程序合同详情页:path:pages/guide?from=app&to=CONTRACT_DETAIL&id=${flowId}&name=&phone=。
为什么客户在小程序中无法找到自己的合同?
请确认客户有使用和发起时相同的姓名、手机号进行小程序登录。且在个人中心 > 切换身份确认已切换为签署时要求的身份。
如何选择通过全屏或半屏方式打开电子签小程序?
可参见微信官方文档:
如何配置跳转至电子签小程序的不同页面?
请参见以下表格及说明:
参数说明
下表描述的是外部小程序拉起电子签小程序首页、列表页、个人中心页、合同封面页、合同详情页的参数配置。
参数 | 类型 | 默认值 | 必填 | 描述 |
path | string | - | 是 | 目标页面路由。 |
login | number | 0 | 否 | 是否需要登录。 |
verify | number | 0 | 否 | 是否需要实名。 |
accountType | string | - | 否 | personal:切换个人身份。 |
userIds | string | - | 否 | 如果该链接目标用户只有一个人使用,则直接取该用户的 userId;如果该链接目标用户多人使用,可以将 userId1,userId2 这样赋值:[userId1,userId2]。 |
organizationId | string | - | 否 | 企业账号的企业 ID,如果添加此参数则还要同步携带 orgName。 |
orgName | string | - | 否 | 企业账号的名称,如果添加 organizationId 则还要同步携带此参数。 |
id | string | - | 否 | 合同 ID,如果是到合同封面页或者合同详情页,此参数必填。 |
channel | string | - | 否 | 其他小程序渠道的标记,方便统计使用。 |
quickSponsor | string | false | 否 | 到首页是否需要立即拉起快速发起合同弹框。 true:出现快速发起弹框。 false:不出现。 |
首页
C 端用户进入首页
- pages/guide/index?path=/pages/home/home-index&accountType=personal&channel=${channel}
C 端用户进入首页-快速发起合同
- pages/guide/index?path=/pages/home/home-index&login=1&accountType=personal&channel=${channel}&quickSponsor=true
B 端用户进入首页
进入 B 端首页必须已登录已实名,可指定用户的 userIds 合集,或者 organizationId(指定了 organizationId,则需要同步携带 orgName)。
以下两种方式均可:
- pages/guide/index?path=/pages/home/home-index&login=1&verify=1&userIds=${userIds}&channel=${channel}- pages/guide/index?path=/pages/home/home-index&login=1&verify=1&organizationId=${organizationId}&orgName=${orgName}&channel=${channel}
B 端用户进入首页-快速发起合同
- pages/guide/index?path=/pages/home/home-index&login=1&verify=1&userIds=${userIds}&channel=${channel}&quickSponsor=true- pages/guide/index?path=/pages/home/home-index&login=1&verify=1&organizationId=${organizationId}&orgName=${orgName}&channel=${channel}&quickSponsor=true
列表页
C 端进入用户列表页
- pages/guide/index?path=/pages/home/home-list&login=1&verify=1&accountType=personal&channel=${channel}
B 端进入用户列表页
进入 B 端首页必须已登录已实名,可指定用户的 userIds 合集,或者 organizationId(指定了 organizationId,则需要同步携带 orgName)。
以下两种方式均可:
- pages/guide/index?path=/pages/home/home-list&login=1&verify=1&userIds=${userIds}&channel=${channel}- pages/guide/index?path=/pages/home/home-list&login=1&verify=1&organizationId=${organizationId}&orgName=${orgName}&channel=${channel}
个人中心
C 端进入用户个人中心
- pages/guide/index?path=/pages/home/home-user&accountType=personal&channel=${channel}
B 端进入用户个人中心
进入 B 端首页必须已登录已实名,可指定用户的 userIds 合集,或者 organizationId(指定了 organizationId,则需要同步携带 orgName)。
以下两种方式均可:
- pages/guide/index?path=/pages/home/home-user&login=1&verify=1&userIds=${userIds}&channel=${channel}- pages/guide/index?path=/pages/home/home-user&login=1&verify=1&organizationId=${organizationId}&orgName=${orgName}&channel=${channel}
合同封面页
C 端用户进入合同封面页或 B 端用户合同封面页
未登录或者未实名的用户也可进入到合同封面页,切换到个人身份可以使用两种方式,使用 accountType=personal,或者使用 userIds 赋值个人身份的 userId。
- pages/guide/index?path=/pages/mvp/contract-preview&accountType=personal&id=${id}&channel=${channel}- pages/guide/index?path=/pages/mvp/contract-preview&userIds=${userIds}&id=${id}&channel=${channel}
合同详情页
无论是 C 端还是 B 端,进入合同详情页均必须已登录已实名。
C 端进入合同详情页
以下方式进入:
可以设置 accountType=personal 进入。
也可指定 C 端用户的个人身份的 userId。
- pages/guide/index?path=/pages/contracts/contract-detail&login=1&verify=1&id=${id}&accountType=personal&channel=${channel}- pages/guide/index?path=/pages/contracts/contract-detail&login=1&verify=1&id=${id}&userIds=${userIds}&channel=${channel}
注意:
如果 B2C 合同发起,对方签署方 C 是新用户,则 C 没有 userId,可指定参数 accountType=personal。
如果 B2C 合同发起,对方签署方 C 是老用户,则以上两种方式均可。
B 端进入合同详情页
可指定用户的 userIds 合集,或者 organizationId(指定了organizationId,则需要同步携带 orgName)。
以下两种常用方式均可:
- pages/guide/index?path=/pages/contracts/contract-detail&login=1&verify=1&id=${id}&userIds=${userIds}&channel=${channel}- pages/guide/index?path=/pages/contracts/contract-detail&login=1&verify=1&id=${id}&organizationId=${organizationId}&orgName=${orgName}&channel=${channel}
特殊情形:
- pages/guide/index?path=/pages/contracts/contract-detail&login=1&verify=1&id=${id}&accountType=personal&channel=${channel}
注意:
如果 B2B 合同发起,对方签署方 B 所在的企业没有注册,那么使用特殊情形,切换到个人身份可查看合同,合同详情页会引导用户申请企业注册。
如果 B2B 合同发起,对方签署方 B 没有加入该企业,那么使用特殊情形,切换到个人身份可查看合同,合同详情页会引导用户申请加入企业。
如果 B2B 合同发起,对方签署方 B 是该企业的员工,那么以上两种常用方式均可使用。