预审相关接口文档

# 接口地址

Base URLs:

- <a href="http://172.16.10.5:49999">测试环境: http://172.16.10.5:49999</a>
- <a href="https://bcp-api.wwxckj.com">生产环境: https://bcp-api.wwxckj.com</a>

## POST 发起预审

POST /integration/credit/sugar/webApi/bigDataService/netCredit

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| Authorization | header | String | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | String | 否   | 用户所属公司 |
| wwtp-account  | header | String | 否   | 用户OA账号或手机号 |
| channel          | body   | String | 是   | 渠道标识 |
| creditType          | body   | String | 是   | 大数据征信类型 |
| dealersName          | body   | String | 否   | 车商名称 |
| outsideOrderId          | body   | String | 是   | 三方订单唯一标识 |
| personList          | body   | Array | 是   | 个人信息 |
| personList.attach          | body   | Object | 是   | 附件 |
| personList.attach.licenceBackUrl          | body   | String | 是   | 身份证正面 |
| personList.attach.licenceFrontUrl          | body   | String | 是   | 身份证反面 |
| personList.certificateNum          | body   | String | 是   | 身份证号码 |
| personList.contactPhone          | body   | String | 是   | 电话号码 |
| personList.custName          | body   | String | 是   | 名称 |
| personList.personType          | body   | Integer | 是   | 1 查询类型 1、主借人 2、担保人 渠道传1 |
| socialCreditCode          | body   | String | 是   | 渠道下调用方标识 |

> Body 参数示例

```json
{
  "channel": "CHEXIAOGE",
  "creditType": "6",
  "dealersName": "安徽卡泰驰琪琪优车汽车科技有限公司",
  "outsideOrderId": "CR202503120000021741758025884",
  "personList": [
    {
      "attach": {
        "licenceBackUrl": "http://cxg.chexiaoge.com/cxg_master/2025/4/23/AD8yv1_%E8%BA%AB%E4%BB%BD%E8%AF%81%202024-11-18%2020.27_2.jpg",
        "licenceFrontUrl": "http://cxg.chexiaoge.com/cxg_master/2025/4/23/ttc2Zu_%E8%BA%AB%E4%BB%BD%E8%AF%81%202024-11-18%2020.27_1.jpg"
      },
      "certificateNum": "511025199608286174",
      "contactPhone": "16602832002",
      "custName": "陈朝良",
      "personType": 1
    }
  ],
  "socialCreditCode": "91340111MAD4MW2T1F"
}
```
### 响应参数

| 名称          | 类型    | 说明 |
| ------------- |  ------  | ---- |
| outsideOrderId | String | 外部单号 |
| querySn | String | 查询编号 |
| idCard | String | 身份证号 |
| phone | String | 电话 |
| name | String | 姓名 |
| licenceFrontUrl | String | 身份证正面照片 |
| licenceBackUrl | String | 身份证反面照片 |
| customerLevel | String | 客户等级 |
| pretrialStatus | String | 预审状态 |
| personReport | String | 个人报告 |
| platformData | String | 平台数据 |
| errReason | String | 错误原因 |
| contractUrl | String | 签约链接 |
> 返回示例

```json
{
    "code": 0,
    "msg": null,
    "data": {
        "outsideOrderId": "CR202503120000021741758025884",
        "querySn": "ZX2025102942055",
        "idCard": "511025199608286174",
        "phone": "16602832002",
        "name": "陈朝良",
        "licenceFrontUrl": null,
        "licenceBackUrl": null,
        "customerLevel": null,
        "pretrialStatus": null,
        "personReport": null,
        "platformData": null,
        "errReason": null,
        "contractUrl": "https://contract-test.wwxckj.com/sign?signLinkId=1983427511380934657"
    },
    "ok": true
}
```
## GET 征信结果查询

GET /integration/credit/sugar/webApi/bigDataService/resultQuery

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| querySn  | query | string | 是   | 查询编号 |
| Authorization | header | string | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | string | 否   | 用户所属公司 |
| wwtp-account  | header | string | 否   | 用户OA账号或手机号 |

### 响应参数

| 名称          | 类型    | 说明 |
| ------------- |  ------  | ---- |
| outsideOrderId | String | 外部单号 |
| querySn | String | 征信编号 |
| idCard | String | 身份证号 |
| phone | String | 客户手机号 |
| name | String | 客户姓名 |
| licenceFrontUrl | String | 身份证正面url |
| licenceBackUrl | String | 身份证背面url |
| customerLevel | String | 客户级别 |
| pretrialStatus | String | 预审报告结果0-未通过 、 1-通过 |
| personReport | String | 个人评级报告-其他信息 |
| errReason | String | 异常原因 |
| contractUrl | String | 签约链接 |
| platformData | Array | 资方推荐 |
| platformData.id | String | 资方id capitalInfo表的id |
| platformData.platform | String | 资方名称 |
| platformData.saasPlatformCode | String | 资方code |
| platformData.saasPlatformName | String | 资方产品 |
| platformData.saasPlatformLabelId | String | 产品标签id |

