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