企业3要素信息比对

更新时间：2024-11-08 20:01:23

接口描述

对工商体系中的企业名称、证件号和法定代表人姓名的一致性进行检查校验。

注：适用于工商体系企业以及个体工商户进行企业3要素信息比对。

接口

/v2/identity/verify/organization/enterprise/bureau3Factors

请求方式

POST

请求头

提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	应用ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	是	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情。

请求参数

参数名称	类型	必选	参数类型	参数说明
name	string	是	body	企业名称
orgCode	string	是	body	企业证件号,支持15位工商注册号或统一社会信用代码
legalRepName	string	是	body	企业法定代表人姓名

响应参数

展开全部参数参数名称		类型	必选	参数说明
code		int	是	接口响应结果码，该参数为0时表示接口调用成功
message		string	是	接口响应结果描述
data		object	否	接口响应结果数据
	verifyId	string	否	信息比对业务Id，请注意保存该数值（比对通过时返回，不一致不返回）
	errCode	string	否	子错误码，用于细分信息不一致的具体原因
	errMsg	string	否	子错误信息详情，用于细分信息不一致的具体原因

请求示例

{
    "name":"杭州xx信息科技有限公司",
    "orgCode":"9133******58306077",
    "legalRepName":"何**"
}

响应示例

信息比对结果一致：

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "1f7a67ce-c108-1111-91d9-4909051c2e8f",
        "errCode": null,
        "errMsg": null
    }
}

信息比对结果不一致：

{
    "code": 30504001,
    "message": "信息比对不通过,请检查信息的正确性",
    "data": {
        "verifyId": null,
        "errCode": "30504504",
        "errMsg": "法人姓名不⼀致"
    }
}

错误码

展开全部参数错误码		错误描述	解决方案
30500100		缺少参数：企业名称不能为空	请核实企业名称是否正确传入
30500100		缺少参数：企业证件号不能为空	请核实企业证件号是否正确传入
30500100		缺少参数：法定代表人姓名不能为空	请核实法定代表人姓名是否正确传入
30500101		参数错误：请输入正确的组织机构证件号	请核实企业证件号格式是否正确
30500101		参数错误：请输入正确长度的法定代表人姓名（2-100位）	请输入正确的法定代表人姓名
30504001（点击“+”展开详情）		信息比对不通过,请检查信息的正确性	信息比对不通过，请核实信息是否匹配
	30504501	企业名称不⼀致	以企业证件号为标准，查询企业名称与企业工商信息不一致，请核实企业名称是否正确
	30504502	企业经营状态存在异常	请联系工商行政管理局更新企业状态后操作（一般是注销或者不在营业期限内）
	30504504	法人姓名不⼀致	以企业证件号为标准，查询法定代表人/负责人姓名不一致，请核实法人姓名是否正确
	30504508	企业证件号与企业名称不匹配	企业证件号不存在，请核实企业证件号信息是否真实存在