描述:
- 更新服务单
版本:
版本号 | 制定人 | 制定日期 | 更新内容 |
---|---|---|---|
1 | 大鱼研发 | 2022-04-01 |
方法:
dayuOrderService.modifyOrder(OrderUpdate order,String token)
swagger 地址:
请求参数:
- 注意:只需要传入要更新的字段。
- 接单后不能更新派单工费、省市区字段
- 师傅提交验收后不能更新服务单
可直接查看,SDK实体类:
OrderUpdate
orderAccessorite
参数名 | 是否必须 | 类型 | 长度 | 说明 |
---|---|---|---|---|
id | 是 | long | 20 | 服务单ID |
customerType | 否 | int | 4 | 客户类型(1个人客户2企业客户) |
customerName | 否 | string | 50 | 个人客户名称 |
customerCompany | 否 | string | 100 | 企业客户名称(customerType为2时必填) |
customerMobile | 否 | string | 45 | 联系电话 |
customerTelphome | 否 | string | 45 | 备用联系方式 |
provinceAdcode | 否 | string | 20 | 省编码,如北京市:110000 |
provinceId | 否 | long | 20 | 省id (通过省市区地址接口)如使用大鱼平台省市区接口,则需传入。否则传入provinceAdcode即可 |
provinceName | 否 | string | 20 | 省名称(通过省市区地址接口)如使用大鱼平台省市区接口,则需传入 |
cityAdcode | 否 | string | 20 | 市编码,如北京城区:110100 |
cityId | 否 | long | 20 | 城市id(通过省市区地址接口)如使用大鱼平台省市区接口,则需传入。否则传入cityAdcode即可 |
cityName | 否 | string | 20 | 城市名称(通过省市区地址接口)如使用大鱼平台省市区接口,则需传入 |
districtAdcode | 否 | string | 20 | 县/区编码,如海淀区:110108 |
districtId | 否 | long | 20 | 县/区id(通过省市区地址接口)如使用大鱼平台省市区接口,则需传入。否则传入districtAdcode即可 |
districtName | 否 | string | 20 | 县/区(通过省市区地址接口)如使用大鱼平台省市区接口,则需传入 |
address | 否 | string | 200 | 详细地址 |
comment | 否 | string | 1000 | 工单备注 |
appointmentTime | 否 | string | 预约的时间格式:yyyy-MM-dd HH:mm:ss | |
needEsignature | 否 | int | 1 | 是否需要电子签名:1:需要 2:不需要 |
isCheck | 否 | int | 2 | 用户验收:0自动验收 1用户现场验收 2商家远程验收 |
updated | 是 | string | 50 | 修改人名称(登录人) |
orderAccessor | 否 | list | 附件列表(如果不更新附件不传入该字段,如果是部分修改,需要将保留的老附件数据一起传入) | |
spuSettlementPrice | 否 | double | 15,2 | 派单工费 |
sn | 否 | string | 200 | 序列号 |
needSerialNumPic | 否 | string | 1 | 师傅收集设备序列号:1需要 2不需要 |
payType | 否 | string | 4 | 收款方式:1委托师傅扫码收款 3不用向客户收款 4对公转账结算 (如果要更新,则payType/doorPrice/servicePrice三个字段需要一起传入) |
doorPrice | 否 | double | 10,2 | 代收商品货款(元) (如果要更新,则payType/doorPrice/servicePrice三个字段需要一起传入) |
servicePrice | 否 | double | 10,2 | 代收服务费(元) (如果要更新,则payType/doorPrice/servicePrice三个字段需要一起传入) |
doorPriceComment | 否 | string | 10,2 | 代收款备注 |
orderAccessorites 参数说明
参数名 | 是否必须 | 类型 | 长度 | 说明 |
---|---|---|---|---|
name | 是 | string | 200 | 附件名 |
URL | 是 | int | 20 | 附件URL |
参数示例:
注意该示例为完整的可更新字段,实际只需要传入要更新的字段。
{
"id":"4780",
"appointmentTime":"2022-02-10 18:30:00",
"customerType":1,
"customerCompany":"大鱼云服",
"customerName":"李缘圆",
"customerMobile":"18612345678",
"customerTelphome":"",
"provinceId":"1",
"provinceName":"北京市",
"cityId":"2",
"cityName":"北京城区",
"districtId":"195",
"districtName":"通州区",
"address":"环球度假区(地铁站) 1号线/八通线;7号线",
"needSerialNumPic":2,
"needShortVideo":2,
"spuSettlementPrice":12,
"comment":"请认真核对设备信息是否正确",
"orderAccessorites":[
{
"name":"服务流程图.jpg",
"url":"http://dl.kf.ai/dev/sp/serviceOrder/accessory/0beb34eaae0f6f1ea381fab30abb7a2a.jpg"
}
],
"payType":3,
"doorPriceComment":"",
"doorPrice":0,
"servicePrice":0,
"isCheck":2,
"needEsignature":2,
"updated":"管理员"
}
返回示例:
正确时返回:
{
"code": 0,
"subCode": null,
"data": true,
"msg": "成功"
}
错误时返回:
{
"code": 1,
"subCode": "ORDER0024",
"data": false,
"msg": "该服务单已提交验收,不能更新!"
}
{
"code": 1,
"subCode": "ORDER0024",
"data": false,
"msg": "师傅已接单,不能修改服务费金额和服务地址省市区信息"
}
...
返回字段说明:
字段名 | 类型 | 长度 | 说明 |
---|---|---|---|
data | Boolean | 是否成功 |
文档更新时间: 2022-10-13 09:52 作者:大鱼研发