征信查询接口文档

万网中台征信查询接口文档

版本 V1.0

URL：测试环境：http://172.16.10.5:49999/integration/credit
URL：正式环境：https://bcp-api.wwxckj.com/integration/credit 
          
完整地址：URL+请求路径

# 1.个人征信查询

## 单笔查询

| 请求方式  | POST                                     |
|-------|------------------------------------------|
| 请求路径 | /sugar/webApi/pcQueryService/queryReport |
| 编码    | Utf-8                                    |

### 1.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名      | 字段标识        | 字段类型    | 是否必填 | 备注     |
|----------|-------------|---------|------|--------|
| 证件类型     | certtype    | String  | Y    | 查看1.11 |
| 被查询证件号码  | certno      | String  | Y    |        |
| 被查询人姓名   | name        | String  | Y    |        |
| 关联数据业务号  | transactid  | String  | N    |        |
| 查询策略     | qrystrategy | String  | N    |        |
| 档案编号     | archiveid   | Long    | N    |        |
| 客户系统编号   | clientid    | String  | N    |        |
| 客户IP地址   | clientip    | String  | N    |        |
| 信用报告有效天数 | effectday   | Integer | N    |        |
| 授权档案时间   | authdate    |         | N    |        |
| 合作伙伴     | partner     |         | N    |        |
| 产品名称     | proid       |         | N    |        |
| 授权书编号    | customerId  |         | N    |        |

#### 1.11 证件类型代码

| 编码 | 内容 |
| --- | --- |
| 1 | 户口簿 |
| 2 | 护照 |
| 5 | 港澳居民来往内地通行证 |
| 6 | 台湾同胞来往内地通行证 |
| 8 | 外国人居留证 |
| 9 | 警官证 |
| A | 香港身份证 |
| B | 澳门身份证 |
| C | 台湾身份证 |
| X | 其他证件 |
| 10 | 居民身份证及其他以公民身份证号为标识的证件 |

### 1.2 返回响应

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 应用交易流水号	   | serialnumber   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 2.单笔查询PDF结果

| 请求方式  | POST                                         |
|-------|----------------------------------------------|
| 请求路径 | /sugar/webApi/pcQueryService/obtainResultPDF |
| 编码    | Utf-8                                        |

### 2.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 2.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 3.单笔查询JSON结果

| 请求方式  | POST                                          |
|-------|-----------------------------------------------|
| 请求路径 | /sugar/webApi/pcQueryService/obtainResultJSON |
| 编码    | Utf-8                                         |

### 3.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 3.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 4.单笔查询HTML结果

| 请求方式  | POST                                          |
|-------|-----------------------------------------------|
| 请求路径 | /sugar/webApi/pcQueryService/obtainResultHTML |
| 编码    | Utf-8                                         |

### 4.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 4.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 5.单笔查询XML结果

| 请求方式  | POST                                         |
|-------|----------------------------------------------|
| 请求路径 | /sugar/webApi/pcQueryService/obtainResultXML |
| 编码    | Utf-8                                        |

### 5.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 5.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

# 2.企业征信查询

## 单笔查询

| 请求方式  | POST                                     |
|-------|------------------------------------------|
| 请求路径 | /sugar/webApi/bsQueryService/queryReport |
| 编码    | Utf-8                                    |

### 6.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名      | 字段标识        | 字段类型    | 是否必填 | 备注     |
|----------|-------------|---------|------|--------|
| 企业名称     | entName    | String  | Y    |  |
| 企业身份标识类型  | entCertType      | String  | Y    |    查看6.11    |
| 企业身份标识号码   | entCertNum        | String  | Y    |        |
| 档案号  | archiveId  | String  | N    |        |
| 关联数据业务号     | transactId | String  | N    |        |
| 查询策略     | qryStrategy   | Long    | N    |        |
| 客户系统编号   | clientid    | String  | N    |        |
| 有效天数   | effectday    | String  | N    |        |

#### 6.11 身份类型识别码

| 编码 | 内容 |
| --- | --- |
| 01 | 工商注册号 |
| 02 | 机关和事业单位登记号 |
| 03 | 社会团体登记号 |
| 04 | 民办非企业登记号 |
| 05 | 基金会登记号 |
| 06 | 宗教证书登记号 |
| 10 | 中征码 |
| 20 | 统一社会信用代码 |
| 30 | 组织机构代码 |
| 41 | 纳税人识别号(国税) |
| 42 | 纳税人识别号(地税) |

### 6.2 返回响应

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 应用交易流水号	   | serialnumber   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 7.单笔查询PDF结果

| 请求方式  | POST                                         |
|-------|----------------------------------------------|
| 请求路径 | /sugar/webApi/bsQueryService/obtainResultPDF |
| 编码    | Utf-8                                        |

### 7.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 7.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 8.单笔查询JSON结果

| 请求方式  | POST                                          |
|-------|-----------------------------------------------|
| 请求路径 | /sugar/webApi/bsQueryService/obtainResultJSON |
| 编码    | Utf-8                                         |

### 8.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 8.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 9.单笔查询HTML结果

| 请求方式  | POST                                          |
|-------|-----------------------------------------------|
| 请求路径 | /sugar/webApi/bsQueryService/obtainResultHTML |
| 编码    | Utf-8                                         |

### 9.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 9.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |

## 10.单笔查询XML结果

| 请求方式  | POST                                         |
|-------|----------------------------------------------|
| 请求路径 | /sugar/webApi/bsQueryService/obtainResultXML |
| 编码    | Utf-8                                        |

### 10.1 请求参数

| 请求头          | 描述                           |
|--------------|------------------------------|
| Authorization   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company | 必填 UrlEncode(公司名称) 用户所属公司    |
| wwtp-area    | 非必填 UrlEncode(大区) 用户所属大区     |
| wwtp-account | 必填 用户OA账号或手机号                |

Body 参数

| 字段名     | 字段标识         | 字段类型   | 是否必填 |
|---------|--------------|--------|------|
| 应用交易流水号 | serialnumber | String | Y    |
| 客户系统号   | clientid     | String | N    |
| 客户IP地址  | clientip     | String | N    |

### 10.2 返回响应

| 字段名          | 字段标识       | 字段类型   | 是否必填 |
|--------------|------------|--------|------|
| 状态 | code | String | Y    |
| 出错原因    | msg        | String | N    |
| 数据     | data       | Object | Y    |
| 征信信息   | result   | String | N    |
| 错误状态码    | statuscode        | String | N    |
| 数据     | data       | Object | Y    |