客户管理
<p><strong>简要描述：</strong> </p>
<ul>
<li>1.1客户管理接口
1.1.1客户管理列表接口地址:</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>192.168.112.75:8080/common/orderCustomer/getOrderCustomerList</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户姓名</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机号码</td>
</tr>
<tr>
<td style="text-align: left;">pageNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>分页参数第几页</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>分页参数每页多少条</td>
</tr>
<tr>
<td style="text-align: left;">accessToken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录token</td>
</tr>
</tbody>
</table>
<p><strong>响应参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户姓名</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手机号码</td>
</tr>
<tr>
<td style="text-align: left;">source</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>渠道来源</td>
</tr>
<tr>
<td style="text-align: left;">creatTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">states</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>状态</td>
</tr>
</tbody>
</table>
<p><strong>返回json示例</strong></p>
<pre><code>{
"resultMsg":"OK",
"resultCode":200,
"resultInfo":[
{
"cluesId":19383,
"customerNumber":"20191217191229336T8UDU",
"sapCustomerNumber":"",
"customerName":"窝窝推荐用户",
"cusomerAge":"",
"fixedTelephone":"18210525140",
"customerPhone":"18210525140",
"customerLevel":"",
"customerIntention":"",
"source":"公司资源",
"sourceDetail":"",
"specialCustomers":"",
"specialCustomerDescription":null,
"founder":"罗建鹏",
"creatTime":"2019-12-17 19:12:29",
"customerService":"罗建鹏",
"consumerHotline":"18210525140",
"department":"抟多多渠道部",
"states":"0",
"smark":"",
"beginTime":null,
"endTime":null,
"customerLevelCode":null,
"customerIntentionCode":null,
"cusomerAgeCode":null,
"founderId":"e3cef7e25c55429b93a2ca27405fc7f3",
"departmentCode":"10401",
"businessDepartment":"抟多多渠道部",
"businessDepartmentCode":"10401",
"data":null,
"state":null,
"fChanneluserID":"d414af7120184dceb68ece93e2a492bc",
"customerUuid":"19cf052f-a1b8-4e85-b636-f9def86bdab4",
"houseid":null,
"location":null,
"room":null,
"hall":null,
"kitchen":null,
"toilet":null,
"costmealmoney":null,
"checkboxfalg":null,
"starttimedaydate":null,
"chargearea":null,
"houseuuid":null,
"ccCount":1,
"timeToShop":"2019-12-17 19:20:25",
"visitCount":1,
"beginTimeToShop":null,
"endTimeToShop":null,
"deposit":0,
"directSign":0,
"channelSources":null,
"communicateRecord":"",
"meetingTime":null,
"beginMeetingTime":null,
"endMeetingTime":null,
"meetingCount":null,
"huxingSplicing":null,
"contractDuration":null,
"canneluuid":null,
"channelname":null,
"channelphone":null,
"orderTime":null,
"orderBeginTime":null,
"orderEndTime":null,
"customerSource":null,
"endtimedaydate":null,
"identification":null,
"pactnumber":null,
"sourceCode":null,
"comHousessList":null,
"crmCommunicateRecordsList":null
}
],
"page":{
"pageNo":1,
"pageSize":10,
"totalCount":1,
"start":0,
"totalPage":1
},
"ext":null
}</code></pre>
<p>1.1.2客户管理新增/编辑保存接口地址:</p>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>192.168.112.75:8080/common/orderCustomer/operationOrderCustomer</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cluesId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户ID（编辑保存时必传）</td>
</tr>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户姓名</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户手机号</td>
</tr>
<tr>
<td style="text-align: left;">deposit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>定金预收</td>
</tr>
<tr>
<td style="text-align: left;">directSign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>直签预收</td>
</tr>
<tr>
<td style="text-align: left;">cusomerAge</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>年龄name</td>
</tr>
<tr>
<td style="text-align: left;">cusomerAgeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>年龄code</td>
</tr>
<tr>
<td style="text-align: left;">customerIntention</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户意向</td>
</tr>
<tr>
<td style="text-align: left;">customerIntentionCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户意向code</td>
</tr>
<tr>
<td style="text-align: left;">states</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>状态（默认传0）</td>
</tr>
<tr>
<td style="text-align: left;">accessToken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录token</td>
</tr>
</tbody>
</table>
<p><strong>响应参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<p><strong>返回json示例</strong></p>
<pre><code>"resultMsg":"OK",
"resultCode":200,
"resultInfo":{
"cluesId":19384,
"customerNumber":"20191219150812339LCYQV",
"sapCustomerNumber":null,
"customerName":"测试客户",
"cusomerAge":"20 ~ 25岁"
},
"page":null,
"ext":null</code></pre>
<p>1.1.3客户管理年龄，客户意向下拉接口地址:</p>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>192.168.112.75:8080/common/sysDictionary/getCodeValueByTypeList</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">typeList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>年龄传：age，客户意向传：customerIntention</td>
</tr>
<tr>
<td style="text-align: left;">accessToken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录token</td>
</tr>
</tbody>
</table>
<p><strong>响应参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<p><strong>返回json示例</strong></p>
<pre><code>{
"resultMsg":"OK",
"resultCode":200,
"resultInfo":{
"customerIntention":[
{
"code":1,
"name":"意向客户",
"description":"客户意向"
},
{
"code":2,
"name":"订金客户",
"description":"客户意向"
},
{
"code":3,
"name":"签单客户",
"description":"客户意向"
},
{
"code":4,
"name":"无效客户",
"description":"客户意向"
},
{
"code":5,
"name":"放弃客户",
"description":"客户意向"
}
],
"age":[
{
"code":1,
"name":"20岁以下",
"description":"年龄"
},
{
"code":2,
"name":"20 ~ 25岁",
"description":"年龄"
},
{
"code":3,
"name":"25 ~ 30岁",
"description":"年龄"
},
{
"code":4,
"name":"30 ~ 40岁",
"description":"年龄"
},
{
"code":5,
"name":"40 ~ 50岁",
"description":"年龄"
},
{
"code":6,
"name":"50岁以上",
"description":"年龄"
},
{
"code":7,
"name":"未知",
"description":"年龄"
}
]
},
"page":null,
"ext":null
}</code></pre>
<p>1.1.4客户管理查看回显接口地址:</p>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>192.168.112.75:8080/common/orderCustomer/detailOrderCustomer</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cluesId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户ID（编辑保存时必传）</td>
</tr>
<tr>
<td style="text-align: left;">accessToken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录token</td>
</tr>
</tbody>
</table>
<p><strong>响应参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">客户信息</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户姓名</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户手机号</td>
</tr>
<tr>
<td style="text-align: left;">deposit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>定金预收</td>
</tr>
<tr>
<td style="text-align: left;">directSign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>直签预收</td>
</tr>
<tr>
<td style="text-align: left;">cusomerAge</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>年龄name</td>
</tr>
<tr>
<td style="text-align: left;">customerIntention</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户意向</td>
</tr>
<tr>
<td style="text-align: left;">房屋信息</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">comHousessList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>房屋列表</td>
</tr>
<tr>
<td style="text-align: left;">location</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>房屋名称</td>
</tr>
<tr>
<td style="text-align: left;">沟通记录</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">crmCommunicateRecordsList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>房屋列表</td>
</tr>
<tr>
<td style="text-align: left;">communicateRecord</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>沟通内容</td>
</tr>
<tr>
<td style="text-align: left;">其他</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">founder</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设计师</td>
</tr>
<tr>
<td style="text-align: left;">creatTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>创建时间</td>
</tr>
</tbody>
</table>
<p><strong>返回json示例</strong></p>
<pre><code>{
"resultMsg":"OK",
"resultCode":200,
"resultInfo":{
"cluesId":19381,
"customerNumber":"201912171033148572JSPI",
"sapCustomerNumber":"",
"customerName":"321",
"cusomerAge":"",
"fixedTelephone":"18267179832",
"customerPhone":"18516995323",
"customerLevel":"",
"customerIntention":"",
"source":"",
"sourceDetail":"",
"specialCustomers":"",
"specialCustomerDescription":null,
"founder":"金晓静",
"creatTime":"2019-12-17 10:33:14",
"customerService":"金晓静",
"consumerHotline":"18267179832",
"department":"马甸设计三部",
"states":"0",
"smark":"",
"beginTime":null,
"endTime":null,
"customerLevelCode":null,
"customerIntentionCode":"1",
"cusomerAgeCode":null,
"founderId":"ff32668b899a4415b432eb61b32efcb0",
"departmentCode":"100020912",
"businessDepartment":"马甸设计三部",
"businessDepartmentCode":"100020912",
"data":null,
"state":null,
"fChanneluserID":"fae30e5d5dfb4b2cac9870cf4f7b9824",
"customerUuid":"674598a1-a9d1-4d08-a078-49a96f2cb1e2",
"houseid":null,
"location":null,
"room":null,
"hall":null,
"kitchen":null,
"toilet":null,
"costmealmoney":null,
"checkboxfalg":null,
"starttimedaydate":null,
"chargearea":null,
"houseuuid":null,
"ccCount":null,
"timeToShop":null,
"visitCount":0,
"beginTimeToShop":null,
"endTimeToShop":null,
"deposit":0,
"directSign":0,
"channelSources":null,
"communicateRecord":null,
"meetingTime":null,
"beginMeetingTime":null,
"endMeetingTime":null,
"meetingCount":null,
"huxingSplicing":null,
"contractDuration":null,
"canneluuid":null,
"channelname":null,
"channelphone":null,
"orderTime":null,
"orderBeginTime":null,
"orderEndTime":null,
"customerSource":null,
"endtimedaydate":null,
"identification":null,
"pactnumber":null,
"sourceCode":null,
"comHousessList":[
{
"houseId":19433,
"addressId":36222,
"customerId":19381,
"clueId":null,
"provinceCode":"1",
"cityCode":"10",
"districtCode":"1001",
"provinceName":"北京市",
"cityName":"北京市",
"districtName":"东城区",
"location":"北京市西城区黄市大街北广大厦",
"buildingAddr":null,
"doorNumber":null,
"businessArea":null,
"longitude":null,
"latitude":null,
"houseState":0,
"houseShape":null,
"deliveryHouseTime":null,
"builtTime":null,
"houseType":null,
"builtType":null,
"floorType":null,
"belongFloor":null,
"elevatorState":null,
"floorArea":null,
"actualArea":null,
"room":null,
"hall":null,
"kitchen":null,
"toilet":null,
"balcony":null,
"passageway":null,
"yard":null,
"remarks":null,
"deleteFlag":0,
"updateTime":"2019-12-17 16:03:50.0",
"createTime":null,
"drawing":null,
"fpId":null,
"designId":null,
"customerName":"321",
"customerPhone":"18516995323",
"department":"马甸设计三部",
"departmentCode":"100020912",
"founder":"金晓静",
"founderId":"ff32668b899a4415b432eb61b32efcb0",
"transferOrderTime":null,
"state":"0",
"thereIsNoElevator":null,
"decorationStyle":null,
"decorationBudget":null,
"channelExecutive":null,
"whetherToTransferOrders":"0",
"comAddresses":null,
"crmCustomer":null,
"beginTime":null,
"endTime":null,
"huxingSplicing":null,
"orderId":null,
"data":null,
"states":0,
"houseUuid":"7dc4ebb4-e85a-4eda-9328-f0ad76c4885e",
"source1Code":"1",
"source2Code":"11",
"source3Code":"1102",
"source1":"渠道派单",
"source2":"展会",
"source3":"华夏家博会",
"channel":{
"id":"b50e66df-f741-4f46-8ca5-c5aa7fa3c8e8",
"remarks":null,
"createDate":1576512000000,
"updateDate":1576549994000,
"tddCode":null,
"isInputWeChat":null,
"weChatAccount":null,
"sourceLevel":null,
"userName":"123",
"phone":"18516995323",
"phone2":null,
"source1Code":"1",
"source2Code":"11",
"source3Code":"1102",
"source1":"渠道派单",
"source2":"展会",
"source3":"华夏家博会",
"userLevel":"A",
"deposit":123,
"directSign":0,
"houseStatus":"0",
"houseType":"0",
"location1Code":"1",
"location2Code":"10",
"location3Code":"1001",
"location1":"北京市",
"location2":"北京市",
"location3":"东城区",
"address":"北京市西城区黄市大街北广大厦",
"area":null,
"designerDeptCode":"100020912",
"designerId":"ff32668b899a4415b432eb61b32efcb0",
"designerDeptName":"马甸设计三部",
"designerName":"金晓静",
"expectDesignerDeptCode":"100020912",
"expectDesignerId":"ff32668b899a4415b432eb61b32efcb0",
"expectDesignerDeptName":null,
"expectDesignerName":null,
"distributeStatus":"1",
"userStatus":"0",
"userCode":"fae30e5d5dfb4b2cac9870cf4f7b9824",
"channelUuid":"2f160f94-2524-4886-b43f-aeb9e8a84c38",
"houseId":19433,
"salesmanId":"ff32668b899a4415b432eb61b32efcb0",
"salesmanName":"金晓静",
"salesmanDeptCode":"100020912",
"salesmanDeptName":"马甸设计三部",
"salesmanPhone":"18267179832",
"isReward":"0",
"dataMessage":null,
"param":null,
"xStatus":null,
"str":null,
"channelcommunicaterecorddto":{
"id":null,
"remarks":null,
"createDate":null,
"updateDate":null,
"userCode":null,
"communicateResult":null,
"expectToshopTime":null,
"nextVisitTime":null,
"communicateContext":null,
"invalidReason":null,
"checkedCompany":null,
"createName":null,
"updateDateTime":"",
"createDateTime":""
},
"lastReturnVisit":null,
"lastCommunicateContext":null,
"distributeTime":null,
"nextVisitTime":null,
"expectToshopTime":null,
"expectToTransferTime":null,
"isMeet":null,
"timeToShop":null,
"visitCount":null,
"beginDatetimeToShop":null,
"endDatetimeToShop":null,
"beginDatenextVisitTime":null,
"endDatenextVisitTime":null,
"beginDateexpectToshopTime":null,
"endDateexpectToshopTime":null,
"beginDateCreate":null,
"endDateCreate":null,
"finishState":null,
"finishStateName":null,
"orderId":null,
"contractNumber":null,
"orderAmount":null,
"amountPrices":null,
"proportionReceived":null,
"setName":null,
"setCode":null,
"customerName":null,
"customerPhone":null,
"updateDateTime":"2019-12-17 10:33:14",
"createDateTime":"2019-12-17 00:00:00",
"isTodayNeed":null
},
"isChannel":"1",
"decorationDemands":null
}
],
"crmCommunicateRecordsList":[
{
"communicateId":5163,
"communicateRecord":"给第三方",
"createrName":"系统管理员",
"createrId":"1",
"customerId":19381,
"customerNumber":"",
"clueId":null,
"creatTime":null,
"visited":"1",
"visitTime":"2019-12-18 00:00:00",
"nextVisitTime":"2019-12-19 00:00:00.0",
"communicationTime":"2019-12-18 16:15:02",
"customerName":"",
"cellphoneNumber":"",
"location":"",
"storefront":"信息技术中心",
"storefrontCode":"10003",
"beginTime":null,
"endTime":null,
"crmCustomer":null,
"state":1,
"expectToTransferTime":null,
"data":null,
"comAddresses":null
},
{
"communicateId":5162,
"communicateRecord":"奥术大师",
"createrName":"系统管理员",
"createrId":"1",
"customerId":19381,
"customerNumber":"",
"clueId":null,
"creatTime":null,
"visited":"1",
"visitTime":"2019-12-17 00:00:00",
"nextVisitTime":"2019-12-18 00:00:00.0",
"communicationTime":"2019-12-17 16:14:38",
"customerName":"",
"cellphoneNumber":"",
"location":"",
"storefront":"信息技术中心",
"storefrontCode":"10003",
"beginTime":null,
"endTime":null,
"crmCustomer":null,
"state":1,
"expectToTransferTime":null,
"data":null,
"comAddresses":null
}
]
},
"page":null,
"ext":null
}</code></pre>