跳到主要内容
文档icon文档中心

小程序相关问题

客户小程序如何跳转到电子签小程序完成签署?

请参见小程序 官方文档。小程序支持直接跳转到签署页面,完成签署后可返回客户小程序。可参见以下代码:
正式环境:
wx.navigateToMiniProgram({
appId:'wxa023b292fd19d41d', // 电子签小程序的appId
path:'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', // 电子签小程序的appId
path:'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 是该企业的员工,那么以上两种常用方式均可使用。
购买咨询
微信客服
4006-808-062
4006-808-062