目录

上门任务服务记录接口

JSON格式

名称 类型 只读 注释
idint 是 服务记录id，系统自动分配
createrIdint 是 创建人的客服id，系统自动分配
assigndIdint 是 派单客服id，系统自动分配
servicerIdint 是 接单人的客服id，系统自动分配
companyIdint 是客户公司id，系统自动分配
contactor varchar否 联系人
contactorMethodvarchar否 联系方式
VisitDateTimedatetime 否上门时间，格式为：2017-08-17 10:34:23
addressvarchar否上门地址
ptId int是 一级问题类型id，系统自动分配
ptChildint是 二级问题类型id，系统自动分配
ptThirdint是 三级问题类型id，系统自动分配
ProblemDescription varchar否 问题描述
ProblemSolution text 否解决方法
notevarchar否 备注
serviceCard varchar否 服务项目
payStatetinyint否支付状态：0-未支付，1-已支付
serviceFeedecimal否 服务费
serviceStatetinyint是 服务状态：0-未接收，1-已接收，2-已到达，8-申请取消，9-完成
BeginTime datetime 是 接收时间，格式为：2017-08-17 10:34:23
EndTime datetime 是 完成时间，格式为：2017-08-17 10:34:23
images array否图片资源，提交上门任务时可以上传图片
taskrecordsarray否任务流转记录
custom_fieldsarray否上门服务记录自定义字段

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
}