描述：

  • 保存服务单

版本：

版本号 制定人 制定日期 更新内容
1 大鱼研发 2020-07-19

方法:

保存（响应id）：

  • dayuOrderService.saveOrder(Order order,String token)

保存（响应详情）：

  • dayuOrderService.saveOrderAndGet(Order order,String token)

swagger 地址：

当需要保存后响应详情，调用下面这个接口：
（保存服务单并响应详情）

请求参数:

可直接查看，SDK实体类：
Order
OrdersRelationSpu
orderAccessorite

参数名 是否必须 类型 长度 说明
uid 是 string 32 校验唯一性，如商家系统工单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商家远程验收
created 是 string 50 创建人名称（登录人）
creatorMobile 是 string 11 创建人联系电话
spus 是 list 1 服务项目列表（当前只支持一个）
spuModels 是 list 100 服务设备信息（该属性在spus的对象下）
orderAccessor 否 list 10 附件列表
spuSettlementPrice 否 double 15,2 派单工费
sn 否 string 200 序列号
needSerialNumPic 是 string 1 师傅收集设备序列号：1需要 2不需要
payType 是 string 4 收款方式：1委托师傅扫码收款 3不用向客户收款 4对公转账结算
doorPrice 否 double 10,2 代收商品货款（元）
servicePrice 否 double 10,2 代收服务费（元）
doorPriceComment 否 string 10,2 代收款备注
needShortVideo 是 int 1 需要完工短视频：1.需要 2.不需要
isMultitask 是 int 1 多任务标识：1.是 2.否【强制每台设备按SOP重复操作】
isAutoDispatch 是 int 1 是否自动分派：1.是 2.否
spus 参数说明
参数名 是否必须 类型 长度 说明
kaSpuId 是 long 20 服务项目ID(通过服务列表接口)
kaSpuName 否 string 100 服务项目名称(通过服务列表接口)
spuModels 参数说明
参数名 是否必须 类型 长度 说明
productModel 否 string 100 品牌名称型号
num 否 int 20 服务的设备数量

orderAccessorites 参数说明

参数名 是否必须 类型 长度 说明
name 是 string 200 附件名
URL 是 int 20 附件URL

参数示例:

{
    "uid":"202110271656",
    "spus":[
        {
            "kaSpuId":"551",
            "kaSpuName":"对接服务项目",
            "spuModels":[
            {
                "productModel":"dell Inspiron 灵越 15",
                "num":2
            }
            ]
        }
    ],
    "created": "派单员1",
    "creatorMobile":"15701014745",
    "appointmentTime":"2021-05-11 12:00:00",
    "customerType":1,
    "customerCompany":"大鱼创想科技有限公司",
    "customerName":"李缘圆",
    "customerMobile":"18614005782",
    "provinceAdcode":"110000",
    "provinceName":"北京市",
    "cityAdcode":"110100",
    "cityName":"北京城区",
    "districtAdcode":"110108",
    "districtName":"海淀区",
    "address":"中关村 ",
    "comment":"工单备注",
    "orderAccessorites":[
        {
            "url":"http://dl.kf.ai/online/sp/serviceOrder/accessory/f7d82071fb58b4c3a3e4d0d4ed93f9a9.png",
            "name":"工单附件.png"
        }
    ],
    "isCheck":2,
    "needEsignature":1,
    "sn":"序列号",
    "payType":4,
    "doorPriceComment":"代收款备注",
    "doorPrice":"1.2",
    "servicePrice":"1.1",
    "needSerialNumPic":1,
    "spuSettlementPrice":10,
    "isMultitask":1,
    "isAutoDispatch":1
}

返回示例:

正确时返回:

{
  "code": 0,
  "subCode": null,
  "data": 84728,
  "msg": "成功"
}

错误时返回:

{
  "code": 1,
  "subCode": "SPU0003",
  "data": null,
  "msg": "服务不存在"
}
{
  "code": 1,
  "subCode": "OAUTH0005",
  "data": null,
  "msg": "address 不能为空"
}
...

返回字段说明:

字段名 类型 长度 说明
data long 20 服务单id
文档更新时间: 2025-10-21 09:04   作者：大鱼研发