跳到主要内容

变更企业信息

1. 接口描述​

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

本接口用于企业在已完成工商变更登记后，在电子签侧同步更新企业基础信息，并上传最新的营业执照或相关证照图片作为变更凭证。 ⚠️ 重要说明 本接口不做营业执照 OCR 识别：系统不会对上传的营业执照图片进行内容识别。调用方需自行把工商变更后的最新信息，通过 organization_name / legal_name / address 等字段显式传入；营业执照图片仅作为变更凭证上传与留存。 只传"变了"的字段即可：各信息字段均为"变更后的新值"，未变更的字段留空不传，系统会自动沿用电子签侧当前值（含统一社会信用代码）。四项信息（企业名称、法人姓名、地址、新法人手机号）至少需传入其一。 受理请求后，接口会依次完成以下处理： 操作人身份校验：调用方（operator.user_id）必须是该企业的法定代表人或超级管理员，否则返回无权限错误。 营业执照校验：校验 biz_license_resource_id 对应的图片资源归属（须属于当前企业/应用），仅作凭证存储，不做 OCR。 工商信息比对：将传入的新值（已传的字段）与电子签侧现有数据比对，确认确实存在变更内容；若与现状完全一致，则返回「企业信息未变更」。 未完结合同检查：仅当企业名称发生变更时，才检查该企业在 SaaS 与渠道子客下是否存在尚未完成的签署合同（白名单企业豁免）；若存在未完结合同则拦截并提示先处理合同。 工商三要素核验与变更执行：对企业名称、法人、统一社会信用代码进行工商三要素核验（每日最多 10 次）。核验通过则直接执行信息变更；核验不通过则转入收录审核流程，待审核通过后生效。

收录申请触发的场景 本接口在工商信息变更时，会用「新企业名称 + 统一社会信用代码(USCC) + 新法定代表人姓名」三要素与工商登记信息做校验，以此决定是直接执行变更还是提交收录申请（人工审核）。 统一社会信用代码不可变更：系统自动取企业当前在库的 USCC 参与校验，不接受入参修改。 企业名称 / 法定代表人姓名取您本次传入的新值（未传则沿用当前值）。

当工商三要素校验未通过时，接口不会直接修改企业信息，而是提交收录申请进入人工审核。具体触发场景如下：

触发场景说明
三要素与工商登记不一致传入的新企业名称或新法人姓名，与当前统一社会信用代码（USCC）在工商登记中的记录不匹配
工商库企业状态异常依据当前 USCC 在工商库中查到的企业状态非正常（如查无此企业、已注销、已吊销等）

反向说明：三要素校验全部通过时，接口会直接执行企业信息变更，无需收录审批。

默认接口请求频率限制：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 识别，该图片仅作为企业信息变更的凭证留存；企业最新的名称、法人、地址等信息仍需通过本接口的其它字段显式传入。


示例值：yD3JaUUckperpm7qUxaAsRsEvrnOVuVD
OrganizationName否String

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


示例值：黑拉顿平原测试
Address否String

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


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

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

枚举值：

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

示例值：ENTERPRISE
LegalName否String

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


示例值：典子谦

3. 输出参数​

参数名称类型描述
ErrorCodeInteger

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

枚举值：

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

示例值：1
ErrorMessageString

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


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

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


示例值：4
FlowIdsArray of String

SaaS 企业下未完结合同的 flowId 列表。


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

渠道子客企业下未完结合同的 flowId 列表。


示例值：["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": "东莞万御安防科技服务有限公司"
}

输出示例​

{
    "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": ""
}

输出示例​

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

5. 错误码​

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

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