数据合作 / 接口产品 / 企业工商基本查询


企业工商基本查询 10 BBN/次(最终定价以商务协议为准)

根据企业的名称、注册号等查询企业的法定代表人、注册资本、经营状态等基本信息。

适用于:金融征信

申请试用
产品说明 接入指南 接口规范 通用返回码

1. 产品说明

参数输入要求

以下接口文档内,将对请求参数是否必填作出说明。

输入要求 英文名称 简写名称
必填 Must M
条件必填 Conditional C
选填 Optional O

1.1 产品介绍

输入企业名称或企业注册号,返回企业工商基本信息。

1.2 请求参数示例

{
"productId":"C0202",
"customerId":"1522649248140",
"orgInfo":"orgName",
"orgInfoType":"中国电信股份有限公司上海分公司"
}

1.3 请求参数说明

参数 类型 输入要求 说明
productId String M 产品唯一编号
customerId String M 客户查询流水号,确保唯一
orgInfo String M 查询关键字(根据类型)
orgInfoType String M 企业信息类型:orgName(企业名称) , orgRegNo(企业注册号)

1.4 返回示例

以下仅为简单示例

查询成功

{
"result":{
"BASIC":{
"ITEM":{
"CHANGEDATE":"2008-01-28",
"ABUITEM":"在上海经营800MHz CDMA第二代数字蜂窝移动通信业务和CDMA2000第三代数字蜂窝移动通信业务和LTE/第四代数字蜂窝移动通信业务(TD-LTE/LTE FDD),在上海经营固定网本地电话业务(含本地无线环路业务)、固定网国内长途电话业务、固定网国际长途电话业务、IP电话业务(限于Phone-to-Phone)、卫星国际专线业务、因特网数据传送业务、国际数据通信业务、公众电报和用户电报业务、26GHz无线接入业务、国内通信设施服务业务,在上海经营第二类基础电信业务中的国内甚小口径终端地球站(VSAT)通信业务、固定网国内数据传送业务、无线数据传送业务、用户驻地网业务、网络托管业务;第一类增值电信业务中的在线数据处理与交易处理业务、国内因特网虚拟专用网业务、因特网数据中心业务;第二类增值电信业务中的存储转发类业务、呼叫中心业务、因特网接入服务业务和信息服务业务,经营与通信及信息业务相关的系统集成、技术开发、技术服务、技术培训、技术咨询、信息咨询、设备及计算机软硬件等的生产、销售、安装和设计与施工,房屋租赁,通信设施租赁,安全技术防范系统的设计、施工和维修,广告业务。 【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
"INDUSTRYPHYALL":"I信息传输、软件和信息技术服务业",
"ENTSTATUS":"在营(开业)",
"INDUSTRYPHYCODE":"I",
"ZSOPSCOPE":"基础电信业务:在上海经营800MHz CDMA第二代数字蜂窝移动通信业务、CDMA2000第三代数字蜂窝移动通信业务和LTE/第四代数字蜂窝移动通信业务(TD-LTE/LTE FDD),在上海经营固定网本地电话业务(含本地无线环路业务)、固定网国内长途电话业务、固定网国际长途电话业务、IP电话业务(限Phone-Phone的电话业务)、卫星国际专线业务、因特网数据传送业务、国际数据通信业务、公众电报和用户电报业务、26GHz无线接入业务、国内通信设施服务业务,增值电信业务:在上海经营第二类基础电信业务中的国内甚小口径终端地球站通信业务、固定网国内数据传送业务、用户驻地网业务、网络托管业务(比照增值电信业务管理)、第一类增值电信业务中的互联网数据中心业务、国内互联网虚拟专用网业务、互联网接入服务业务,第二类增值电信业务中的在线数据处理与交易处理业务、存储转发类业务、国内呼叫中心业务和信息服务业务以及无线数据传送业务,IPTV传输服务:服务内容为IPTV集成播控平台与电视用户端之间提供信号传输和相应技术保障,传输网络为利用固定通信网络(含互联网)架设IPTV信号专用传输网络,IPTV传输服务在限定的地域范围内开展,互联网地图服务(有效期至2019年12月31日),利用信息网络经营音乐娱乐产品,游戏产品(含网络游戏虚拟货币发行),艺术品、演出剧(节)目、表演、动漫产品、从事网络文化产品的展览、比赛活动,经营与通信及信息业务相关的系统集成、技术开发、技术服务、技术咨询、信息咨询、设备及计算机软硬件等的生产、销售、安装和设计与施工,房屋租赁,通信设施租赁,安全技术防范系统的设计、施工和维修,广告业务。 【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
"REGORG":"自贸试验区分局",
"FRNAME":"马某某",
"OPSCOANDFORM":"在上海经营800MHz CDMA第二代数字蜂窝移动通信业务和CDMA2000第三代数字蜂窝移动通信业务和LTE/第四代数字蜂窝移动通信业务(TD-LTE/LTE FDD),在上海经营固定网本地电话业务(含本地无线环路业务)、固定网国内长途电话业务、固定网国际长途电话业务、IP电话业务(限于Phone-to-Phone)、卫星国际专线业务、因特网数据传送业务、国际数据通信业务、公众电报和用户电报业务、26GHz无线接入业务、国内通信设施服务业务,在上海经营第二类基础电信业务中的国内甚小口径终端地球站(VSAT)通信业务、固定网国内数据传送业务、无线数据传送业务、用户驻地网业务、网络托管业务;第一类增值电信业务中的在线数据处理与交易处理业务、国内因特网虚拟专用网业务、因特网数据中心业务;第二类增值电信业务中的存储转发类业务、呼叫中心业务、因特网接入服务业务和信息服务业务,经营与通信及信息业务相关的系统集成、技术开发、技术服务、技术培训、技术咨询、信息咨询、设备及计算机软硬件等的生产、销售、安装和设计与施工,房屋租赁,通信设施租赁,安全技术防范系统的设计、施工和维修,广告业务。 【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
"REGORGCODE":"310141",
"INDUSTRYCOALL":"6311固定电信服务",
"REGNO":"310115001055697",
"CBUITEM":"在上海经营800MHz CDMA第二代数字蜂窝移动通信业务和CDMA2000第三代数字蜂窝移动通信业务和LTE/第四代数字蜂窝移动通信业务(TD-LTE/LTE FDD),在上海经营固定网本地电话业务(含本地无线环路业务)、固定网国内长途电话业务、固定网国际长途电话业务、IP电话业务(限于Phone-to-Phone)、卫星国际专线业务、因特网数据传送业务、国际数据通信业务、公众电报和用户电报业务、26GHz无线接入业务、国内通信设施服务业务,在上海经营第二类基础电信业务中的国内甚小口径终端地球站(VSAT)通信业务、固定网国内数据传送业务、无线数据传送业务、用户驻地网业务、网络托管业务;第一类增值电信业务中的在线数据处理与交易处理业务、国内因特网虚拟专用网业务、因特网数据中心业务;第二类增值电信业务中的存储转发类业务、呼叫中心业务、因特网接入服务业务和信息服务业务,经营与通信及信息业务相关的系统集成、技术开发、技术服务、技术培训、技术咨询、信息咨询、设备及计算机软硬件等的生产、销售、安装和设计与施工,房屋租赁,通信设施租赁,安全技术防范系统的设计、施工和维修,广告业务。 【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
"OPFROM":"2008-01-28",
"INDUSTRYCONAME":"固定电信服务",
"ENTNAMEENG":"中国电信股份有限公司上海分公司",
"EMPNUM":"0",
"ANCHEYEAR":"2015",
"DOM":"中国(上海)自由贸易试验区世纪大道211号38层",
"CREDITCODE":"91310115671143758E", "ENTTYPE":"股份有限公司分公司(上市、国有控股)",
"DOMDISTRICT":"310115",
"INDUSTRYCOCODE":"6311",
"OPSCOPE":"基础电信业务:在上海经营800MHz CDMA第二代数字蜂窝移动通信业务、CDMA2000第三代数字蜂窝移动通信业务和LTE/第四代数字蜂窝移动通信业务(TD-LTE/LTE FDD),在上海经营固定网本地电话业务(含本地无线环路业务)、固定网国内长途电话业务、固定网国际长途电话业务、IP电话业务(限Phone-Phone的电话业务)、卫星国际专线业务、因特网数据传送业务、国际数据通信业务、公众电报和用户电报业务、26GHz无线接入业务、国内通信设施服务业务,增值电信业务:在上海经营第二类基础电信业务中的国内甚小口径终端地球站通信业务、固定网国内数据传送业务、用户驻地网业务、网络托管业务(比照增值电信业务管理)、第一类增值电信业务中的互联网数据中心业务、国内互联网虚拟专用网业务、互联网接入服务业务,第二类增值电信业务中的在线数据处理与交易处理业务、存储转发类业务、国内呼叫中心业务和信息服务业务以及无线数据传送业务,IPTV传输服务:服务内容为IPTV集成播控平台与电视用户端之间提供信号传输和相应技术保障,传输网络为利用固定通信网络(含互联网)架设IPTV信号专用传输网络,IPTV传输服务在限定的地域范围内开展,互联网地图服务(有效期至2019年12月31日),利用信息网络经营音乐娱乐产品,游戏产品(含网络游戏虚拟货币发行),艺术品、演出剧(节)目、表演、动漫产品、从事网络文化产品的展览、比赛活动,经营与通信及信息业务相关的系统集成、技术开发、技术服务、技术咨询、信息咨询、设备及计算机软硬件等的生产、销售、安装和设计与施工,房屋租赁,通信设施租赁,安全技术防范系统的设计、施工和维修,广告业务。 【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
"ESDATE":"2008-01-28",
"INDUSTRYPHYNAME":"信息传输、软件和信息技术服务业",
"ENTNAME":"中国电信股份有限公司上海分公司",
"TEL":"02163242526",
"REGORGPROVINCE":"上海市"
}
}
},
"code":"200",
"gid":"554711b80015c00",
"customerId":"1528983070338",
"message":"查询成功",
"status":"2000"
}

