安装师傅APP接口
目录
1.认领,预约,签收接口(版本1.0)
- 请求路径:/open-web/rs/ant/v1/supplier/sign
- 请求方式:POST
- 接口版本:v1
- 输入参数:SupplierRequestVo实体
- 输出参数:ResBaseVo实体
输入参数(SupplierRequestVo实体)
字段 |
类型 |
长度 |
是否必填 |
参数说明 |
备注 |
orderId |
String |
36 |
是 |
订单id |
|
supplierId |
String |
36 |
是 |
供应商ID |
|
installMasterPhone |
String |
50 |
是 |
安装师傅电话 |
|
installMasterName |
String |
100 |
否 |
安装师傅名称 |
|
installPic |
List< String > |
不限 |
签收时(必填) |
签收图片 |
(每张照片一个经过BASE64Code转换过的字符串)(不能超过4张) |
operateType |
String |
10 |
|
签收状态 |
(10:已派安装师傅 20:预约客户 30:签收完成 40:核销完成) |
signPic |
String |
不限 |
否 |
签名图片 |
|
appointmentTime |
Date |
Date |
预约时必填 |
预约安装时间 |
|
signStatus |
String |
10 |
签收必填 |
安装状态 |
(正常:1,异常:2,拒签:3) |
supperSignTime |
Date |
Date |
签收时间 |
供应商签收时间 |
签收时为空则默认为当前时间 |
输出参数(ResBaseVo实体)
字段 |
类型 |
长度 |
是否必填 |
参数说明 |
备注 |
errcode |
String |
20 |
是 |
错误编码 |
成功:1000 |
errmsg |
String |
200 |
否 |
错误消息 |
|
result |
String |
|
否 |
|
|
2.安装公司需提供的任务接收接口
- 请求路径:供应商自定义路径
- 请求方式:POST
- 加密方式: 与天地华宇加密方式一样(user,key统一使用华宇提供给的_访问与请求)
- 接收参数:SupplierOrderVo实体
- 接收参数:SupplierInstallDetailVo实体
- 输出参数:ResBaseVo实体
接收参数(SupplierOrderVo实体)
字段 |
类型 |
长度 |
是否必填 |
参数说明 |
备注 |
id |
String |
36 |
是 |
定单id |
例:00c5bc63-076c-49d4-8839-b35143468558 |
orderNo |
String |
36 |
否 |
订单号 |
例:HY1605271528963174 |
serviceType |
String |
36 |
是 |
服务类型 |
0008:支装一体,0009:支装分离 |
arrival |
String |
1 |
是 |
是否到货 |
N:否,Y:是 |
arrivalTime |
Date |
Date |
否 |
到达门店时间 |
|
arrivalCompany |
String |
36 |
|
到达门店 |
例如:N上海1 |
verification |
String |
10 |
|
是否需要核销 |
1:是,0:否 |
appointInstallTime |
Date |
Date |
|
预约安装时间 |
|
goodsName |
String |
200 |
|
货物名称 |
|
transNo |
String |
50 |
|
运单编号 |
|
companyPhone |
String |
50 |
|
门店电话 |
|
companyAddress |
String |
500 |
|
门店地址 |
|
number |
BigDecimal |
|
|
件数 |
|
volume |
BigDecimal |
|
|
体积 |
|
weight |
BigDecimal |
|
|
重量 |
|
upstairs |
String |
10 |
|
是否送货上楼 |
|
consigneeName |
String |
60 |
|
收货人姓名 |
|
consigneeMobile |
String |
50 |
|
收货人手机 |
|
consigneeAddress |
String |
1000 |
|
收货人详细地址 |
|
whetherAppointInstall |
String |
10 |
|
是否需要预约 |
|
installNumber |
BigDecimal |
|
|
安装件数 |
|
omsOrderNo |
String |
50 |
|
OMS订单号 |
|
tmallOrderNo |
String |
50 |
|
天猫订单号 |
|
pickupTime |
Date |
Date |
|
提货时间 |
|
updateType |
int |
|
|
更新类型 |
10:新增(默认), 20:修改,30:作废 |
installDetailList |
List<SupplierInstallDetailVo> |
|
|
安装明细集合 |
|
接收参数(SupplierInstallDetailVo实体)
字段 |
类型 |
长度 |
是否必填 |
参数说明 |
备注 |
code |
String |
36 |
是 |
编码 |
|
name |
String |
100 |
否 |
名称 |
|
number |
BigDecimal |
|
否 |
件数 |
|
输出参数(ResBaseVo实体)
字段 |
类型 |
长度 |
是否必填 |
参数说明 |
备注 |
errcode |
String |
20 |
是 |
错误编码 |
|
errmsg |
String |
200 |
否 |
错误消息 |
|
result |
void |
|
否 |
请求结果 |
|
输出参数示例:
{
"result": null,
"errcode": "1000",
"errmsg": "成功"
}
{
"result": null,
"errcode": "3001",
"errmsg": "参数错误"
}