客源OpenApi
客源OpenApi
1、搜索客源
BASIC
Path: /customer/main/searchCustomer
Method: POST
Desc:
PATH前缀：/api/jediopenplatformopenapi
REQUEST
Headers:
| name | value | required | desc |
|---|---|---|---|
| Content-Type | application/json;charset=UTF-8 | YES |
入参字段:
| name | value | required | type | desc |
|---|---|---|---|---|
| param.searchCustomerOpenDTO.lastUpdatedStartDate | YES | text | 最后更新区间开始时间 | |
| param.searchCustomerOpenDTO.lastUpdatedEndDate | YES | text | 最后更新区间结束时间 | |
| param.pageDTO.pageSize | YES | text | ||
| param.pageDTO.pageNum | YES | text | ||
| param.pageDTO.sortBy | NO | text | 可选值：createdTime，updatedTime | |
| param.pageDTO.desc | NO | text | 可选值：desc，asc |
{
"param": {
"pageDTO": {
"desc": "desc",
"pageNum": 1,
"pageSize": 10,
"sortBy": "updatedTime"
},
"searchCustomerOpenDTO": {
"lastUpdatedStartDate": 31507200000,
"lastUpdatedEndDate": 1741831370978
}
}
}
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | object | |
| |─list | array | |
| |─ | object | |
| |─contactStatusDTOList | array | 经纪人和客源的联系情况 |
| |─ | object | |
| |─customerUuid | string | |
| |─empUuid | string | |
| |─deptUuid | string | |
| |─contactTime | string | |
| |─publicBrowsedNum | integer | 公客被查看人数 |
| |─publicContactedNum | integer | 公客被联系人数 |
| |─thirtyDaysPublicContactedNum | integer | 公客被联系人数（近30日） |
| |─qualityLabel | string | 质量标签（low：低质量, high：高质量） |
| |─cooperatorFlag | boolean | 是不是合作客 |
| |─privateActiveFlag | boolean | 是否是活跃私客 |
| |─protectFlag | boolean | 保护客 |
| |─mergedFlag | boolean | 合并客 |
| |─rentRemark | string | 求租备注 |
| |─buyRemark | string | 求购备注 |
| |─rentMinSquare | number | 求租最低面积 |
| |─rentMaxSquare | number | 求租最高面积 |
| |─buyMinSquare | number | 求购最低面积 |
| |─buyMaxSquare | number | 求购最高面积 |
| |─customerUuid | string | 客源uuid |
| |─name | string | 客源名称 |
| |─customerNo | string | 客源编号 |
| |─gradeCfgUuid | string | 客源等级Uuid |
| |─lastFollowDate | string | 最后跟进时间 |
| |─lastCallDate | string | 最后通话时间 |
| |─statusCfgUuid | string | 状态uuid ERROR("ERROR", ""), BUY("keStatus-buy", "求购"), RENT("keStatus-rent", "求租"), RENT_BUY("keStatus-rentBuy", "租购"), BUY_OTHER("keStatus-buyOther", "已购"), RENT_OTHER("keStatus-rentOther", "已租"), BUYSELF("keStatus-buySelf", "我购"), RENTSELF("keStatus-rentSelf", "我租"), SUSPENDED("keStatus-suspended", "暂缓"); |
| |─activePub | boolean | 活跃状态 false-非活跃，true-活跃 |
| |─phoneInvalid | boolean | 电话状态 false-有效，true-无效 |
| |─customerActiveStatus | integer | 客源活跃状态 0:不活跃 1:7日活跃，2:30日活跃，3:90日活跃 |
| |─customerActivePhone | string | 客源活跃手机号 |
| |─preferenceNewHouse | integer | 偏好新房标签 |
| |─updatedTime | string | 更新时间 |
| |─rentMinPrice | number | 求租最小价格 |
| |─rentMaxPrice | number | 求租最大价格 |
| |─rentRoomCountCfgUuidList | array | 求租居室列表 KE_ROOM_COUNT_ONE(1, "keRoomCount-one", "1居"), KE_ROOM_COUNT_TWO(2, "keRoomCount-two", "2居"), KE_ROOM_COUNT_THREE(3, "keRoomCount-three", "3居"), KE_ROOM_COUNT_FOUR(4, "keRoomCount-four", "4居"), KE_ROOM_COUNT_FIVE_MORE(5, "keRoomCount-fiveMore", "5居及其以上"), |
| |─ | string | |
| |─buyMinPrice | number | 求购最小价格 |
| |─buyMaxPrice | number | 求购最大价格 |
| |─buyRoomCountCfgUuidList | array | 求购居室列表 KE_ROOM_COUNT_ONE(1, "keRoomCount-one", "1居"), KE_ROOM_COUNT_TWO(2, "keRoomCount-two", "2居"), KE_ROOM_COUNT_THREE(3, "keRoomCount-three", "3居"), KE_ROOM_COUNT_FOUR(4, "keRoomCount-four", "4居"), KE_ROOM_COUNT_FIVE_MORE(5, "keRoomCount-fiveMore", "5居及其以上"), |
| |─ | string | |
| |─rentIntentAreaList | array | 求租意向商圈 |
| |─ | string | |
| |─rentIntentAreaUuidList | array | 求租意向商圈UUID |
| |─ | string | |
| |─rentIntentEstateList | array | 求租意向小区 |
| |─ | string | |
| |─buyIntentAreaList | array | 求购意向商圈 |
| |─ | string | |
| |─buyIntentAreaUuidList | array | 求购意向商圈UUID |
| |─ | string | |
| |─buyIntentEstateList | array | 求购意向小区 |
| |─ | string | |
| |─buyPurposeCfgUuidList | array | 求购购房目的 INELASTIC_DEMAND("keBuyPurpose-inelasticDemand", "刚需",0), INVESTMENT("keBuyPurpose-investment", "投资",1), SCHOOLDISTRICT("keBuyPurpose-schoolDistrict", "学区",2), IMPROVEMENT("keBuyPurpose-improvement", "改善",3), COMMERCIAL("keBuyPurpose-commercial", "商用",4), OTHER("keBuyPurpose-other", "其他",5); |
| |─ | string | |
| |─processStatusCode | string | 带看进度 UN_INSPECT("keInspectProcess-unInspect", "未带看",0), FIRST_INSPECT("keInspectProcess-firstInspect", "一看",1), REINSPECT_CURRENT_DAY_INSPECT("keInspectProcess-reInspectCurrentDay", "当天复看",4), SECOND_INSPECT("keInspectProcess-secondInspect", "二看",2), RE_INSPECT("keInspectProcess-reInspect", "复看",3), TRANSACTION("keInspectProcess-transaction", "成交",5); |
| |─inspectCount | integer | 带看次数 |
| |─processStatusCodeDetails | string | 带看进度详情（英文逗号分隔） UN_INSPECT("keInspectProcess-unInspect", "未带看",0), FIRST_INSPECT("keInspectProcess-firstInspect", "一看",1), REINSPECT_CURRENT_DAY_INSPECT("keInspectProcess-reInspectCurrentDay", "当天复看",4), SECOND_INSPECT("keInspectProcess-secondInspect", "二看",2), RE_INSPECT("keInspectProcess-reInspect", "复看",3), TRANSACTION("keInspectProcess-transaction", "成交",5); |
| |─lastInspectDate | string | 最后带看时间 |
| |─ownerDeptUuid | string | 归属人部门uuid |
| |─ownerUuid | string | 归属人uuid |
| |─idCardType | string | 证件类型 |
| |─idCard | string | 证件号码 |
| |─delegateTime | string | 委托日期 |
| |─convertPublicTime | string | 跳公时间 |
| |─rentExpireTime | string | 租约到期时间 |
| |─propertyUuid | string | 房源uuid |
| |─transactionDeptUuid | string | 成交方部门uuid |
| |─transactionOwnerUuid | string | 成交方uuid |
| |─transactionTime | string | 成交日期 |
| |─usageTypeCfgUuid | string | 客源用途uuid USAGE_ZHU_ZHAI("keUsage-houseUsage", "住宅"), USAGE_BIE_SHU("keUsage-villaHouseUsage", "别墅"), USAGE_SHANG_ZHU("keUsage-commercialHouseUsage", "商住"), USAGE_SHANG_PU("keUsage-shopsHouseUsage", "商铺"), USAGE_XIE_ZI_LOU("keUsage-buildingHouseUsage", "写字楼"), USAGE_OTHER("keUsage-otherHouseUsage", "其他"); |
| |─deleteTime | string | 删除日期 |
| |─deletedEmpUuid | string | 删除人 |
| |─deletedDeptUuid | string | 删除人部门 |
| |─privateFlag | boolean | 私客标志，0代表公客、1代表私客 |
| |─transactionedFlag | boolean | 成交客标志，0代表未成交、1代表成交 |
| |─lastEffectiveStatusCfgUuid | string | 客源的上个有效状态 |
| |─phone1 | string | 第一个客户，默认客源的phone1 |
| |─customerGenderUuid | string | 第一个客户的性别UUID |
| |─intentionFlag | boolean | 有意向标志 |
| |─txTypeCode | string | 交易类型 |
| |─sourceChannelCfgUuid | string | 来源 |
| |─sourceChannelCfgUuid2 | string | 来源2。历史原因不明，sourceChannelCfgUuid 在 es mapping 中没有定义，使用在 es mapping 有定义的 sourceChannelCfgUuid2 |
| |─contactDTOList | array | 联系人列表 |
| |─ | object | |
| |─customerContactUuid | string | |
| |─id | integer | |
| |─customerContactTypeCfgUuid | object | |
| |─secondaryClassification | string | |
| |─thirdClassification | string | |
| |─configNo | integer | |
| |─deleted | boolean | |
| |─sysConfigUuid | string | |
| |─configCnName | string | |
| |─configName | string | |
| |─configValue | string | |
| |─customerUuid | string | |
| |─name | string | |
| |─genderCfgUuid | object | |
| |─secondaryClassification | string | |
| |─thirdClassification | string | |
| |─configNo | integer | |
| |─deleted | boolean | |
| |─sysConfigUuid | string | |
| |─configCnName | string | |
| |─configName | string | |
| |─configValue | string | |
| |─phone1AreaCode | string | |
| |─phone1 | string | |
| |─phone2AreaCode | string | |
| |─phone2 | string | |
| |─weixin | string | |
| string | ||
| |─remark | string | |
| |─phone1Invalid | boolean | |
| |─phone2Invalid | boolean | |
| |─lastCallTime | string | |
| |─createdUserId | string | |
| |─createTime | string | |
| |─updateUserId | string | |
| |─updateTime | string | |
| |─phoneId | string | |
| |─defaultPhoneFlag | integer | |
| |─softPhone | string | |
| |─yhkFlag | boolean | |
| |─phone1Id | string | |
| |─phone2Id | string | |
| |─xhkFlag | integer | |
| |─customerStakeholderResultDTOS | array | 相关方列表 |
| |─ | object | |
| |─stakeholderUuid | string | 相关方uuid keStakeholder-firstRecorder：首录人 keStakeholder-belonger：归属人 keStakeholder-trader：成交人 keStakeholder-cooperator：合作人 |
| |─deptUuid | string | 部门uuid |
| |─empUuid | string | 员工uuid |
| |─customerUuid | string | 客源uuid |
| |─stakeholderBelongDeptUuid | string | |
| |─belongDeptUuidUpdateTime | string | |
| |─customerVisitorResultDTOList | array | 访客信息列表 |
| |─ | object | |
| |─visitorPhone | string | |
| |─employeeUuid | string | |
| |─deptUuid | string | |
| |─ownerFranchiseeType | string | 加盟线类型 |
| |─ownerScopeUuid | string | 加盟线范围uuid |
| |─jumpType | string | 跳公类型 privateToPulic : 客源跳公 , marketerToPulic : 营销客跳公, materialToPulic：资料客跳公 |
| |─commonCustomerUuid | string | 营销客UUID |
| |─publicToPrivateInAuditFlag | boolean | 是否在公客转私客审批中 |
| |─topEmpUuids | array | 置顶用户uuids |
| |─ | string | |
| |─topDeptUuids | array | 置顶用户部门uuids |
| |─ | string | |
| |─topPeopleUuidList | array | 置顶用户uuid |
| |─ | string | |
| |─topTimesList | array | 置顶时间 |
| |─ | string | |
| |─topFlag | boolean | 是否置顶标志 |
| |─xhkFlag | integer | 小号客标签 |
| |─phoneId | string | 手机号密文 |
| |─remark | string | 备注 |
| |─createdTime | string | 创建时间 |
| |─privateContactFlag | boolean | 私客是否联系过 |
| |─newHouseMinPrice | number | 新房需求-总价-最低 |
| |─newHouseMaxPrice | number | 新房需求-总价-最高 |
| |─newHouseMinSquare | number | 新房需求-面积-最低 |
| |─newHouseMaxSquare | number | 新房需求-面积-最高 |
| |─newHouseRemark | string | 新房需求-备注 |
| |─demandTypeCfgUuidList | array | 需求类型 BUY("keDemandType-buy", "二手"), NEW_HOUSE("keDemandType-newHouse", "新房"), RENT("keDemandType-rent", "租房"); |
| |─ | string | |
| |─newHouseRoomCountCfgUuidList | array | 新房需求-居室 KE_ROOM_COUNT_ONE(1, "keRoomCount-one", "1居"), KE_ROOM_COUNT_TWO(2, "keRoomCount-two", "2居"), KE_ROOM_COUNT_THREE(3, "keRoomCount-three", "3居"), KE_ROOM_COUNT_FOUR(4, "keRoomCount-four", "4居"), KE_ROOM_COUNT_FIVE_MORE(5, "keRoomCount-fiveMore", "5居及其以上"), |
| |─ | string | |
| |─newHouseIntentAreaList | array | 新房需求-意向商圈 |
| |─ | string | |
| |─newHouseIntentAreaUuidList | array | 新房需求-意向商圈UUID列表 |
| |─ | string | |
| |─buyIntentNewHouseEstateList | array | 新房需求-意向新房楼盘列表 |
| |─ | string | |
| |─customizedFieldValueList | array | 自定义参数列表 |
| |─ | object | |
| |─customizedFieldValueUuid | string | |
| |─fieldValue | string | |
| |─customizedFieldUuid | string | |
| |─customerUuid | string | |
| |─preTransPubNew | integer | 即将跳公标签 |
| |─count | integer |
Response Demo:
{
"responseCode": "",
"responseMessage": "",
"responseType": "",
"errorDataMap": {
"": {}
},
"data": {
"list": [
{
"contactStatusDTOList": [
{
"customerUuid": "",
"empUuid": "",
"deptUuid": "",
"contactTime": ""
}
],
"publicBrowsedNum": 0,
"publicContactedNum": 0,
"thirtyDaysPublicContactedNum": 0,
"qualityLabel": "",
"cooperatorFlag": false,
"privateActiveFlag": false,
"protectFlag": false,
"mergedFlag": false,
"rentRemark": "",
"buyRemark": "",
"rentMinSquare": 0.0,
"rentMaxSquare": 0.0,
"buyMinSquare": 0.0,
"buyMaxSquare": 0.0,
"customerUuid": "",
"name": "",
"customerNo": "",
"gradeCfgUuid": "",
"lastFollowDate": "",
"lastCallDate": "",
"statusCfgUuid": "",
"activePub": false,
"phoneInvalid": false,
"customerActiveStatus": 0,
"customerActivePhone": "",
"preferenceNewHouse": 0,
"updatedTime": "",
"rentMinPrice": 0.0,
"rentMaxPrice": 0.0,
"rentRoomCountCfgUuidList": [
""
],
"buyMinPrice": 0.0,
"buyMaxPrice": 0.0,
"buyRoomCountCfgUuidList": [
""
],
"rentIntentAreaList": [
""
],
"rentIntentAreaUuidList": [
""
],
"rentIntentEstateList": [
""
],
"buyIntentAreaList": [
""
],
"buyIntentAreaUuidList": [
""
],
"buyIntentEstateList": [
""
],
"buyPurposeCfgUuidList": [
""
],
"processStatusCode": "",
"inspectCount": 0,
"processStatusCodeDetails": "",
"lastInspectDate": "",
"ownerDeptUuid": "",
"ownerUuid": "",
"idCardType": "",
"idCard": "",
"delegateTime": "",
"convertPublicTime": "",
"rentExpireTime": "",
"propertyUuid": "",
"transactionDeptUuid": "",
"transactionOwnerUuid": "",
"transactionTime": "",
"usageTypeCfgUuid": "",
"deleteTime": "",
"deletedEmpUuid": "",
"deletedDeptUuid": "",
"privateFlag": false,
"transactionedFlag": false,
"lastEffectiveStatusCfgUuid": "",
"phone1": "",
"customerGenderUuid": "",
"intentionFlag": false,
"txTypeCode": "",
"sourceChannelCfgUuid": "",
"sourceChannelCfgUuid2": "",
"contactDTOList": [
{
"customerContactUuid": "",
"id": 0,
"customerContactTypeCfgUuid": {
"secondaryClassification": "",
"thirdClassification": "",
"configNo": 0,
"deleted": false,
"sysConfigUuid": "",
"configCnName": "",
"configName": "",
"configValue": ""
},
"customerUuid": "",
"name": "",
"genderCfgUuid": {
"secondaryClassification": "",
"thirdClassification": "",
"configNo": 0,
"deleted": false,
"sysConfigUuid": "",
"configCnName": "",
"configName": "",
"configValue": ""
},
"phone1AreaCode": "",
"phone1": "",
"phone2AreaCode": "",
"phone2": "",
"weixin": "",
"qq": "",
"remark": "",
"phone1Invalid": false,
"phone2Invalid": false,
"lastCallTime": "",
"createdUserId": "",
"createTime": "",
"updateUserId": "",
"updateTime": "",
"phoneId": "",
"defaultPhoneFlag": 0,
"softPhone": "",
"yhkFlag": false,
"phone1Id": "",
"phone2Id": "",
"xhkFlag": 0
}
],
"customerStakeholderResultDTOS": [
{
"stakeholderUuid": "",
"deptUuid": "",
"empUuid": "",
"customerUuid": "",
"stakeholderBelongDeptUuid": "",
"belongDeptUuidUpdateTime": ""
}
],
"customerVisitorResultDTOList": [
{
"visitorPhone": "",
"employeeUuid": "",
"deptUuid": ""
}
],
"ownerFranchiseeType": "",
"ownerScopeUuid": "",
"jumpType": "",
"commonCustomerUuid": "",
"publicToPrivateInAuditFlag": false,
"topEmpUuids": [
""
],
"topDeptUuids": [
""
],
"topPeopleUuidList": [
""
],
"topTimesList": [
""
],
"topFlag": false,
"xhkFlag": 0,
"phoneId": "",
"remark": "",
"createdTime": "",
"privateContactFlag": false,
"newHouseMinPrice": 0.0,
"newHouseMaxPrice": 0.0,
"newHouseMinSquare": 0.0,
"newHouseMaxSquare": 0.0,
"newHouseRemark": "",
"demandTypeCfgUuidList": [
""
],
"newHouseRoomCountCfgUuidList": [
""
],
"newHouseIntentAreaList": [
""
],
"newHouseIntentAreaUuidList": [
""
],
"buyIntentNewHouseEstateList": [
""
],
"customizedFieldValueList": [
{
"customizedFieldValueUuid": "",
"fieldValue": "",
"customizedFieldUuid": "",
"customerUuid": ""
}
],
"preTransPubNew": 0
}
],
"count": 0
}
}
2、查询客源详情
BASIC
Path: /customer/main/listCustomerDetailByCustomerUuids
Method: POST
Desc:
PATH前缀：/api/jediopenplatformopenapi
REQUEST
Query:
| name | value | required | desc |
|---|---|---|---|
| param[0] | YES |
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | array | |
| |─ | object | |
| |─customerUuid | string | |
| |─rentTypeCfgUuid | string | 租赁方式。.replaceAll("keRentType-all", "整租").replaceAll("keRentType-part", "合租")); |
| |─rentMinPrice | number | |
| |─rentMaxPrice | number | |
| |─rentMinSquare | number | |
| |─rentMaxSquare | number | |
| |─rentTraffic | string | 租赁交通 |
| |─rentIntentArea | string | |
| |─rentIntentEstate | string | |
| |─rentDirectionCfgUuids | string | 出租-朝向 .replace("keDirection-east", "东").replace("keDirection-south", "南").replace("keDirection-west", "西").replace("keDirection-north", "北")); |
| |─rentRoomCountCfgUuids | string | |
| |─rentDecorationCfgUuids | string | 出租-装修 KE_DECORATION_ROUGH("keDecoration-rough", "毛坯"), KE_DECORATION_RINSING("keDecoration-rinsing", "清水"), KE_DECORATION_SIMPLE_PACKAGE("keDecoration-simplePackage", "简装"), KE_DECORATION_MIDDLE_PACKAGE("keDecoration-middlePackage", "中装"), KE_DECORATION_HARD_COVER("keDecoration-hardCover", "精装"), KE_DECORATION_LUXURY_DECOR("keDecoration-luxuryDecor", "豪装"), |
| |─rentRemark | string | |
| |─buyPurpose | string | |
| |─buyMinPrice | number | |
| |─buyMaxPrice | number | |
| |─buyMinSquare | number | |
| |─buyMaxSquare | number | |
| |─buyTraffic | string | 二手-交通 |
| |─buyPayTypeCfgUuid | string | |
| |─buyIntentArea | string | |
| |─buyIntentEstate | string | |
| |─buyIntentSchool | string | 意向学校 |
| |─buySchoolAdmissionTime | string | |
| |─buyDirectionCfgUuids | string | 二手-朝向 .replace("keDirection-east", "东").replace("keDirection-south", "南").replace("keDirection-west", "西").replace("keDirection-north", "北")); |
| |─buyRoomCountCfgUuids | string | |
| |─buyDecorationCfgUuids | string | 二手-装修 KE_DECORATION_ROUGH("keDecoration-rough", "毛坯"), KE_DECORATION_RINSING("keDecoration-rinsing", "清水"), KE_DECORATION_SIMPLE_PACKAGE("keDecoration-simplePackage", "简装"), KE_DECORATION_MIDDLE_PACKAGE("keDecoration-middlePackage", "中装"), KE_DECORATION_HARD_COVER("keDecoration-hardCover", "精装"), KE_DECORATION_LUXURY_DECOR("keDecoration-luxuryDecor", "豪装"), |
| |─buyEstateAgeCfgUuids | string | |
| |─buyEstateFloorCfgUuids | string | 二手-楼层 .replace("keEstateFloor-notFirst", "不要一层") .replace("keEstateFloor-low", "低楼层").replace("keEstateFloor-middle", "中楼层") .replace("keEstateFloor-high", "高楼层").replace("keEstateFloor-notTop", "不要顶层")); |
| |─buyRemark | string | |
| |─newHouseMinPrice | number | |
| |─newHouseMaxPrice | number | 新房需求-总价-最高总价(单位元) |
| |─newHouseMinSquare | number | 新房需求-面积-最低面积 |
| |─newHouseMaxSquare | number | 新房需求-面积-最高面积 |
| |─newHouseRoomCountCfgUuids | string | 新房需求-居室 |
| |─newHouseLocationCfgUuids | string | 新房需求-位置 |
| |─newHouseEstateFloorCfgUuids | string | 新房需求-楼层 |
| |─newHouseDirectionCfgUuids | string | 新房需求-朝向 |
| |─newHouseIntentAreas | string | 新房需求-意向商圈 |
| |─newHouseIntentAreaUuids | string | 新房需求-意向商圈UUID集合 |
| |─buyIntentNewHouseEstates | string | 新房需求-意向新房楼盘 |
| |─buyIntentNewHouseEstateUuids | string | 新房需求-意向新房楼盘UUID集合 |
| |─newHouseTraffic | string | 新房需求-交通 |
| |─newHouseRemark | string | 新房需求-备注 |
Response Demo:
{
"responseCode": "",
"responseMessage": "",
"responseType": "",
"errorDataMap": {
"": {}
},
"data": [
{
"customerUuid": "",
"rentTypeCfgUuid": "",
"rentMinPrice": 0.0,
"rentMaxPrice": 0.0,
"rentMinSquare": 0.0,
"rentMaxSquare": 0.0,
"rentTraffic": "",
"rentIntentArea": "",
"rentIntentEstate": "",
"rentDirectionCfgUuids": "",
"rentRoomCountCfgUuids": "",
"rentDecorationCfgUuids": "",
"rentRemark": "",
"buyPurpose": "",
"buyMinPrice": 0.0,
"buyMaxPrice": 0.0,
"buyMinSquare": 0.0,
"buyMaxSquare": 0.0,
"buyTraffic": "",
"buyPayTypeCfgUuid": "",
"buyIntentArea": "",
"buyIntentEstate": "",
"buyIntentSchool": "",
"buySchoolAdmissionTime": "",
"buyDirectionCfgUuids": "",
"buyRoomCountCfgUuids": "",
"buyDecorationCfgUuids": "",
"buyEstateAgeCfgUuids": "",
"buyEstateFloorCfgUuids": "",
"buyRemark": "",
"newHouseMinPrice": 0.0,
"newHouseMaxPrice": 0.0,
"newHouseMinSquare": 0.0,
"newHouseMaxSquare": 0.0,
"newHouseRoomCountCfgUuids": "",
"newHouseLocationCfgUuids": "",
"newHouseEstateFloorCfgUuids": "",
"newHouseDirectionCfgUuids": "",
"newHouseIntentAreas": "",
"newHouseIntentAreaUuids": "",
"buyIntentNewHouseEstates": "",
"buyIntentNewHouseEstateUuids": "",
"newHouseTraffic": "",
"newHouseRemark": ""
}
]
}
3、客源最后通话时间
BASIC
Path: /customer/main/searchLastCallDateByCustomerUuids
Method: POST
Desc:
PATH前缀：/api/jediopenplatformopenapi
REQUEST
Query:
| name | value | required | desc |
|---|---|---|---|
| param[0] | YES |
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | object | |
| |─key | string |
Response Demo:
{
"responseCode": "",
"responseMessage": "",
"responseType": "",
"errorDataMap": {
"": {}
},
"data": {
"": ""
}
}
4、查询客源带看信息
BASIC
Path: /customer/inspect/listCustomerInspectByUuids
Method: POST
Desc:
PATH前缀：/api/jediopenplatformopenapi
REQUEST
Query:
| name | value | required | desc |
|---|---|---|---|
| param[0] | YES | 带看UUID集合（即：listValidPropertyInspectionByUuids返回的brokerageWorkId） |
Request Demo:
{
"param": [
"1009829697627881472",
"88828282882828",
"896096369171759104"
]
}
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | array | |
| |─ | object | |
| |─inspectUuid | string | 带看UUID（即：listValidPropertyInspectionByUuids返回的brokerageWorkId） |
| |─inspectTypeCode | string | 带看类型code。keInspectType-buy：二手、keInspectType-rent：租房、keInspectType-newHouse：新房（含分销及代理） |
| |─inspectStartTime | Date | 带看开始时间 |
| |─inspectEndTime | Date | 带看结束时间 |
| |─inspectOwnerUuid | string | 带看人员工uuid（SaaS uuid） |
| |─workflowStatusCode | string | 审批状态code。keInspectProcess-unCommit：未提交、keInspectProcess-obsoleted：带看作废、keInspectProcess-approving：带看审批中、keInspectProcess-approved：带看审批通过、keInspectProcess-rejected：带看审批驳回 |
| |─inspectPropertyOpenDTOList | array | 带看房源列表 |
| |─ | object | |
| |─intentionCode | string | 带看房源意向code（对应满意度评价）。keInspectIntention-best：非常满意、keInspectIntention-better：满意、keInspectIntention-good：一般、keInspectIntention-normal：不满意、keInspectIntention-bad：非常不满意 |
| |─propertyUuid | string | 带看房源uuid |
Response Demo:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": [
{
"inspectUuid": "1009829697627881472",
"inspectTypeCode": "keInspectType-buy",
"inspectPropertyOpenDTOList": [
{
"intentionCode": "keInspectIntention-best",
"propertyUuid": "cd4b757a4da54ec59bb1e53d7c8f1d46"
}
]
},
{
"inspectUuid": "88828282882828",
"inspectTypeCode": null,
"inspectPropertyOpenDTOList": null
},
{
"inspectUuid": "896096369171759104",
"inspectTypeCode": "keInspectType-buy",
"inspectPropertyOpenDTOList": [
{
"intentionCode": "keInspectIntention-best",
"propertyUuid": "cb1f72b8a9764f588076e5be666a959c"
},
{
"intentionCode": "keInspectIntention-best",
"propertyUuid": "63a21bc8a97d42688db377ab215fdd22"
},
{
"intentionCode": "keInspectIntention-best",
"propertyUuid": "e006df9c923947e8b93782b3365fd154"
}
]
}
]
}
5、搜索带看
BASIC
Path: /customer/inspect/searchInspect
Method: POST
Desc:
PATH前缀：/api/jediopenplatformopenapi
REQUEST
Headers:
| name | value | required | desc |
|---|---|---|---|
| Content-Type | application/json;charset=UTF-8 | YES |
请求示例：
{
"param": {
"pageDTO": {
"pageNum": 1,
"pageSize": 10
},
"searchInspectOpenDTO": {
"searchDateTypeCode": "keInspectDateType-inspectDate",
"searchStartTime": 1759755200000,
"searchEndTime": 1762790399999
}
}
}
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | object | |
| |─list | array | |
| |─ | object | |
| |─commentStatus | string | 带看评价状态。commentStatus-waiting：待评价，commentStatus-finished：已评价，commentStatus-expired：超时未评价 |
| |─inspectUuid | string | 带看单uuid |
| |─inspectNo | string | 带看单编号 |
| |─preparedUuid | string | 报备uuid |
| |─customerUuid | string | 客源uuid |
| |─inspectDeptUuid | string | 带看部门uuid |
| |─inspectOwnerUuid | string | 带看人uuid |
| |─processStatusCode | string | 带看进度状态 |
| |─inspectTypeCode | string | 带看类型code |
| |─workflowStatusCode | string | 审批状态code |
| |─inspectDate | string | 带看日期 |
| |─inspectStartTime | string | 带看开始时间 |
| |─inspectEndTime | string | 带看结束时间 |
| |─enterTime | string | 带看录入时间 |
| |─accompanyAppDTOList | array | 陪看人列表 |
| |─ | object | |
| |─accompanyUuid | string | 陪看uuid |
| |─empUuid | string | 陪看人uuid |
| |─deptUuid | string | 陪看部门uuid |
| |─accompanyInspectTrace | string | 带看陪看轨迹 |
| |─routeStatus | string | 计算轨迹状态 route-ing : 轨迹计算中 , route-success : 轨迹计算成功 , route-empty : 无轨迹 |
| |─accompanyInspectStartTime | string | 陪看开始时间 |
| |─accompanyInspectEndTime | string | 陪看结束时间 |
| |─empName | string | 陪看人name |
| |─deptName | string | 陪看部门name |
| |─startLocation | string | 开始位置 |
| |─endLocation | string | 结束位置 |
| |─cooperationAppDTOList | array | 合作带看人列表 |
| |─ | object | |
| |─accompanyUuid | string | 陪看uuid |
| |─empUuid | string | 陪看人uuid |
| |─deptUuid | string | 陪看部门uuid |
| |─accompanyInspectTrace | string | 带看陪看轨迹 |
| |─routeStatus | string | 计算轨迹状态 route-ing : 轨迹计算中 , route-success : 轨迹计算成功 , route-empty : 无轨迹 |
| |─accompanyInspectStartTime | string | 陪看开始时间 |
| |─accompanyInspectEndTime | string | 陪看结束时间 |
| |─empName | string | 陪看人name |
| |─deptName | string | 陪看部门name |
| |─startLocation | string | 开始位置 |
| |─endLocation | string | 结束位置 |
| |─appraiseEmpUuid | string | 带看评价人uuid |
| |─appraiseDeptUuid | string | 带看评价人部门uuid |
| |─appraiseContent | string | 评价内容 |
| |─appraiseTime | string | 带看评价时间 |
| |─inspectPropertyAppDTOList | array | 带看房源列表 |
| |─ | object | |
| |─houseUseFirstCfgNameList | array | 一级用途uuid转换后的中文，如["别墅","商住","写字楼"] |
| |─ | string | |
| |─lng | number | 经度 |
| |─lat | number | 纬度 |
| |─minAveragePrice | number | 新房楼盘-均价-最小 |
| |─maxAveragePrice | number | 新房楼盘-均价-最大 |
| |─minTotalPrice | number | 新房楼盘-总价-最小 |
| |─maxTotalPrice | number | 新房楼盘-总价-最大 |
| |─minBuildArea | number | 新房楼盘-最小面积 |
| |─saleStatusCodeName | string | 新房楼盘-销售状态 |
| |─houseTypeList | array | 新房楼盘-房间类型 |
| |─ | string | |
| |─propertyTradeType | string | 房源类型 |
| |─maxBuildArea | number | 建筑最大面积 |
| |─districtName | string | 城区名称 |
| |─areaName | string | 商圈名称 |
| |─photoUrl | string | 封面图 |
| |─vrPhotoUrl | string | VR封面图 |
| |─videoPhotoUrl | string | 视频封面图 |
| |─countRoom | integer | 房数 |
| |─countHall | integer | 厅数 |
| |─countBathroom | integer | 卫生间数 |
| |─sellPrice | number | 售价(元) |
| |─sellUnitPrice | number | 售单价 元 |
| |─rentPrice | number | 租价(元) |
| |─rentUnitPrice | number | 租单价 |
| |─tradeStatus | string | 状态(出租、出售、我售、我租、无效、他售、他租、暂缓、租售、不租、不售、验真超时) |
| |─marketingPropertyUuid | string | 营销房源uuid |
| |─inspectPropertyUuid | string | 带看房源映射uuid |
| |─inspectUuid | string | 带看单uuid |
| |─propertyUuid | string | 房源uuid |
| |─estateUuid | string | 楼盘uuid |
| |─estateName | string | 楼盘名称 |
| |─promotionName | string | 新房楼盘推广名称 |
| |─preparedUuid | string | 报备uuid，由新房提供 |
| |─intentionCode | string | 意向code |
| |─customerIntentionCode | string | 用户填写的房源意向code。keInspectService-bad：不满意/不好（1星）、keInspectService-normal：较不满意/还行（2星）、keInspectService-good：一般/满意（3星）、keInspectService-better：较满意/很棒（4星）、keInspectService-best：满意/超惊喜（5星） |
| |─hasPermission | boolean | 是否有权限 |
| |─buildingUuid | string | 栋座uuid |
| |─buildingName | string | 栋座名称 |
| |─unitUuid | string | 单元uuid |
| |─unitName | string | 单元名称 |
| |─roomUuid | string | 房号uuid |
| |─roomNo | string | 房号名 |
| |─square | number | 房面积/房间面积 |
| |─direction | string | 房朝向/房间朝向 |
| |─subRoomNo | string | 房间号 |
| |─subRoomSquare | number | 房间面积 |
| |─subRoomDirection | string | 房间朝向 |
| |─privyCfgUuid | string | 获取房源属性字段（判断是否隐藏房源名称/地址时，用于判断房源属性是否包含在隐藏房源名称属性范围之内） |
| |─inspectFeedback | string | 带看反馈：最大长度200 |
| |─hasViewInspectDetailPermission | boolean | 是否有带看单详情查看权限 |
| |─callbackStatus | string | 回访状态 |
| |─sourceType | string | 来源类型，QIAO_FANG：巧房；AI_FANG：58爱房 |
| |─customerSourceChannelCfgUuid | string | 客户来源 |
| |─contractStatus | string | 带看确认单状态 |
| |─hasTrace | boolean | 是否有轨迹 |
| |─hasFeedback | boolean | 是否有带看反馈 |
| |─hasOuting | boolean | 是否有外出记录 |
| |─hasDaka | boolean | 是否打卡带看 |
| |─inspectDeptName | string | 带看部门名字 |
| |─inspectOwnerName | string | 带看人名字 |
| |─customerName | string | 客源名字 |
| |─count | integer |
Response Demo:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": {
"list": [
{
"commentStatus": "commentStatus-waiting",
"inspectUuid": "1189867483285159936",
"inspectNo": "71028500e19bd",
"preparedUuid": null,
"customerUuid": "930fb0a30c804f6ca6364c2f694b1bad",
"inspectDeptUuid": "99",
"inspectOwnerUuid": "42ed9edb-3994-43fd-b9a3-6c73647f6dc4",
"processStatusCode": "keInspectProcess-secondInspect",
"inspectTypeCode": "keInspectType-buy",
"workflowStatusCode": "keInspectProcess-approved",
"inspectDate": 1761582300000,
"inspectStartTime": 1761582300000,
"inspectEndTime": 1761584700000,
"enterTime": 1761616115000,
"accompanyAppDTOList": null,
"cooperationAppDTOList": null,
"appraiseEmpUuid": null,
"appraiseDeptUuid": null,
"appraiseContent": null,
"appraiseTime": null,
"inspectPropertyAppDTOList": [
{
"houseUseFirstCfgNameList": null,
"lng": null,
"lat": null,
"minAveragePrice": null,
"maxAveragePrice": null,
"minTotalPrice": null,
"maxTotalPrice": null,
"minBuildArea": null,
"saleStatusCodeName": null,
"houseTypeList": null,
"propertyTradeType": null,
"maxBuildArea": null,
"districtName": null,
"areaName": null,
"photoUrl": null,
"vrPhotoUrl": null,
"videoPhotoUrl": null,
"countRoom": null,
"countHall": null,
"countBathroom": null,
"sellPrice": null,
"sellUnitPrice": null,
"rentPrice": null,
"rentUnitPrice": null,
"tradeStatus": null,
"marketingPropertyUuid": null,
"inspectPropertyUuid": "1189867485621387267",
"inspectUuid": "1189867483285159936",
"propertyUuid": "863116a8955148ea9d514d5981ecf22f",
"estateUuid": "5593124cfe91439c8fb66889ca452d59",
"estateName": "聚吉楼11",
"promotionName": null,
"preparedUuid": null,
"intentionCode": "keInspectIntention-best",
"customerIntentionCode": null,
"hasPermission": true,
"buildingUuid": "654d29f9b2b14608a8f2e29a78138305",
"buildingName": "*",
"unitUuid": "b82690b046314a9d82da926fcd2c3346",
"unitName": "5",
"roomUuid": "d6ea5e15bf28484c9729f507a8bb637e",
"roomNo": "2202",
"square": null,
"direction": null,
"subRoomNo": null,
"subRoomSquare": null,
"subRoomDirection": null,
"privyCfgUuid": "proAttribute-blockedBuilding-0000000",
"inspectFeedback": null
},
{
"houseUseFirstCfgNameList": null,
"lng": null,
"lat": null,
"minAveragePrice": null,
"maxAveragePrice": null,
"minTotalPrice": null,
"maxTotalPrice": null,
"minBuildArea": null,
"saleStatusCodeName": null,
"houseTypeList": null,
"propertyTradeType": null,
"maxBuildArea": null,
"districtName": null,
"areaName": null,
"photoUrl": null,
"vrPhotoUrl": null,
"videoPhotoUrl": null,
"countRoom": null,
"countHall": null,
"countBathroom": null,
"sellPrice": null,
"sellUnitPrice": null,
"rentPrice": null,
"rentUnitPrice": null,
"tradeStatus": null,
"marketingPropertyUuid": null,
"inspectPropertyUuid": "1189867485621387266",
"inspectUuid": "1189867483285159936",
"propertyUuid": "f4aad056141c49f0bf199c597c1e12ae",
"estateUuid": "2707c499f61348c19a8f2a36e9eb046f",
"estateName": "小区别名51",
"promotionName": null,
"preparedUuid": null,
"intentionCode": "keInspectIntention-better",
"customerIntentionCode": null,
"hasPermission": true,
"buildingUuid": "0a393055dc07431eb50bb891c63075f7",
"buildingName": "*",
"unitUuid": "871ec3da41cb4b52a2e0d006e0740f8f",
"unitName": "1",
"roomUuid": "7bcadb219e3b4655916994fee3e3c96c",
"roomNo": "0201",
"square": null,
"direction": null,
"subRoomNo": null,
"subRoomSquare": null,
"subRoomDirection": null,
"privyCfgUuid": "proAttribute-blockedBuilding-0000000",
"inspectFeedback": null
},
{
"houseUseFirstCfgNameList": null,
"lng": null,
"lat": null,
"minAveragePrice": null,
"maxAveragePrice": null,
"minTotalPrice": null,
"maxTotalPrice": null,
"minBuildArea": null,
"saleStatusCodeName": null,
"houseTypeList": null,
"propertyTradeType": null,
"maxBuildArea": null,
"districtName": null,
"areaName": null,
"photoUrl": null,
"vrPhotoUrl": null,
"videoPhotoUrl": null,
"countRoom": null,
"countHall": null,
"countBathroom": null,
"sellPrice": null,
"sellUnitPrice": null,
"rentPrice": null,
"rentUnitPrice": null,
"tradeStatus": null,
"marketingPropertyUuid": null,
"inspectPropertyUuid": "1189867485621387265",
"inspectUuid": "1189867483285159936",
"propertyUuid": "cd28531f37d54bd8b71b952523269bd6",
"estateUuid": "71a0f8dc939448bb86b99591c492aa36",
"estateName": "Cai测试03小区（勿动）",
"promotionName": null,
"preparedUuid": null,
"intentionCode": "keInspectIntention-best",
"customerIntentionCode": null,
"hasPermission": true,
"buildingUuid": null,
"buildingName": null,
"unitUuid": "7bc8363557a34aa28031e7fb13e8dfff",
"unitName": "B",
"roomUuid": "7b3555ec73d24f9b957bd434b36be46d",
"roomNo": "0708",
"square": null,
"direction": null,
"subRoomNo": null,
"subRoomSquare": null,
"subRoomDirection": null,
"privyCfgUuid": "proAttribute-publicBuilding-00000000",
"inspectFeedback": null
}
],
"hasViewInspectDetailPermission": true,
"callbackStatus": "callbackStatus-finished",
"sourceType": "QIAO_FANG",
"customerSourceChannelCfgUuid": null,
"contractStatus": "contractEmpty",
"hasTrace": false,
"hasFeedback": false,
"hasOuting": false,
"hasDaka": false,
"inspectDeptName": "系统管理组",
"inspectOwnerName": "刘心心",
"customerName": "孙丽丽"
},
{
"commentStatus": "commentStatus-finished",
"inspectUuid": "1189625072185245696",
"inspectNo": "710272a4c47d3",
"preparedUuid": null,
"customerUuid": "dcced80f45fd467c810e27985b27843c",
"inspectDeptUuid": "99",
"inspectOwnerUuid": "42ed9edb-3994-43fd-b9a3-6c73647f6dc4",
"processStatusCode": "keInspectProcess-secondInspect",
"inspectTypeCode": "keInspectType-rent",
"workflowStatusCode": "keInspectProcess-approved",
"inspectDate": 1761476400000,
"inspectStartTime": 1761476400000,
"inspectEndTime": 1761478500000,
"enterTime": 1761558319000,
"accompanyAppDTOList": null,
"cooperationAppDTOList": null,
"appraiseEmpUuid": null,
"appraiseDeptUuid": null,
"appraiseContent": null,
"appraiseTime": null,
"inspectPropertyAppDTOList": [
{
"houseUseFirstCfgNameList": null,
"lng": null,
"lat": null,
"minAveragePrice": null,
"maxAveragePrice": null,
"minTotalPrice": null,
"maxTotalPrice": null,
"minBuildArea": null,
"saleStatusCodeName": null,
"houseTypeList": null,
"propertyTradeType": null,
"maxBuildArea": null,
"districtName": null,
"areaName": null,
"photoUrl": null,
"vrPhotoUrl": null,
"videoPhotoUrl": null,
"countRoom": null,
"countHall": null,
"countBathroom": null,
"sellPrice": null,
"sellUnitPrice": null,
"rentPrice": null,
"rentUnitPrice": null,
"tradeStatus": null,
"marketingPropertyUuid": null,
"inspectPropertyUuid": "1189625074588581889",
"inspectUuid": "1189625072185245696",
"propertyUuid": "e614fa5f0b4a4625a79babe375946ecc",
"estateUuid": "9c9a85e99be24907b1dc2add867196c9",
"estateName": "海馨苑",
"promotionName": null,
"preparedUuid": null,
"intentionCode": "keInspectIntention-better",
"customerIntentionCode": null,
"hasPermission": true,
"buildingUuid": null,
"buildingName": null,
"unitUuid": "b6f9eb5034ff4d30b6968ae3aaea44a8",
"unitName": "2",
"roomUuid": "095670590e9e42a9ac23bb167f8a8f67",
"roomNo": "302",
"square": null,
"direction": null,
"subRoomNo": null,
"subRoomSquare": null,
"subRoomDirection": null,
"privyCfgUuid": "proAttribute-publicBuilding-00000000",
"inspectFeedback": null
}
],
"hasViewInspectDetailPermission": true,
"callbackStatus": "callbackStatus-expired",
"sourceType": "QIAO_FANG",
"customerSourceChannelCfgUuid": "keSourceChannel-wechat",
"contractStatus": "contractEmpty",
"hasTrace": false,
"hasFeedback": false,
"hasOuting": false,
"hasDaka": false,
"inspectDeptName": "系统管理组",
"inspectOwnerName": "刘心心",
"customerName": "xing带看001"
}
],
"count": 7
}
}