=====上门任务服务记录接口=====
====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
}