跳到主要内容

变更子客企业信息

1. 接口描述​

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

本接口用于企业完成工商变更登记后，在电子签侧同步更新企业基础信息，并上传最新的营业执照作为变更凭证。

调用权限：仅限企业超级管理员或法人有权调用（即 Agent.ProxyOperator.OpenId 必须传入超管或法人的 OpenId）。

  • 不会OCR：系统不会自动识别营业执照图片。变更后的新信息（企业名称、法人、地址、类型）必须通过对应字段（OrganizationName / LegalName 等）显式传入。
  • 增量更新（只传变了的）：仅传入已变更的字段新值，未变更的字段留空，系统会自动沿用电子签侧的当前值。若无任何字段变更，请勿调用此接口。
  • 未完结合同限制：若企业名称发生变更，系统会拦截检查是否存在全平台（同名的saas自建企业和子客企业）未完结的签署合同（针对白名单企业豁免，可联系对接的客户经理沟通）。若存在，须先撤销或完成签署，否则无法变更。
  • 每日频控：同一个操作人（ProxyOperator.OpenId）每日核验上限为 10 次。

变更审核流程​

接口在处理变更时，会先进行工商三要素（企业名称、法人姓名、统一社会信用代码）核验，流程分为以下两条路径：

触发人工审核（收录流程）的具体场景：​

  1. 三要素不一致：传入的“新企业名称”或“新法人姓名”，与该统一社会信用代码（USCC）在官方工商登记中的记录不匹配。
  2. 工商状态异常：该 USCC 在工商库中的状态为异常（如查无此企业、已注销、已吊销等）。

变更成功后的影响​

企业信息变更成功后，系统会自动执行以下关联操作：

变更维度级联影响
法人变更1. 作废当前企业下的原法人印章。2. 原法人账号降级为普通员工。3. 向新法人手机号发送激活/通知短信。
企业名称变更1. 作废该企业当前的 CA 证书并颁发新证书。2. 生成新的企业公章。
地址变更仅同步修改企业登记地址。
企业类型变更仅同步修改企业类型。

相关回调事件​

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

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

2. 输入参数​

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

参数名称必选类型描述
Action是String公共参数，本接口取值：ModifyOrganizationBusinessInfo。
Version是String公共参数，本接口取值：2021-05-26。
Region否String公共参数，此参数为可选参数。
Agent是Agent

关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容此接口下面信息必填。

  • 渠道应用标识: Agent.AppId
  • 第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
  • 第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId
注:1. 企业激活时， 此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识，建议开发者保存企业ProxyOrganizationOpenId，后续各项接口调用皆需要此参数。2. 员工认证时， 此时的Agent.ProxyOperator.OpenId将会是员工认证加入企业后的唯一标识，建议开发者保存此员工的OpenId，后续各项接口调用皆需要此参数。3. 同渠道应用(Agent.AppId)下，企业唯一标识ProxyOrganizationOpenId需要保持唯一，员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。

BizLicenseResourceId是String

企业营业执照或相关证照图片的 resourceId，需提前通过上传文件接口获取后传入。
注意：电子签不会对上传的营业执照图片做 OCR 识别，该图片仅作为企业信息变更的凭证留存；企业最新的名称、法人、地址等信息仍需通过本接口的其它字段显式传入。


示例值：yDCNIUUckpv809ikUuxOPaXRjLuPnGvS
OrganizationName否String

变更后的最新工商登记企业名称。
仅当企业名称发生变更时传入，未变更则不传（系统自动沿用电子签侧当前企业名称）。


示例值：东莞万御安防科技服务有限公司
Address否String

变更后的企业注册地址。
仅当地址发生变更时传入，未变更则不传；传入后系统会自动解析省/市/区。


示例值：深圳市南山区高新区科技中一路腾讯大厦
OrganizationType否String

变更后的企业类型。
仅当企业类型发生变更时传入，未变更则不传（沿用当前类型）。
目前仅支持个体工商户（INDIVIDUALBIZ）变更为企业（ENTERPRISE）。

枚举值：

  • INDIVIDUALBIZ： 个体工商户
  • ENTERPRISE： 企业

示例值：ENTERPRISE
LegalName否String

变更后的最新工商登记法人姓名。
仅当法人发生变更时传入，未变更则不传（系统自动沿用当前法人姓名）。


示例值：东**淑
NewLegalMobile否String

新法人的手机号。
仅当法人发生变更时传入，用于向新法人发送短信通知。
需为合法的手机号或固定电话格式。


示例值：132****0000

3. 输出参数​

参数名称类型描述
ErrorCodeInteger