没有查询到结果

{
"code":"200",
"gid":"6ab2f483c20d567",
"customerId":"1324061654413",
"message":"没有查询到结果",
"status":"2001"
}

失败

{
"code":"500",
"gid":"4fc45cfe580d861",
"customerId":"1622815334572",
"message":"渠道异常",
"status":"9902"
}

1.5 返回字段说明

节点名称 字段名 描述
code 返回码 参见2.附录
status 状态码 参见2.附录
message 状态信息 参见2.附录
gid 流水号 我方返回唯一id
customerId 客户请求流水号 原样返回
result 查询结果 见BASIC节点说明

BASIC.ITEM节点说明

节点名称 字段名 描述
ENTNAME 企业名称
REGNO 注册号
ORIREGNO 原注册号
FRNAME 法定代表人姓名 企业为法定代表人姓名,个体户为负责人姓名
REGCAP 注册资本 单位:万元
RECCAP 实收资本 单位:万元
REGCAPCUR 币种 人民币、美元等
ENTSTATUS 经营状态 在营、吊销、注销、其他
ENTTYPE 企业(机构)类型 有限责任公司等
ESDATE 开业日期 YYYY-MM-DD
OPFROM 经营期限自 YYYY-MM-DD
OPTO 经营期限至 YYYY-MM-DD
DOM 住址
REGORG 登记机关
ABUITEM 许可经营项目
CBUITEM 一般经营项目
OPSCOPE 经营(业务)范围
OPSCOANDFORM 经营(业务)范围及方式
ANCHEYEAR 最后年检年度 YYYY
CHANGEDATE 变更日期 YYYY-MM-DD
CANDATE 注销日期 YYYY-MM-DD
REVDATE 吊销日期 YYYY-MM-DD
ANCHEDATE 最后年检日期 YYYY-MM-DD
INDUSTRYPHYCODE 行业门类代码
INDUSTRYPHY 行业门类名称
INDUSTRYCOCODE 国民经济行业代码
INDUSTRYCONAME 国民经济行业名称
REGORGCODE 注册地址行政区编号
REGORGPROVINCE 所在省份
INDUSTRYPHYALL 行业门类代码及名称
INDUSTRYCOALL 国民经济行业代码及名称
EMPNUM 员工人数
ENTNAMEENG 企业英文名称
TEL 联系电话
ZSOPSCOPE 经营业务范围
CREDITCODE 统一社会信用代码
DOMDISTRICT 住所所在行政区划