> 返回示例
```json
{
    "code": 0,
    "msg": null,
    "data": {
        "outsideOrderId": "CR25110406003",
        "querySn": "ZX2025110448009",
        "idCard": "511622199502286452",
        "phone": "15775858997",
        "name": "张帅",
        "licenceFrontUrl": "http://saas-obs-dev.wwuche.com/PreLoan/2025/11/04/1985519536671080449/251104092841762_cd039250-1524-49c9-980b-73a318481831.jpg",
        "licenceBackUrl": "http://saas-obs-dev.wwuche.com/PreLoan/2025/11/04/1985519536671080449/251104092842507_d7d73932-b2e4-4fad-8eb8-9e5a17751b0a.jpg",
        "customerLevel": "C",
        "pretrialStatus": 1,
        "personReport": "{otherInfo={dishonesty=是, exposurePlatform=否, court=是, closeCase=否}, prequalificationResult=通过, desc=优}",
        "platformData": [
            {
                "id": "79",
                "platform": "铭行",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "78",
                "platform": "苏银金融租赁股份有限公司",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "12",
                "platform": "广西通盛融资租赁有限公司",
                "saasPlatformCode": "TONGSHENG",
                "saasPlatformName": "广西通盛",
                "saasPlatformLabelId": "132"
            },
            {
                "id": "26",
                "platform": "国银金融租赁股份有限公司",
                "saasPlatformCode": "GUO_YIN",
                "saasPlatformName": "国银金租",
                "saasPlatformLabelId": "130"
            },
            {
                "id": "28",
                "platform": "中铁建金融租赁有限公司",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "64",
                "platform": "华夏金融租赁有限公司",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "37",
                "platform": "民生金融租赁股份有限公司",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "2",
                "platform": "上海众慧融资租赁有限公司",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "89",
                "platform": "九江银行",
                "saasPlatformCode": "ZTJ",
                "saasPlatformName": "中铁金租",
                "saasPlatformLabelId": "131"
            },
            {
                "id": "30",
                "platform": "中国工商银行股份有限公司三亚分行",
                "saasPlatformCode": "E_NEW",
                "saasPlatformName": "工行平台",
                "saasPlatformLabelId": "129"
            },
            {
                "id": "16",
                "platform": "中国工商银行股份有限公司海南省分行营业部",
                "saasPlatformCode": "E_NEW",
                "saasPlatformName": "工行平台",
                "saasPlatformLabelId": "129"
            },
            {
                "id": "32",
                "platform": "中国工商银行股份有限公司海口江东支行",
                "saasPlatformCode": "E_NEW",
                "saasPlatformName": "工行平台",
                "saasPlatformLabelId": "129"
            }
        ],
        "errReason": null,
        "contractUrl": null
    },
    "ok": true
}
```

## GET 征信结果补推

GET /integration/credit/sugar/webApi/bigDataService/pushOutside

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| querySn  | query | string | 是   | 查询编号 |
| Authorization | header | string | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | string | 否   | 用户所属公司 |
| wwtp-account  | header | string | 否   | 用户OA账号或手机号 |

> 返回示例

```json
{
    "code": 0,
    "msg": null,
    "data": true,
    "ok": true
}
```

## POST 授权书签约回调, 签约结果推送

POST /integration/credit/sugar/webApi/bigDataService/pretrialResult

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| Authorization | header | String | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | String | 否   | 用户所属公司 |
| wwtp-account  | header | String | 否   | 用户OA账号或手机号 |
| customerLevel          | body   | String | 是   | 客户级别 |
| idCard          | body   | String | 是   | 身份证号 |
| licenceBackUrl          | body   | String | 是   | 身份证背面url |
| licenceFrontUrl          | body   | String | 是   | 身份证正面url |
| name          | body   | String | 是   | 客户姓名 |
| outsideOrderId          | body   | String | 是   | 三方订单id |
| personReport          | body   | String | 是   | 个人评级报告-其他信息 |
| phone          | body   | String | 是   | 手机号 |
| platformData          | body   | Array | 是   | 资方推荐 |
| platformData.id          | body   | String | 是   | 资方id |
| platformData.platform          | body   | String | 是   | 资方名称 |
| platformData.saasPlatformCode          | body   | String | 是   | 资方code |
| platformData.saasPlatformLabelId          | body   | String | 是   | 产品标签id |
| platformData.saasPlatformName         | body   | String | 是   | 资方产品 |
| pretrialStatus         | body   | Integer | 是   | 预审报告结果0-未通过 、 1-通过 |
| querySn         | body   | String | 是   | 征信编码 |

> Body 参数示例

