接口描述
对组织机构的名称、证件号和法人三要素进行一致性核验。
注：适用于工商体系企业、个体户、律所、非工商组织等
接口
/v2/identity/verify/organization/verify
请求方式
POST
请求头
提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
name | string | 是 | body | 组织机构名称 |
orgCode | string | 是 | body | 组织证件号: |
legalRepName | string | 是 | body | 法定代表人姓名 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | ||
code | int | 是 | 接口响应结果码（0代表信息一致，非0请参考下方错误码描述） | ||
message | string | 是 | 接口响应结果描述 请根据 code 来判断错误情况，不应该依赖message匹配，因为 message 可能会调整。 | ||
data | object | 否 | 接口响应结果数据 | ||
verifyId | string | 否 | 信息比对业务Id（e签宝数据库标识，开发者可保存，无后续接口使用） | ||
errCode | string | 否 | 子错误码，用于细分信息不一致的具体原因 | ||
errMsg | string | 否 | 子错误信息详情，用于细分信息不一致的具体原因 | ||
compareDetails | object | 否 | 信息比对详情结果（如果查询无结果，以下内容均返回为0） 注：该对象内参数需要联系e签宝技术人员开通才会返回，默认返回null | ||
sameOrgName | string | 否 | 组织机构名称是否与工商信息一致
| ||
sameOrgCode | string | 否 | 组织机构证件号是否与工商信息一致
| ||
sameLegalRepresentative | string | 否 | 法定代表人姓名是否与工商信息⼀致
| ||
legalOrgState | string | 否 | 组织机构经营状态：
| ||
请求示例
{
"name": "杭州天谷****限公司",
"orgCode": "913301****306077",
"legalRepName": "金**"
}响应示例
信息一致，比对通过：
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "b78d953d-c288-111a-b1a3-a9d2f5190045",
"errCode": null,
"errMsg": null,
"compareDetails": {
"sameOrgName": 1,
"sameOrgCode": 1,
"sameLegalRepresentative": 1,
"legalOrgState": 1
}
}
}信息不一致，比对不通过：
{
"code": 30504001,
"message": "信息比对不通过,请检查信息的正确性",
"data": {
"verifyId": null,
"errCode": "30504508",
"errMsg": "企业证件号与企业名称不匹配",
"compareDetails": {
"sameOrgName": 0,
"sameOrgCode": 1,
"sameLegalRepresentative": 1,
"legalOrgState": 1
}
}
}错误码
展开全部参数错误码 | 错误描述 | 解决方案 | |
30500100 | 缺少参数：组织机构名称不能为空 | 请核实组织机构名称是否为空 | |
30500100 | 缺少参数：组织机构证件号不能为空 | 请核实组织机构证件号是否为空 | |
30500100 | 缺少参数：法定代表人姓名不能为空 | 请核实法定代表人姓名是否为空 | |
30500101 | 参数错误：请输入正确的组织机构证件号 | 请核实组织机构证件号格式是否正确 | |
30500101 | 参数错误：请输入正确长度的法定代表人姓名（2-100位） | 请输入正确的法定代表人姓名 | |
30504001（点击“+”展开详情） | 信息比对不通过,请检查信息的正确性 | 信息比对不通过，请核实信息是否匹配 | |
30504501 | 企业名称不⼀致 | 以企业证件号为标准，查询企业名称与企业工商信息不一致，请核实企业名称是否正确 | |
30504502 | 企业经营状态存在异常 | 请联系工商行政管理局更新企业状态后操作（一般是注销或者不在营业期限内） | |
30504504 | 法人姓名不⼀致 | 以企业证件号为标准，查询法定代表人/负责人姓名不一致，请核实法人姓名是否正确 | |
30504008 | 企业证件号与企业名称不匹配 | 企业证件号不存在，请核实企业证件号信息是否真实存在 | |
我要纠错