2. 附录

2.1 响应吗和状态码

响应码 状态码 状态信息
200 2000 查询成功
200 2001 没有查询到结果

2.2 通用响应码和状态码

响应码 状态码 状态信息
400 9800 账户不存在或被禁用
400 9801 访问资源不存在
400 9802 请求IP没有访问权限
400 9803 没有此产品访问权限
400 9804 参数为空或格式错误
400 9805 该帐号余额不足
400 9806 此接口请求次数达到上限
400 9807 报文解析错误
400 9808 验签失败
400 9809 查询时间区间不正确
400 9810 访问产品不存在
400 9811 标签没有权限访问
400 9812 密钥未配置或过期
400 9813 产品后台配置异常
500 9900 系统异常
500 9901 服务异常
500 9902 渠道异常
500 9903 请求超时

接口接入指南,意在指导客户从完成账号申请,到接口接入主要步骤的说明。

1. 试用账号接入流程

1.1. 客户申请测试账号

客户需发送邮件,告知我方如下必备的信息,包含:公司名称、联系人姓名、联系人邮箱、联系人电话、报备公司访问 IP。

1.2. 运营人员审核

业务运营人员对客户资质做初步的审核。

1.3. 开通测试账号

客户资质审核通过后,由运营人员为客户开通账号,设置访问权限和访问次数等。并将测试账号的登录信息,以及接口对接需要的相关文档发送给客户。

