描述:

  • 更新服务单

版本:

版本号 制定人 制定日期 更新内容
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   作者:大鱼研发