变更子客企业信息

1. 接口描述

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

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

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

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

变更审核流程

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

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

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

变更成功后的影响

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

相关回调事件

• 变更直接成功/确认成功后：触发 企业基础信息修改通知回调
• 人工收录审核产生结果后：触发 企业收录申请审核结果回调

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

2. 输入参数

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

3. 输出参数

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. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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