61 创建上门服务单
工单待审核时,由售后人员进行审核,审核通过后,YMS 调用商家建单接口(接口url需商家提供)创建商家服务工单,等待商家分配上门工程师,此时,YMS 节点进入【待派单】状态。
该节点状态可多次调用,YMS 只记录信息,不做节点流转。
- 商家接口开发完成需与有品联调
0. 公共参数
参考 1-公共参数
与公共参数中不同的一点:外层没有数组格式
1. 请求参数:
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
serviceId | String | 是 | 工单号 |
orgId | String | 是 | 机构id |
orderId | String | 否 | 订单号 |
serviceType | String | 是 | 服务类型:TH-退货 HH-换货 WX-维修 |
serviceWay | String | 是 | 服务方式: DJFW-到家服务 |
createTime | Long | 是 | 创建时间 |
items | List |
是 | 受理商品 |
customer | CustomerInfo | 是 | 用户信息 |
GoodsItem信息:
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
sku | String | 是 | 商品id |
quantity | Integer | 是 | 受理数量 |
pid | Integer | 否 | pid |
customerDesc | String | 否 | 用户申请描述 |
CustomerInfo信息:
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
country | String | 是 | 国家/地区 |
province | String | 是 | 省 |
city | String | 是 | 市 |
district | String | 是 | 区 |
street | String | 是 | 街道 |
address | String | 是 | 详细地址 |
tel | String | 是 | 用户电话 |
name | String | 是 | 用户姓名 |
2.请求示例
加密前
{
"serviceId": "YP2004153900000007",
"orderId": "4200226764201877",
"orgId": "88",
"serviceType": "WX",
"serviceWay": "DJFW",
"items": [
{
"pid": 19558,
"sku": 3000054,
"quantity": 1
}
],
"customer": {
"country": 1,
"province": 2,
"city": 36,
"district": 384,
"street": 384011,
"address": "小米六期收发室",
"tel": "18511747611",
"name": "张广"
},
"customerDesc": null,
"createTime": 1586936122000
}
加密后
{"data":"GuKJjBmdgNlONxsnYypANrhfv5mJWpiuo2I4aGz2Fa2QqQHtBTE3cufFvZG3BzXSrWK2iRwwTkPkmu0125+fERPpIPhtaTLu1RG3nx28rA8m1DmHG1xz1lY53ZJI7tCgvn/qksgpEeC5c6mxqWUXoK3eEnLda/JSMRsUSPGIhIxe91bC2AuVnnM7FKcKGxd5pnIDenYciqjC9NtuvEiCe+uPqjbabANhmszSmt++3hBELnCdlYp/ZTKKNcG1rWhfzyha473oY lBTNxIRrVKVCPopHmRSwzjZDcBpZfQAIjMXWwtlRNZUi1z8za5g9OHX8164alRQpQi1fm0qn8xF6374mO9RkKAm2K8A6dEru9zyNXh4pTZ6wU6Cywzv7sZW5NakXuSX4lyGxsdkNDSukJA3w6FfphnzMKx+KFzbtiXVgCxaS2gnHkth6VdOViaexOCcVDvxREwqAe5lk3CQS9rLmuFlIp6nFQT0B0tX39I=",
"partnerId":"88",
"sign":"642146723b8a5389d949c4a6ca408445",
"timestamp":"1588058715"
}
2. 返回示例
{
"code": 0,
"message": "建单成功"
}