2. 正式账号接入流程

2.1. 双方签署合作协议

双方商务对接人员,签署合作协议,明确接口可用的时间,调用的价格。

2.2. 合作款项到账通知

我方财务人员确认合作款项到账,并通知到业务部门。

2.3. 开通正式账号

业务运营人员为客户开通正式账号,配置接口可用时间和收费价格。并将正式账号的登录信息,以及接口对接需要的相关文档发送给客户。

接口地址URL https://<host> (见邮件)
参数编码 UTF-8 参数格式 JSON
请求方法 POST 协议类型 HTTPs
请求参数示例 { “account” : ”123456”, “data” : ”encrypted request data”, “sign” : ” 6C768121683C45ABD83546A73DBE3284” }
请求参数详情 account 账户号(我方分配给客户账户号)
data 密文数据主体(参数主体JSON数据(见4.1.2) RSA加密后字符串),加密流程见3.1.2
sign 签名(采用MD5加密account、data两个参数的值组成的字符串),签名规则见3.2
响应结果示例 { “encrypt” : true, “data” : ”encrypted response data”, “sign” : ” EE4D39671D825BA272D4D2540D095EF7” }
返回参数详情 encrypt 数据主体是否加密标识(当请求用户的账号无法获取时,数据主体不加密,该字段为false)
data 数据主体(数据主体原始响应内容由具体接口定义数据格式),解密流程见3.1.3
sign 签名(采用MD5加密encrypt、data 两个参数的值组成的字符串),验签流程见3.2

1.数据加密/解密

接口传输的所有数据均使用RSA公钥对参数进行加密处理。

1.1. 生成秘钥(首次接入时)

# 生成私钥

openssl genrsa-out app_private_key.pem 2048

# Java开发者需要将私钥转换成PKCS8格式

openssl pkcs8-topk8 -inform PEM -in app_private_key.pem -outform PEM -nocrypt -outapp_private_key_pkcs8.pem

# 生成公钥

openssl rsa -in app_private_key.pem-pubout -out app_public_key.pem

上述三条命令执行完成后会生成开发者可以在当前文件夹中,看到app_private_key.pem(开发者RSA私钥)、app_private_key_pkcs8.pem(pkcs8格式开发者RSA私钥)和app_public_key.pem(开发者RSA公钥)3个文件。开发者将私钥保留,将公钥告知我方,用于加密返回参数。


