跳到主要内容

获取变更企业信息电子签小程序链接

1. 接口描述

接口请求域名: essbasic.tencentcloudapi.com 。

此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。

支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。

WEIXINAPP

创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。

APP

创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。

支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。

1. 企业超管变更

换成企业的其他员工来当超管

2. 企业基础信息变更

可以变动
  • 企业名称
  • 法定代表人姓名(新法人有邀请链接)
  • 企业地址和所在地
不可变动
  • 统一社会信用代码
  • 企业主体类型

如果企业名称变动会引起下面的变动

  • 合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署
  • 印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理
  • 证书: 企业证书会重新请求CA机构用新企业名称生成新的证书

注意:

  1. 生成的电子签小程序链接只能由企业的法人或者超管点击后进行操作, 其他员工打开后会提示“无权查看该内容”
  2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称必选类型描述
ActionString公共参数,本接口取值:CreateChannelOrganizationInfoChangeUrl。
VersionString公共参数,本接口取值:2021-05-26。
RegionString公共参数,此参数为可选参数。
AgentAgent关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。

此接口下面信息必填。

  • 渠道应用标识: Agent.AppId
  • 第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
  • 第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId


第三方平台子客企业和员工必须已经过实名认证
ChangeTypeInteger企业信息变更类型,可选类型如下:
  • 1:企业超管变更, 可以将超管换成同企业的其他员工
  • 2:企业基础信息变更, 可以改企业名称 , 所在地址 , 法人名字等信息

示例值:1
EndpointString变更链接类型:

  • WEIXINAPP : 创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。(默认)
  • APP : 创建变更小程序链接,可从第三方App或者小程序跳转到微信腾讯电子签小程序进行更换。

3. 输出参数

参数名称类型描述
UrlString创建的企业信息变更链接。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。
示例值:https://essurl.cn/000S6UE3mJ
ExpiredTimeInteger链接过期时间。链接7天有效。
示例值:1695713654
RequestIdString唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 错误示例-变更类型不合法

设置changeType为3,接口将返回错误信息。

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateChannelOrganizationInfoChangeUrl
<公共请求参数>

{
"Agent": {
"AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOj2",
"ProxyOrganizationOpenId": "ess_open_organization_1",
"ProxyOperator": {
"OpenId": "openid1"
}
},
"ChangeType": 3
}

输出示例

{
"Response": {
"Error": {
"Code": "InvalidParameter.ParamError",
"Message": "不支持的变更类型:3,请确认后重新"
},
"RequestId": "30cc3f4a-8f8c-4ec7-a6fb-66a82590c546"
}
}

示例2 创建企业信息变更链接(短链)

设置changeType为2,创建企业信息变更链接。

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateChannelOrganizationInfoChangeUrl
<公共请求参数>

{
"Agent": {
"AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOj2",
"ProxyOrganizationOpenId": "ess_open_organization_1",
"ProxyOperator": {
"OpenId": "openid1"
}
},
"ChangeType": 2,
"Endpoint": "WEIXINAPP"
}

输出示例

{
"Response": {
"ExpiredTime": 1695798606,
"RequestId": "38be082e-08c4-4f37-a0b7-cd47cf9982b5",
"Url": "https://test.essurl.cn/CvEXWU6RkKW"
}
}

示例3 创建超管变更链接(小程序链接)

设置changeType为1,创建企业超管变更小程序链接链接

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateChannelOrganizationInfoChangeUrl
<公共请求参数>

{
"Agent": {
"AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOj2",
"ProxyOrganizationOpenId": "ess_open_organization_1",
"ProxyOperator": {
"OpenId": "openid1"
}
},
"ChangeType": 1,
"Endpoint": "APP"
}

输出示例

{
"Response": {
"ExpiredTime": 1695798287,
"RequestId": "3bff7e92-76f8-4e09-85df-e7cb982cb454",
"Url": "/pages/guide/index?to=CHANGE_SUPER_ADMIN&organizationId=yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF&channelType=test&adminName=张*&legalName=李*&expireTime=1695798287"
}
}

5. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码描述
InternalError.System系统错误。
InvalidParameter.ParamError参数错误。
ResourceNotFound资源不存在。
更多开发者交流反馈
购买咨询
微信客服
4006-808-062
4006-808-062