描述:
- 更新服务单
版本:
| 版本号 | 制定人 | 制定日期 | 更新内容 |
|---|---|---|---|
| 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 | 是否成功 |
文档更新时间: 2025-10-21 09:04 作者:大鱼研发