* 注意:
* Java的开发者,将pkcs8文件中的私钥去除头尾、换行和空格,作为开发者私钥。

1.2. 请求参数加密

{
"name":"张三",
"mobile":"12345678910",
"cid":"421087000000000000",
"card":"622100000000",
"customerId":"201301011011290001"
}

使用我司对外公钥进行 RSA 加密,生产加密字符串作为请求参数作为data字段。

RSA_ENCRYPT_BY_PUBLIC_KEY("{\"name\":\"张三\",\"mobile\":\"12345678910\",\"cid\":\"421087000000000000\",\"card\":\"622100000000\",\"customerId\":\"201301011011290001\"}")

加密后data:

oSlffhJki585URCTnFagvhN2SfItSuzFG60NjQTQzWfB3BDMXg0/qqAaTLi0GWwpwRZrfWc1CxYgbL3AzCNcyn/2iyQVeQK0eWa50S9rMqIOUrX7jHYm3vXjqqX2LQQtRF2V8+S7K7JR0MBEO708HGsVDChERLetKJ9pRL3EfftFfl9zEFLhttfFQjLzeK9RNq+8bnf2PqJGBp4hwk0iNA9VajsH4vrNINuLNUiaJWmhklQbCMnU4WutIl+ttNhthOhOnsIYbQyFxVVmURlQwv7HniOjPouyi6OvRpZ2lHlFRo6N0DFqL8Biz71edDrG35LTzyX9w2XhKWicydfT2g==

请求报文:

{
"account":"123456",
"data":"
oSlffhJki585URCTnFagvhN2SfItSuzFG60NjQTQzWfB3BDMXg0/qqAaTLi0GWwpwRZrfWc1CxYgbL3AzCNcyn/2iyQVeQK0eWa50S9rMqIOUrX7jHYm3vXjqqX2LQQtRF2V8+S7K7JR0MBEO708HGsVDChERLetKJ9pRL3EfftFfl9zEFLhttfFQjLzeK9RNq+8bnf2PqJGBp4hwk0iNA9VajsH4vrNINuLNUiaJWmhklQbCMnU4WutIl+ttNhthOhOnsIYbQyFxVVmURlQwv7HniOjPouyi6OvRpZ2lHlFRo6N0DFqL8Biz71edDrG35LTzyX9w2XhKWicydfT2g==", "sign":"EE4D39671D825BA272D4D2540D095EF7"
}

说明:account 为我方分配给客户的账号。

1.3. 响应报文解密

返回报文:

{
"encrypt":true,
"data": "V1YIvvzEBufvnY1wcuEr4GB0YCrPbFiqm0lvQeBV9pXZairLit1aZBxUCYoC+mZ0y64tgY2hRX66JzrRLyWCohKWDfuevNhZOVmJRq+3sDoomEdzAz2WBsK2qvu+YjW43SyYrF1dXozbZn7OMAWSZC8rRc38vS++b+n3GoDsnQdOZ9ebTb/JdYz+Sq7h1GyUIgDmiuhLAvcs6k6+wG6Qvt7mNByZpOse49tlsfLzhusgesU1Y+wz0oDyKcEZfqR4rxR1++3MgB/x1viarSlow1ci71QU4a/uqgw3x5L1QqgrehLnANHH3Fx3XZG9Va2LSxr9oDnoc/cEylAHzqNaeA==",
"sign":"6BD20DF100F66C3D375A072CBF0DBC68"
}

解密业务数据

使用客户私钥进行 RSA 解密 data字段,返回业务返回数据。

RSA_DECRYPT_BY_PRIVATE_KEY("V1YIvvzEBufvnY1wcuEr4GB0YCrPbFiqm0lvQeBV9pXZairLit1aZBxUCYoC+mZ0y64tgY2hRX66JzrRLyWCohKWDfuevNhZOVmJRq+3sDoomEdzAz2WBsK2qvu+YjW43SyYrF1dXozbZn7OMAWSZC8rRc38vS++b+n3GoDsnQdOZ9ebTb/JdYz+Sq7h1GyUIgDmiuhLAvcs6k6+wG6Qvt7mNByZpOse49tlsfLzhusgesU1Y+wz0oDyKcEZfqR4rxR1++3MgB/x1viarSlow1ci71QU4a/uqgw3x5L1QqgrehLnANHH3Fx3XZG9Va2LSxr9oDnoc/cEylAHzqNaeA==")

