CRM扩展
数据接口
- 开发向导
- 单点登录
- 工单
- 客服
- 客户
- 绑定关系
- 服务记录
- 表单
- 呼叫中心
- 知识库
- 标签
- 账号
- 短信
侧边栏
帮我吧文档:数据接口:服务记录:上门任务
上门任务服务记录接口
JSON格式
| 名称 | 类型 | 只读 | 注释 |
|---|---|---|---|
| id | int | 是 | 服务记录id，系统自动分配 |
| createrId | int | 是 | 创建人的客服id，系统自动分配 |
| assigndId | int | 是 | 派单客服id，系统自动分配 |
| servicerId | int | 是 | 接单人的客服id，系统自动分配 |
| companyId | int | 是 | 客户公司id，系统自动分配 |
| contactor | varchar | 否 | 联系人 |
| contactorMethod | varchar | 否 | 联系方式 |
| VisitDateTime | datetime | 否 | 上门时间，格式为：2017-08-17 10:34:23 |
| address | varchar | 否 | 上门地址 |
| ptId | int | 是 | 一级问题类型id，系统自动分配 |
| ptChild | int | 是 | 二级问题类型id，系统自动分配 |
| ptThird | int | 是 | 三级问题类型id，系统自动分配 |
| ProblemDescription | varchar | 否 | 问题描述 |
| ProblemSolution | text | 否 | 解决方法 |
| note | varchar | 否 | 备注 |
| serviceCard | varchar | 否 | 服务项目 |
| payState | tinyint | 否 | 支付状态：0-未支付，1-已支付 |
| serviceFee | decimal | 否 | 服务费 |
| serviceState | tinyint | 是 | 服务状态：0-未接收，1-已接收，2-已到达，8-申请取消，9-完成 |
| BeginTime | datetime | 是 | 接收时间，格式为：2017-08-17 10:34:23 |
| EndTime | datetime | 是 | 完成时间，格式为：2017-08-17 10:34:23 |
| images | array | 否 | 图片资源，提交上门任务时可以上传图片 |
| taskrecords | array | 否 | 任务流转记录 |
| custom_fields | array | 否 | 上门服务记录自定义字段 |
JSON示例
{
"id": 123,
"createrId": 223,
"assigndId": 243,
"servicerId": 254,
"companyId": 37809,
"contactor": "张三",
"contactorMethod": "13240138438",
"VisitDateTime": "2017-08-23 12:23:32",
"address": "北京市丰台区汉威国际4区3号楼",
"ptId": 111,
"ptChild": 222,
"ptThird": 333,
"ProblemDescription": "这里是问题描述",
"ProblemSolution": "这里是解决方案",
"note": "这里是备注",
"serviceCard": 453,
"payState": 1,
"serviceFee": "220.00",
"serviceState": 1,
"BeginTime": "2017-08-23 12:23:32",
"EndTime": "2017-08-23 12:23:32",
"images": [
"http://bangwo8.oss-cn-shenzhen.aliyuncs.com/1503285813465.JPEG",
"http://bangwo8.oss-cn-shenzhen.aliyuncs.com/1503285823413.JPEG"
],
"taskrecords": [
{
"operatetime": "2017-08-27 10:23:21",
"serviceState": 1,
"operator": "张三"
},
{
"operatetime": "2017-08-28 10:23:21",
"serviceState": 2,
"operator": "李四"
}
],
"custom_fields":[
{
"key": "field_1",
"value": "4334"
},
{
"key": "field_3",
"value": "1" //复选框
},
{
"key": "field_2",
"value": "下拉菜单的某一项"
}
]
}
服务记录列表
GET /api/v1/visitrecord/histories.json
调用者权限
管理员
调用参数
| 名称 | 必需的 | 类型 | 注释 |
|---|---|---|---|
| starttime | 否 | datetime | 按创建时间筛选，开始时间，格式为：2017-08-27 |
| endtime | 否 | datetime | 按创建时间筛选，结束时间，格式为：2017-08-29 |
| page | 否 | int | 分页获取，默认为1 |
| per_page | 否 | int | 每页大小，默认为100 |
说明：结束时间是包含当前时间的，例如结束时间为2017-08-29，则返回的记录包含2017-08-29当天的。
调用示例
curl https://www.bangwo8.com/api/v1/visitrecord/histories.json \
-v -u {account}:{password}
返回值示例
Status: 200 OK
{
"visitrecords": [
{
"id": 123,
"createrId": 2314,
...
},
{
"id": 124,
"createrId": 4323,
...
},
...
],
"count": 42,
"next_page": "https://www.bangwo8.com/api/v1/visitrecord/histories.json?per_page=40&page=2",
"previous_page": null
}