业务状态码。
0 表示正常（无阻断）；非 0 表示存在阻断，例如企业名称变更且存在未完结合同时返回 1。

枚举值：

  • 0： 正常（无阻断）
  • 1： 存在未完结合同

示例值：1
ErrorMessageString

提示文案。
例如企业名称变更且存在未完结合同时返回「存在 X 份未完结的合同，请先撤销或者完成合同」。


示例值：存在 87 份未完结的合同，请先撤销或者完成合同
UnfinishedCountInteger

未完结合同总数。
仅当企业名称变更且存在未完结合同时有值。


示例值：87
FlowIdsArray of String

SaaS 企业下未完结合同的 flowId 列表。注:SaaS企业下的合同ID可能无法查询，可通知子客企业去处理相应的合同


示例值：["yD3JaUUckperbj2gU1UxOsoPKSdAroVT"]
ChannelFlowIdsArray of String

渠道子客企业下未完结合同的 flowId 列表。注：子客企业在其他渠道下的合同ID可能无法查询，可通知子客企业去处理其他渠道下相应的合同


示例值：["yD3JcUUckpep6qq5U1UyDrfDm8l6NzKw"]
RequestIdString唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例​

示例1 变更企业信息，共有 87 份 saas 和 第三方子客未完结的合同，拦截​

输入示例​

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

{
    "Agent": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2",
        "ProxyOrganizationOpenId": "ess_open_organization_1",
        "ProxyOperator": {
            "OpenId": "yuan"
        }
    },
    "BizLicenseResourceId": "yDCNIUUckpv809ikUuxOPaXRjLuPnGvS",
    "OrganizationName": "东莞万御安防科技服务有限公司",
    "NewLegalMobile": "132****0000"
}

输出示例​

{
    "Response": {
        "ChannelFlowIds": [
            "yD3JcUUckpep6qq5U1UyDrfDm8l6NzKw"
        ],
        "ErrorCode": 1,
        "ErrorMessage": "存在 87 份未完结的合同，请先撤销或者完成合同",
        "FlowIds": [
            "yD3JaUUckperbj2gU1UxOsoPKSdAroVT"
        ],
        "UnfinishedCount": 87,
        "RequestId": "f0572876-6ef1-4616-a77e-c2f28dee3c1f"
    }
}

示例2 变更企业信息，有 4 份 第三方子客未完结的合同，拦截​

输入示例​

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

{
    "Agent": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2",
        "ProxyOrganizationOpenId": "huo_la_dun_ping_yuan",
        "ProxyOperator": {
            "OpenId": "kyle_huo_xian"
        }
    },
    "BizLicenseResourceId": "yD3JaUUckperpm7qUxaAsRsEvrnOVuVD",
    "OrganizationName": "黑****测试",
    "Address": "",
    "LegalName": "",
    "NewLegalMobile": ""
}

输出示例​

{
    "Response": {
        "ChannelFlowIds": [
            "yD3JaUUckperl3wcU1UVOahuSNCPtvmn"
        ],
        "ErrorCode": 1,
        "ErrorMessage": "存在 4 份未完结的合同，请先撤销或者完成合同",
        "FlowIds": [],
        "UnfinishedCount": 4,
        "RequestId": "dbe937ef-2ee0-4130-9a14-731425ffd627"
    }
}

示例3 变更企业信息成功，修改企业名称以及法人​

输入示例​

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

{
    "Agent": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2",
        "ProxyOrganizationOpenId": "huo_la_dun_ping_yuan",
        "ProxyOperator": {
            "OpenId": "kyle_huo_xian"
        }
    },
    "BizLicenseResourceId": "yD3JaUUckperpm7qUxaAsRsEvrnOVuVD",
    "OrganizationName": "黄****测试",
    "Address": "",
    "LegalName": "东**淑",
    "NewLegalMobile": "19*******27"
}

输出示例​

{
    "Response": {
        "ChannelFlowIds": [],
        "ErrorCode": 0,
        "ErrorMessage": "",
        "FlowIds": [],
        "UnfinishedCount": 0,
        "RequestId": "43b5b52f-0c57-48c3-a36d-e314b1498b26"
    }
}

5. 错误码​

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

错误码描述
FailedOperation操作失败。
FailedOperation.OrganizationNotChange企业信息未变更
InternalError.Db数据库错误。
InvalidParameter参数错误。
InvalidParameterValue参数取值错误。
MissingParameter缺少参数错误。
OperationDenied操作被拒绝。
OperationDenied.NotSupportOrgType不支持的企业类型
ResourceNotFound资源不存在。
更多开发者交流反馈