解密后data:

{
"code":"200",
"status":"2000",
"message":"查询成功",
"result":"****",
"customerId":"201301011011290001",
"gid":"40d7be07-f40e-4021-ae92-9f9ff7b58db7"
}

2. 签名/验签机制

调用接口(API)时,服务器对请求参数进行签名验证,并对请求参数的格式进行正则验证,验证报文合法后才可以正常调用接口。

- 签名算法

签名采用 MD5算法。

- 生成待签名的字符串

把报文中待签名的参数名放入数组里,根据参数名从 a 到 z 的顺序排序,若遇到相同首字母,则看第二个字母,以此类推。排序完成之后,参数名与参数值连接起来,生成待签名字符串。

例如:

请求参数

"account": "123456"
"data":"oSlffhJki585URCTnFagvhN2SfItSuzFG60NjQTQzWfB3BDMXg0/qqAaTLi0GWwpwRZrfWc1CxYgbL3AzCNcyn/2iyQVeQK0eWa50S9rMqIOUrX7jHYm3vXjqqX2LQQtRF2V8+S7K7JR0MBEO708HGsVDChERLetKJ9pRL3EfftFfl9zEFLhttfFQjLzeK9RNq+8bnf2PqJGBp4hwk0iNA9VajsH4vrNINuLNUiaJWmhklQbCMnU4WutIl+ttNhthOhOnsIYbQyFxVVmURlQwv7HniOjPouyi6OvRpZ2lHlFRo6N0DFqL8Biz71edDrG35LTzyX9w2XhKWicydfT2g=="

连接后待签名字符串

account123456dataoSlffhJki585URCTnFagvhN2SfItSuzFG60NjQTQzWfB3BDMXg0/qqAaTLi0GWwpwRZrfWc1CxYgbL3AzCNcyn/2iyQVeQK0eWa50S9rMqIOUrX7jHYm3vXjqqX2LQQtRF2V8+S7K7JR0MBEO708HGsVDChERLetKJ9pRL3EfftFfl9zEFLhttfFQjLzeK9RNq+8bnf2PqJGBp4hwk0iNA9VajsH4vrNINuLNUiaJWmhklQbCMnU4WutIl+ttNhthOhOnsIYbQyFxVVmURlQwv7HniOjPouyi6OvRpZ2lHlFRo6N0DFqL8Biz71edDrG35LTzyX9w2XhKWicydfT2g==

- MD5运算后的签名结果

EE4D39671D825BA272D4D2540D095EF7

- 响应报文验签

用户得到响应结果时,仍按照上文方法生成待签名字符串,然后对其做MD5加签,加签结果与响应中的sign做比较,如果两者相同则验签通过,否则验签失败。

* 注意:
* 1:签名时字符均采用UTF-8编码;
* 2:接口请求采用HTTPS POST方式提交数据,参数无需做URLEncoding转码;

3. 异常响应

{
"code":"400",
"status":"9804",
"customerId":"150165535561065",
"gid":"2734ec87-339a-492a-8864-a375c36ba186",
"message":"参数为空或格式错误"
}

完整的异常响应码、状态码和错误提示信息,请参考附录

响应码 状态码 状态信息
400 9800 账户不存在或被禁用
400 9801 访问资源不存在
400 9802 请求IP没有访问权限
400 9803 没有此产品访问权限
400 9804 参数为空或格式错误
400 9805 该帐号余额不足
400 9806 此接口请求次数达到上限
400 9807 报文解析错误
400 9808 验签失败
400 9809 查询时间区间不正确
400 9810 访问产品不存在
400 9811 标签没有权限访问
400 9812 密钥未配置或过期
400 9813 产品后台配置异常
500 9900 系统异常
500 9901 服务异常
500 9902 渠道异常
500 9903 请求超时