```json
{
  "customerLevel": "C",
  "idCard": "342622199802182160",
  "licenceBackUrl": "https://saas-obs.wwuche.com/PreLoan/2025/10/28/1983035308004421634/251028125715250_bf7414ce-b4c5-48f6-a272-8b8c0f38bb6d.jpg",
  "licenceFrontUrl": "https://saas-obs.wwuche.com/PreLoan/2025/10/28/1983035308004421634/251028125715147_6282c792-3e89-4137-b82c-efe2f138b730.jpg",
  "name": "钱海燕",
  "outsideOrderId": "CR25102806064",
  "personReport": "{\"prequalificationResult\":\"通过\",\"desc\":\"次\",\"cardFinalLevel\":\"D1\",\"pricingProduct\":\"畅享\",\"pricingProductDesc\":\"畅享(D1)\",\"otherInfo\":{\"court\":\"否\",\"dishonesty\":\"否\",\"exposurePlatform\":\"否\",\"closeCase\":\"否\"}}",
  "phone": "15155160030",
  "platformData": [
    {
      "id": "28",
      "platform": "中铁建金融租赁有限公司",
      "saasPlatformCode": "ZTJ",
      "saasPlatformLabelId": "131",
      "saasPlatformName": "中铁金租"
    },
    {
      "id": "64",
      "platform": "华夏金融租赁有限公司",
      "saasPlatformCode": "ZTJ",
      "saasPlatformLabelId": "131",
      "saasPlatformName": "中铁金租"
    }
  ],
  "pretrialStatus": 1,
  "querySn": "ZX2025102894201"
}
```

> 返回示例

```json
{
  "code": 0,
  "msg": "string",
  "data": null,
  "ok": true
}
```

## POST 大数据结果回调, 网络征信结果推送

POST /integration/credit/sugar/webApi/bigDataService/signed

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| Authorization | header | String | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | String | 否   | 用户所属公司 |
| wwtp-account  | header | String | 否   | 用户OA账号或手机号 |
| message          | body   | String | 是   | 签约短信下发内容 / 错误信息 |
| outsideOrderId          | body   | String | 是   | 	三方订单id |
| querySn          | body   | String | 是   | 	征信编码 |
| reuseFlag          | body   | Integer | 是   | 	大数据授权书是否复用：0-否、1-是 |
| time          | body   | Integer | 是   | 	签约完成时间 |
| type          | body   | Integer | 是   | 	回调类型 0-授权书签约完成时间 * 1-人行报告发起时间 * 2-人行报告拉取成功时间 * 3-大数据结果返回时间 |
| typeDesc          | body   | String | 是   | 		回调类型描述 |

> Body 参数示例

```json
{
  "message": "钱海燕 先生/女士：您申请的大数据征信查询订单已发起，请您按要求完成电子合同签约，点击 http://t.wwvas.com/s/DXojhV 立即进入签约过程",
  "outsideOrderId": "CR25102806064",
  "querySn": "ZX2025102894201",
  "reuseFlag": 0,
  "time": 1761629299039,
  "type": 2,
  "typeDesc": "人行报告拉取成功时间"
}
```

> 返回示例

```json
{
  "code": 0,
  "msg": "string",
  "data": null,
  "ok": true
}
```

## POST 授权书签约回调 , 异常信息同步

POST /integration/credit/sugar/webApi/bigDataService/errorSync

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| Authorization | header | String | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | String | 否   | 用户所属公司 |
| wwtp-account  | header | String | 否   | 用户OA账号或手机号 |
| message          | body   | String | 是   | 签约短信下发内容 / 错误信息 |
| outsideOrderId          | body   | String | 是   | 三方订单id |
| querySn          | body   | String | 是   | 征信编码 |

> Body 参数示例

```json
{
  "message": "主体不存在,主体不存在",
  "outsideOrderId": "CR25102706064",
  "querySn": "ZX2025102794067"
}
```

> 返回示例

```json
{
  "code": 0,
  "msg": "string",
  "data": null,
  "ok": true
}
```

## POST 授权书签约链接转换为小程序分享码

POST /integration/credit/sugar/webApi/bigDataService/wechatShare

### 请求参数

| 名称          | 位置   | 类型   | 必填 | 说明 |
| ------------- | ------ | ------ | ---- | ---- |
| Authorization | header | String | 是   | Bearer Token 通过万网中台 客户端模式获取 |
| wwtp-company  | header | String | 否   | 用户所属公司 |
| wwtp-account  | header | String | 否   | 用户OA账号或手机号 |
| contractUrl          | body   | String | 是   | 签约链接 |
| markId          | body   | String | 是   | 征信批次id |
| querySn          | body   | String | 是   | 征信编码 |
| wechatShareUrl          | body   | String | 是   | 签约链接小程序分享码 |

> Body 请求参数

```json
{
  "contractUrl": "https://contract.wwxckj.com/sign?signLinkId=1983048066665594882",
  "markId": "MK2025102891252",
  "querySn": "ZX2025102893186",
  "wechatShareUrl": "https://saas-obs.wwuche.com/PreLoan/2025/10/28/1983048053066665986/251028134757821_credit_net_sign_wechat"
}
```

> 返回示例

```json
{
  "code": 0,
  "msg": "string",
  "data": null,
  "ok": true
}
```