{"swagger":"2.0","info":{"description":"2-9小组售后部分API。其中标注**的为没有更改的API。因为数据库已经做较大修改，这里只是指基本逻辑没有修改，而不是没有改变。售后功能部分取消了顾客确认售后结束和逻辑删除售后单的功能","version":"1.0.0","title":"2-9 API","contact":{"email":"22920202202879@stu.xmu.edu.cn"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"tags":[{"name":"aftersale","description":"售后部分"},{"name":"service","description":"服务部分"}],"paths":{"/orderitems/{id}/aftersales":{"post":{"tags":["aftersale"],"summary":"**买家提交售后单","description":"","operationId":"Createaftersale","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"id","in":"path","description":"订单明细id","required":true,"type":"integer"},{"name":"body","in":"body","description":"售后服务信息","required":true,"schema":{"properties":{"type":{"type":"integer","description":"0换货，1退货, 2维修"},"quantity":{"type":"integer"},"reason":{"type":"string"},"region_id":{"type":"integer"},"address":{"type":"string"},"contact":{"type":"string"},"mobile":{"type":"string"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Aftersale"}}}}}}},"/aftersales":{"get":{"tags":["aftersale"],"summary":"**买家或管理员查询所有的售后单信息（可根据售后类型和状态选择）","description":"默认所有，可以选择按类型或者状态查询（买家通过这个API只能查询到自己的售后单）","operationId":"queryAllReturnOrder","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"beginTime","in":"query","description":"开始时间","type":"string"},{"name":"endTime","in":"query","description":"结束时间","type":"string"},{"name":"page","in":"query","description":"页码","type":"integer"},{"name":"pageSize","in":"query","description":"每页数目","type":"integer"},{"name":"type","in":"query","description":"售后类型","type":"integer"},{"name":"state","in":"query","description":"售后状态","type":"integer"}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Aftersale"}}}}}}}}}},"/shops/{id}/aftersales":{"get":{"tags":["aftersale"],"summary":"**商户查看所有售后单","description":"商户查看所有售后单（可根据售后类型和状态选择)","operationId":"GetAllAfterSales","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"id","in":"path","description":"店铺id","type":"integer","required":true},{"name":"beginTime","in":"query","description":"开始时间","type":"string"},{"name":"endTime","in":"query","description":"结束时间","type":"string"},{"name":"page","in":"query","description":"页码","type":"integer"},{"name":"pageSize","in":"query","description":"每页数目","type":"integer"},{"name":"type","in":"query","description":"售后类型","type":"integer"},{"name":"state","in":"query","description":"售后状态","type":"integer"}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"integer"},"errmsg":{"type":"string"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Aftersale"}}}}}}}}}},"/aftersales/{id}":{"get":{"tags":["aftersale"],"summary":"**买家或管理员根据售后单id查询售后单信息","description":"买家通过这个API只能查询到自己的售后单","operationId":"getOnAftersaleOrder","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"id","in":"path","type":"string","description":"售后单id","required":true}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"object"},"errmsg":{"type":"string"},"data":{"$ref":"#/definitions/Aftersale"}}}}}},"put":{"tags":["aftersale"],"summary":"**买家修改售后单信息(店家生成售后单前)","description":"买家可以修改售后单信息，并重新发送修改后的信息给管理员审批。但是要在店家生成售后单前。生成后只能取消订单","operationId":"modifyAftersale","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"string","description":"售后单id","required":true},{"name":"body","in":"body","description":"买家可修改的信息：地址，售后商品的数量，申请售后的原因，联系人以及联系电话","required":true,"schema":{"properties":{"quantity":{"type":"integer","description":"售后商品数量"},"reason":{"type":"string","description":"原因"},"region_id":{"type":"integer","description":"取货地区id"},"address":{"type":"string","description":"取货地址"},"contact":{"type":"string","description":"联系人"},"mobile":{"type":"string","description":"联系电话"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}},"delete":{"tags":["aftersale"],"summary":"买家取消订单","description":"买家在全阶段可以取消售后单,只修改售后单状态。实际并没有删除操作","operationId":"deleteAftersales","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/shops/{shopId}/aftersales/{id}":{"get":{"tags":["aftersale"],"summary":"**商户根据售后单id查询售后单信息","operationId":"getAftersaleOrderByIdAdmin","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"shopId","in":"path","type":"integer","description":"店铺id","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"object"},"errmsg":{"type":"string"},"data":{"$ref":"#/definitions/Aftersale"}}}}}}},"/shops/{shopId}/aftersales/{id}/confirm":{"put":{"tags":["aftersale"],"summary":"管理员同意/不同意（退款，换货，维修）","description":"退款时先退支付金额，再退返点","operationId":"confirmAftersales","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"shopId","in":"path","type":"integer","description":"店铺id","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true},{"name":"body","in":"body","description":"处理意见","required":true,"schema":{"properties":{"confirm":{"type":"boolean"},"conclusion":{"type":"string","description":"处理详细意见"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/aftersales/{id}/sendback":{"put":{"tags":["aftersale"],"summary":"**填写售后的运单信息","description":"买家或者上门取件服务人员填写售后的运单信息，修改售后单状态","operationId":"sendbackAftersale","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true},{"name":"body","in":"body","description":"运单号","required":true,"schema":{"properties":{"type":{"type":"integer","description":"0：免费上门取件，1：付费上门取件，2：自行寄件"},"logSn":{"type":"string"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/shops/{shopId}/aftersales/{id}/receive":{"put":{"tags":["aftersale"],"summary":"**店家确认收到买家的退（换）货","description":"如果是退款，则退款给用户，如果换货、维修则等待下一个动作","operationId":"shopConfirmReceive","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"shopId","in":"path","type":"integer","description":"店铺id","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true},{"name":"body","in":"body","description":"处理意见","required":true,"schema":{"properties":{"confirm":{"type":"boolean"},"conclusion":{"type":"string"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/shops/{shopId}/aftersales/{id}/deliver":{"put":{"tags":["aftersale"],"summary":"**店家寄出货物","description":"- 维修：填写寄回的运单单号\n- 换货：产生售后订单，订单id填写到售后单的orderid","operationId":"deliverAferService","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"shopId","in":"path","type":"integer","description":"店铺id","required":true},{"name":"id","in":"path","type":"integer","description":"售后单id","required":true},{"name":"body","in":"body","description":"运单号","required":true,"schema":{"properties":{"shopLogSn":{"type":"string"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/aftersale/{id}/arbitration":{"post":{"tags":["aftersale"],"summary":"用户发起仲裁","description":"","operationId":"CreateArbitration","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"id","in":"path","description":"售后单id","required":true,"type":"integer"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Arbitration"}}}}}}},"/shops/{shopId}/aftersale/{id}/arbitration":{"post":{"tags":["aftersale"],"summary":"商户发起仲裁","description":"","operationId":"CreateArbitrationByShopid","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"shopId","in":"path","description":"店铺id","type":"integer","required":true},{"name":"id","in":"path","description":"售后单id","required":true,"type":"integer"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Arbitration"}}}}}}},"/arbitrations":{"get":{"tags":["aftersale"],"summary":"管理员或买家查看所有仲裁单","description":"默认所有，可以选择按状态查看","operationId":"GetAllArbitration","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"result","in":"query","description":"仲裁结果","type":"string"},{"name":"beginTime","in":"query","description":"开始时间","type":"string"},{"name":"endTime","in":"query","description":"结束时间","type":"string"},{"name":"page","in":"query","description":"页码","type":"integer"},{"name":"pageSize","in":"query","description":"每页数目","type":"integer"},{"name":"state","in":"query","description":"仲裁状态","type":"integer"}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"integer"},"errmsg":{"type":"string"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Arbitration"}}}}}}}}}},"/shops/{id}/arbitrations":{"get":{"tags":["aftersale"],"summary":"商户查看所有仲裁单","description":"默认所有，可以选择按状态查看","operationId":"GetAllArbitrationByAdmin","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"id","in":"path","description":"店铺id","type":"integer","required":true},{"name":"result","in":"query","description":"仲裁结果","type":"string"},{"name":"beginTime","in":"query","description":"开始时间","type":"string"},{"name":"endTime","in":"query","description":"结束时间","type":"string"},{"name":"page","in":"query","description":"页码","type":"integer"},{"name":"pageSize","in":"query","description":"每页数目","type":"integer"},{"name":"state","in":"query","description":"仲裁状态","type":"integer"}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"integer"},"errmsg":{"type":"string"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Arbitration"}}}}}}}}}},"/arbitrations/{id}":{"get":{"tags":["aftersale"],"summary":"买家、仲裁员根据仲裁单id查询仲裁单信息","description":"买家、仲裁员通过这个API只能查询到自己的仲裁单","operationId":"getArbitration","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"id","in":"path","type":"string","description":"仲裁单id","required":true}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"object"},"errmsg":{"type":"string"},"data":{"$ref":"#/definitions/Arbitration"}}}}}}},"/shops/{shopId}/arbitrations/{id}":{"get":{"tags":["aftersale"],"summary":"商户根据仲裁单id查看仲裁单","description":"商户通过这个API只能查询到自己的仲裁单","operationId":"getArbitrationByShopid","produces":["application/json"],"parameters":[{"name":"authorization","in":"header","type":"string","description":"用户token","required":true},{"name":"shopId","in":"path","description":"店铺id","type":"integer","required":true},{"name":"id","in":"path","type":"string","description":"仲裁单id","required":true}],"responses":{"default":{"description":"","schema":{"type":"object","properties":{"errno":{"type":"object"},"errmsg":{"type":"string"},"data":{"$ref":"#/definitions/Arbitration"}}}}}}},"/arbitrations/{id}/assign":{"put":{"tags":["aftersale"],"summary":"仲裁员接受仲裁","description":"仲裁员的信息","operationId":"modifyArbitration","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"string","description":"仲裁单id","required":true},{"name":"body","in":"body","description":"平台派遣仲裁员，填写仲裁员id,姓名等信息","required":true,"schema":{"properties":{"abitrator_id":{"type":"integer","description":"仲裁员id"},"arbitrator_name":{"type":"string","description":"仲裁员姓名"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/arbitrations/{id}/arbitrate":{"put":{"tags":["aftersale"],"summary":"仲裁员给出仲裁结果","description":"修改仲裁单状态和结果","operationId":"Arbitrate","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"integer","description":"仲裁单id","required":true},{"name":"body","in":"body","description":"仲裁结果","required":true,"schema":{"properties":{"result":{"type":"integer"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/arbitrations/{id}/cancel":{"put":{"tags":["aftersale"],"summary":"买家撤销仲裁","operationId":"cancleArbitration","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"id","in":"path","type":"integer","description":"仲裁单id","required":true}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/shops/{shopId}/arbitrations/{id}/cancel":{"put":{"tags":["aftersale"],"summary":"商家撤销仲裁","operationId":"cancleArbitrationByShopid","produces":["application/json"],"parameters":[{"name":"authorization","type":"string","in":"header","description":"用户token","required":true},{"name":"shopId","in":"path","description":"店铺id","type":"integer","required":true},{"name":"id","in":"path","type":"integer","description":"仲裁单id","required":true}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}}},"/service/{serviceId}/package":{"post":{"tags":["service"],"summary":"依据服务单创建服务物流","description":"","operationId":"CreateServicePackage","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"serviceId","in":"path","description":"服务单id","required":true,"type":"integer"},{"name":"body","in":"body","description":"服务物流信息","required":true,"schema":{"properties":{"type":{"type":"integer","description":"0收件，1寄件"},"service_order_id":{"type":"integer"},"package":{"$ref":"#/definitions/Simple_Package"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service_Package"}}}}}},"get":{"tags":["service"],"summary":"通过服务单查询服务物流，可使用搜索","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"serviceId","in":"path","required":true,"type":"integer"},{"name":"type","in":"query","type":"integer"},{"name":"package_id","in":"query","type":"integer","description":"运单id"},{"name":"page","in":"query","description":"页码","type":"integer","required":false},{"name":"pageSize","in":"query","description":"每页数目","type":"integer","required":false}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Service_Package"}}}}}}}}}},"/service/{serviceId}/package/{id}":{"get":{"tags":["service"],"summary":"通过服务单查询特定的服务物流详细信息","description":"- 只能获得本服务单的服务物流","operationId":"GetServicePackage","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"id","in":"path","type":"string","description":"service_product id","required":true},{"name":"serviceId","in":"path","type":"string","description":"service id","required":true}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service_Package"}}}}}},"delete":{"tags":["service"],"summary":"服务物流","description":"- 服务物流无法修改。\n- 服务单生成服务物流后，快递发出前，若顾客或商家删除服务单（或服务单信息需要更改），终止当前服务物流（可能新建服务物流）\n- 通过服务单调用本 API，只能取消\n- 发货前取消，完成后逻辑删除","parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"id","in":"path","description":"服务物流id","required":true,"type":"integer"},{"name":"serviceId","in":"path","description":"服务单id","required":true,"type":"integer"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":"0"},"errmsg":{"type":"string","example":"成功"}}}},"800":{"description":"服务物流状态禁止删除"}}}},"/orderitems/{orderItemId}/service":{"post":{"tags":["service"],"summary":"（顾客）依据订单明细创建服务单","operationId":"CreateService","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"orderItemId","in":"path","description":"订单明细id","required":true,"type":"integer"},{"name":"orderInfo","in":"body","description":"服务单信息","schema":{"type":"object","properties":{"type":{"type":"integer"},"consignee":{"type":"string","description":"联系人"},"service_region_id":{"type":"string","description":"服务地址"},"service_address":{"type":"string","description":"详细地址"},"consignee_mobile":{"type":"string","description":"联系人电话"},"description":{"type":"string","description":"描述"},"shop_id":{"type":"integer","description":"商铺id"},"service_shop_id":{"type":"integer","description":"服务商铺id"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":"0"},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service"}}}}}}},"/{roleType}/{roleId}/service":{"get":{"tags":["service"],"summary":"顾客/商户/服务商查询属于自己的服务单，可使用搜索","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"roleType","in":"path","required":true,"type":"integer","description":"customer/shop/maintainer"},{"name":"roleId","in":"path","required":true,"type":"integer"},{"name":"type","in":"query","type":"integer","description":"服务类型：0上门1寄件2线下"},{"name":"consignee","in":"query","type":"string","description":"联系人"},{"name":"service_region_id","in":"query","type":"string","description":"服务地址"},{"name":"service_address","in":"query","type":"string","description":"详细地址"},{"name":"consignee_mobile","in":"query","type":"string","description":"联系人电话"},{"name":"status","in":"query","type":"string","description":"服务单处理状态"},{"name":"maintainer_name","in":"query","type":"string","description":"服务人员姓名"},{"name":"maintain_mobile","in":"query","type":"string","description":"服务人员电话"},{"name":"result","in":"query","type":"integer","description":"服务结果"},{"name":"maintainer_id","in":"query","type":"string","description":"受理服务单的服务商id"},{"name":"page","in":"query","description":"页码","type":"integer","required":false},{"name":"pageSize","in":"query","description":"每页数目","type":"integer","required":false}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Service"}}}}}}}}}},"/{roleType}/{roleId}/service/{id}":{"get":{"tags":["service"],"summary":"顾客/商户/服务商查询特定服务单详细信息（只能查询属于自己的服务单)","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"roleType","in":"path","required":true,"type":"integer","description":"customer/shop/maintainer"},{"name":"roleId","in":"path","required":true,"type":"integer"},{"name":"id","in":"path","required":true,"type":"integer","description":"服务单id"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service"}}}}}},"put":{"tags":["service"],"summary":"顾客/商户/服务商修改服务单，只能修改属于自己的服务单","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"roleType","in":"path","required":true,"type":"integer","description":"customer/shop/maintainer"},{"name":"roleId","in":"path","required":true,"type":"integer"},{"name":"id","in":"path","description":"服务单id","required":true,"type":"integer"},{"name":"body","in":"body","description":"需要修改的服务单信息","required":true,"schema":{"properties":{"type":{"type":"integer","description":"0上门，1寄件, 2线下"},"consignee":{"type":"string","description":"联系人"},"service_region_id":{"type":"string","description":"服务地址"},"service_address":{"type":"string","description":"详细地址"},"consignee_mobile":{"type":"string","description":"联系人电话"},"status":{"type":"integer"},"maintainer_name":{"type":"string","description":"服务人员姓名"},"maintainer_mobile":{"type":"string","description":"服务人员电话"},"result":{"type":"integer","description":"服务结果"},"maintainer_id":{"type":"integer"}}}}],"responses":{"507":{"description":"当前状态禁止此操作"},"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"}}}}}},"delete":{"tags":["service"],"summary":"顾客/商户/服务商删除服务单","parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"roleType","in":"path","required":true,"type":"integer","description":"customer/shop/maintainer"},{"name":"roleId","in":"path","required":true,"type":"integer"},{"name":"id","in":"path","description":"服务单id","required":true,"type":"integer"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":"0"},"errmsg":{"type":"string","example":"成功"}}}},"800":{"description":"服务单状态禁止删除"}}}},"/service/{serviceId}/serviceOrderItem":{"post":{"tags":["service"],"summary":"依据服务单创建服务商品","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"serviceId","in":"path","description":"服务单id","required":true,"type":"integer"},{"name":"body","in":"body","description":"服务商品信息","required":true,"schema":{"properties":{"service_order_id":{"type":"integer"},"product":{"$ref":"#/definitions/Simple_Product"},"seriral_no":{"type":"integer","description":"串号"},"name":{"type":"string","description":"商品名"},"quantity":{"type":"integer","description":"数量"}}}}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service_Item"}}}}}},"get":{"tags":["service"],"summary":"通过服务单查询服务商品，可使用搜索","produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"serviceId","in":"path","required":true,"type":"integer"},{"name":"product_id","in":"query","type":"integer","description":"商品id"},{"name":"page","in":"query","description":"页码","type":"integer","required":false},{"name":"pageSize","in":"query","description":"每页数目","type":"integer","required":false}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"type":"object","properties":{"page":{"type":"integer","description":"页码"},"pageSize":{"description":"每页数目","type":"integer"},"total":{"description":"总数","type":"integer"},"pages":{"description":"总页数","type":"integer"},"list":{"type":"array","items":{"$ref":"#/definitions/Service_Item"}}}}}}}}}},"/service/{serviceId}/serviceOrderItem/{id}":{"get":{"tags":["service"],"summary":"通过服务单查询特定的服务商品详细信息","description":"- 只能获得本服务单的服务商品","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"id","in":"path","type":"string","description":"service_order_item id","required":true},{"name":"serviceId","in":"path","type":"string","description":"service id","required":true}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":0},"errmsg":{"type":"string","example":"成功"},"data":{"$ref":"#/definitions/Service_Item"}}}}}},"delete":{"tags":["service"],"summary":"取消服务商品","description":"- 服务商品无法修改。\n- 服务单删除时同时删除服务商品，逻辑删除","parameters":[{"in":"header","name":"authorization","description":"用户token","required":true,"type":"string"},{"name":"id","in":"path","description":"服务商品id","required":true,"type":"integer"},{"name":"serviceId","in":"path","description":"服务单id","required":true,"type":"integer"}],"responses":{"default":{"description":"成功","schema":{"type":"object","properties":{"errno":{"type":"integer","example":"0"},"errmsg":{"type":"string","example":"成功"}}}},"800":{"description":"服务商品状态禁止删除"}}}}},"definitions":{"Aftersale":{"description":"售后单","type":"object","properties":{"id":{"type":"integer"},"shop_id":{"type":"integer"},"aftersale_sn":{"type":"integer"},"type":{"type":"integer","description":"0换货 1退货 2维修"},"reason":{"type":"string"},"conclusion":{"type":"string"},"quantity":{"type":"integer"},"refund":{"type":"number"},"region_id":{"type":"integer"},"address":{"type":"string"},"contact":{"type":"string"},"mobile":{"type":"string"},"status":{"type":"integer"},"be_arbitated":{"type":"integer"},"refund_id":{"type":"integer"}}},"Arbitration":{"description":"仲裁单","type":"object","properties":{"id":{"type":"integer"},"status":{"type":"integer"},"reason":{"type":"integer"},"result":{"type":"integer"},"aftersale_id":{"type":"integer"},"arbitrator_id":{"type":"integer"},"arbitrator_name":{"type":"string"},"arbitration_\"date":{"type":"string"},"initiator_type":{"type":"integer","description":"申请人"}}},"Service_Package":{"description":"服务物流","type":"object","properties":{"id":{"type":"integer"},"type":{"type":"integer","description":"0收件，1寄件"},"package":{"$ref":"#/definitions/Simple_Package"},"service_order_id":{"type":"integer"}}},"Service_Item":{"description":"服务商品","type":"object","properties":{"id":{"type":"integer"},"service_order_id":{"type":"integer"},"product":{"$ref":"#/definitions/Simple_Product"},"seriral_no":{"type":"integer","description":"串号"},"name":{"type":"string"},"quantity":{"type":"integer","description":"数量"}}},"Service":{"description":"服务","type":"object","properties":{"id":{"type":"integer"},"orderItem":{"$ref":"#/definitions/Simple_Order_Item"},"type":{"type":"integer","description":"0上门，1寄件, 2线下"},"consignee":{"type":"string","description":"联系人"},"service_region_id":{"type":"string","description":"服务地址"},"service_address":{"type":"string","description":"详细地址"},"consignee_mobile":{"type":"string","description":"联系人电话"},"state":{"type":"integer","description":"0待处理，1已分派（上门服务），2待收件（寄件），3维修中（寄件），4取消"},"maintainer_name":{"type":"string","description":"服务人员姓名"},"maintainer_mobile":{"type":"string","description":"服务人员电话"},"description":{"type":"string","description":"描述"},"result":{"type":"integer","description":"0处理中，1取消，2已完成"},"maintainer_id":{"type":"integer"},"shop_id":{"type":"integer"},"service_shop_id":{"type":"integer"}}},"Simple_Order_Item":{"description":"服务","type":"object","properties":{"id":{"type":"integer"},"product_id":{"type":"integer"}}},"Simple_Package":{"description":"物流运单","type":"object","properties":{"id":{"type":"integer"},"shopId":{"type":"integer"},"sender":{"type":"string","description":"发件方地址"},"receiver":{"type":"string","description":"收件方地址"}}},"Simple_Product":{"description":"产品","type":"object","properties":{"id":{"type":"integer"},"goodsId":{"type":"integer"},"onSaleId":{"type":"integer"}}}},"host":"virtserver.swaggerhub.com","basePath":"/1351049203_1/2-9/1.0.0","schemes":["https"]}