saas线索

# 线索接口文档

**日期**：2025-08-01  
**版本**：V1.0  
**修订描述**：创建文档  
**修改人**：何元明  
**审核人**：吴海燕

---

## 接口访问地址说明

**生产访问地址**：`https://bcp-api.wwxckj.com/integration/clue/接口地址`

**测试访问地址**：`http://222.212.141.45:49999/integration/cule/接口地址`

### 请求响应体 data 加解密

将 `encrypt` 数据通过 POST 附加到 URL `data` 参数，需由双方约定一种加密传输方式。

示例：  
`POST /addCrmSaasClueBase`

密文 `type` 参数为指定加密方式：

| 参数值 | 说明         |
|--------|--------------|
| 1      | AES 加解密   |

**Body**：
**channelId 参数说明**：  
`channelId` 由平台方提供。

---

## 1. 添加线索信息

### 基本信息

- **接口地址**：`/saveCrmSaasClueBase`
- **请求方式**：POST

### 请求参数

**请求体参数 (Body)**：

| 参数名称          | 参数说明                     | 是否必须 | 数据类型   | 示例值                                   |
|-------------------|------------------------------|----------|------------|------------------------------------------|
| clueName          | 线索名称                     | 是       | string     | "示例线索"                               |
| clueCode        | 线索来源（由豆秒提供）       | 是       | String    | 1                                        |
| province          | 省                           | 否       | string     | "四川省"                                 |
| city              | 市                           | 否       | string     | "成都市"                                 |
| region            | 区                           | 否       | string     | "武侯区"                                 |
| address           | 地址                         | 否       | string     | "天府大道100号"                          |                         
| clueDescription   | 线索描述                     | 是       | string     | "这是一个示例线索描述"                   |
| contactName       | 联系人姓名                   | 否       | string     | "张三"                                   |
| contactPhone      | 联系人电话                   | 是       | string     | "13800138000"                            |
| remake            | 备注                         | 否       | string     | "备注信息"                               |
| jsonField         | 特殊字段                     | 否       | json       | `{"creditCode":"123456789"}`             |

**请求示例**：
json

{

"clueName": "示例线索",

"clueCode": 1,

"province": "四川省",

"city": "成都市",

"region": "武侯区",

"address": "天府大道100号",

"clueDescription": "这是一个示例线索描述",

"contactName": "张三",

"contactPhone": "13800138000",

"remake": "备注信息",

"jsonField": "{"creditCode":"123456789","certificateNum":"510123199001011234"}"

}
### 响应状态

| 状态码 | 说明         |
|--------|--------------|
| 200    | OK           |

### 响应参数

| 参数名称 | 参数说明               | 数据类型   | 示例值       | 备注                                   |
|----------|------------------------|------------|--------------|----------------------------------------|
| code     | 状态码                 | integer    | 0            | 0:请求成功，1000:请求失败              |
| data     | 返回数据               | object     |              |                                        |
| clueId   | 线索编号               | string     | "1"          | 由渠道方存储，后续用于查询或更新       |
| message  | 消息                   | string     | "success"    |                                        |
| errorMsg | 错误信息               | string     | ""           | 对异常信息描述                         |

**响应示例（成功）**：

---

## 2. 线索信息状态回调

### 基本信息

- **接口地址**：`/saasCallback`
- **请求方式**：POST

### 请求参数

| 字段名称 | 类型   | 必填 | 格式 | 说明               |
|----------|--------|------|------|--------------------|
| clueId   | String | 是   |      | 全局唯一线索标识   |
**字段说明**：

**statusChangeList 元素字段**：

| 字段名称     | 类型   | 说明                         | 格式                     |
| clueId         | String | 原始线索ID                   |                          |
|--------------|--------|------------------------------|--------------------------|
| clueStatusId | String | 状态变更记录唯一标识         | 格式：线索ID_序号        |
| code         | String | 状态编码（见状态码表）       |                          |
| desc         | String | 状态描述                     |                          |
| reason       | String | 拒绝原因（仅拒绝状态需要）   |                          |
| statusTime   | String | 状态变更时间                 | yyyy-MM-dd HH:mm:ss      |
| ApplyAmount  | String | 申请金额（单位：元）         |                          |
| loanAmount   | String | 实际放款金额                 |                          |
| loanTime     | String | 资金到账时间                 |                          |
| loanPeriods  | Int    | 分期总数                     |                          |
| loanOrderId  | String | 放款订单号                   |                          |

---

**请求参数示例**：
json

{

"code": 0,

"msg": "success",

"data": {

"clueId": "CLUE202311010001",

"clueStatusId": "CLUE202311010001_001",

"code": 2000,

"desc": "预审通过",

"statusTime": "2023-11-01 14:15:00"

},

}

}
**未成功接收到线索情况**：
json

{

"code": 4041,

"msg": "线索不存在"

}

## 3. 线索信息查询接口

### 基本信息

- **接口地址**：`/saasClueById`
- **请求方式**：POST

### 请求参数

| 字段名称 | 类型   | 必填 | 格式 | 说明               |
|----------|--------|------|------|--------------------|
| clueId   | String | 是   | 56   | 全局唯一线索标识   |

**响应参数示例**：
**响应参数**：

| 参数名称        | 参数说明                     | 是否必须 | 数据类型   | 示例值                                   |
|-----------------|------------------------------|----------|------------|------------------------------------------|
| clueName        | 线索名称                     | 是       | string     | "示例线索"                               |
| clueCode      | 线索来源（由豆秒提供）       | 是       | integer    | 1                                        |
| province        | 省                           | 否       | string     | "四川省"                                 |
| city            | 市                           | 否       | string     | "成都市"                                 |
| region          | 区                           | 否       | string     | "武侯区"                                 |
| address         | 地址                         | 否       | string     | "天府大道100号"                          |                               |
| clueDescription | 线索描述                     | 是       | string     | "这是一个示例线索描述"                   |
| contactName     | 联系人姓名                   | 否       | string     | "张三"                                   |
| contactPhone    | 联系人电话                   | 是       | string     | "13800138000"                            |
| remake          | 备注                         | 否       | string     | "备注信息"                               |
| jsonField       | 特殊字段                     | 否       | json       | `{"creditCode":"123456789"}`             |

---

## 状态码规范表

| 状态     | 状态码 | 状态名称       | 生命周期阶段 |
|----------|--------|----------------|--------------|
| 1000     | 1000   | 线索初始化     | 线索期       |
| 100X     | 1001   | 电话未接通     | 跟进期       |
|          | 1002   | 客户无意向     |              |
|          | 1003   | 客户有意向     |              |
| 200X     | 2000   | 预审通过       | 审批期       |
|          | 2001   | 预审拒绝       |              |
| 300X     | 3001   | 终审通过       | 合同期       |
|          | 3002   | 终审拒绝       |              |
| 400X     | 4000   | 合同生效       | 履约期       |
|          | 4001   | 放款成功       |              |
|          | 4002   | 放款失败       |              |

json

{

"clueName": "示例线索",

"clueCode": 1,

"province": "四川省",

"city": "成都市",

"region": "武侯区",

"address": "天府大道100号",

"clueDescription": "这是一个示例线索描述",

"contactName": "张三",

"contactPhone": "13800138000",

"remake": "备注信息",

"jsonField": "{"creditCode":"123456789","certificateNum":"510123199001011234"}"

}