拜访记录列表 - 铱云开放API 2.0

获取拜访记录列表,会根据操作人的客户权限进行数据控制

请求参数

Header 参数

access_token

string

必需

oauth2接口获取的access_token

x-client-id

string

必需

申请对接时的clientId

Body 参数application/json

currentPage

integer <int32>

页码默认值: 1

可选

customerIds

array[integer <int64>]

客户id集合

可选

endCreateTime

string <date-time>

可选

创建结束日期：日期格式：yyyy-MM-dd hh:mm:ss

pageSize

integer <int32>

可选

每页数量默认值: 20，最大值: 200

<= 200

startCreateTime

string <date-time>

可选

创建开始日期，日期格式：yyyy-MM-dd hh:mm:ss

status

integer <int32>

可选

拜访记录状态:0=待拜访,1=拜访中,2=已完成

visitSalesIds

array[integer <int64>]

可选

业务员id集合，使用场景：查询指定业务员创建的拜访记录

示例

{
    "currentPage": 0,
    "customerIds": [
        0
    ],
    "endCreateTime": "2019-08-24T14:15:22Z",
    "pageSize": 200,
    "startCreateTime": "2019-08-24T14:15:22Z",
    "status": 0,
    "visitSalesIds": [
        0
    ]
}

返回响应

🟢200OK

application/json

Body

currentPage

integer <int32>

可选

items

array[object (openapi-客户拜访记录) {30}]

可选

cityName

string

城市名称

可选

createTime

string <date-time>

创建时间

可选

creator

string

创建人

可选

creatorId

integer <int64>

创建人id

可选

customerCode

string

客户编码

可选

customerId

integer <int64>

客户id

可选

customerName

string

客户名称

可选

details

string

详细地址

可选

districtName

string

地区名称

可选

effective

boolean

可选

记录是否异常:true=正常，false=异常，默认正常

exceptionReason

string

异常原因

可选

integer <int64>

可选

lastVisitTime

string <date-time>

上次拜访

可选

latitude

number <double>

客户地址所处纬度

可选

longitude

number <double>

客户地址所处经度

可选

provinceName

string

省份名称

可选

salesId

integer <int64>

业务员id

可选

salesName

string

业务员名称

可选

signAddress

string

签到详细地址

可选

signDistance

number

签到点客户距离

可选

signLocation

string

签到经纬度

可选

signOutAddress

string

签退详细地址

可选

signOutDistance

number

签退点客户距离

可选

signOutLocation

string

签退经纬度

可选

signOutTime

string <date-time>

签退时间

可选

signTime

string <date-time>

签到时间

可选

status

integer <int32>

可选

拜访记录状态:0=待拜访，1=拜访中，2=已完成

summary

string

拜访记录纪要

可选

type

integer <int32>

可选

拜访记录类型:0=线上拜访、1=实地拜访

visitDuration

string

拜访时长

可选

pageSize

integer <int32>

可选

totalCount

integer <int64>

可选

totalPage

integer <int64>

可选

示例

{
    "currentPage": 0,
    "items": [
        {
            "cityName": "string",
            "createTime": "2019-08-24T14:15:22Z",
            "creator": "string",
            "creatorId": 0,
            "customerCode": "string",
            "customerId": 0,
            "customerName": "string",
            "details": "string",
            "districtName": "string",
            "effective": true,
            "exceptionReason": "string",
            "id": 0,
            "lastVisitTime": "2019-08-24T14:15:22Z",
            "latitude": 0,
            "longitude": 0,
            "provinceName": "string",
            "salesId": 0,
            "salesName": "string",
            "signAddress": "string",
            "signDistance": 0,
            "signLocation": "string",
            "signOutAddress": "string",
            "signOutDistance": 0,
            "signOutLocation": "string",
            "signOutTime": "2019-08-24T14:15:22Z",
            "signTime": "2019-08-24T14:15:22Z",
            "status": 0,
            "summary": "string",
            "type": 0,
            "visitDuration": "string"
        }
    ],
    "pageSize": 0,
    "totalCount": 0,
    "totalPage": 0
}