目录
登录
请求信息
协议 |
HTTP |
请求方法 |
POST |
请求路径 |
https://uatshellapp.zhsh.co/api/appscan/complex |
请求头 |
Content-Type:application/x-www-form-urlencoded |
请求参数
名称 |
是否必须 |
示例 |
备注 |
app_key |
是 |
@18201607#1000022 |
|
api_name |
是 |
login |
|
param |
是 |
{ "accountName": "12772880", "accountPwd": "654321", "phoneNumber": "345d66a2bee7b000c6dc6785146e857903bdac0d", "latitude": 10.02, "longitude": 20.03, "gpsAddress": "12.20", "factoryid": "100005" } |
|
返回消息体
名称 |
是否必须 |
示例 |
备注 |
code |
是 |
200 |
|
message |
否 |
|
|
data |
是 |
|
|
请求示例
{
"accountName": "12772880",
"accountPwd": "654321",
"phoneNumber": "345d66a2bee7b000c6dc6785146e857903bdac0d",
"latitude": 10.02,
"longitude": 20.03,
"gpsAddress": "12.20",
"factoryid": "100005"
}
响应示例
{
"code": 200,
"message": "OK",
"data": {
"deviationRange": 5000,
"controlState": "0",
"latitude": 31.10508,
"longitude": 121.515899,
"gpsAddress": "上海市闵行区恒南路",
"get_picture": "1",
"amount": 2,
"codeLen": "22,12,10,20,17,28",
"noticeUrl": "http://mobile.zhsh.co/hub/ShellOil/app/front/index.html?userid=3BB496213DA044409E5210B9E7F9360C&shipto=12277308&imei=007b25ffbaaeeba206ed78c162fb284916ba804b&factoryid=100005&sign=db0e5acad1559bab1a3ee87af9cb5a4d&randomcode=13098d74ad114d12aa410850c0767cbb",
"DouAndroidUrl": "https://www.pgyer.com/Nk0o",
"DouIOSUrl": "https://itunes.apple.com/cn/app/%E5%A3%B3%E7%89%8Cdou/id1335932177?mt=8",
"F1": "DBC58057F4C23A6CCA2C7C4AF806258D",
"scanAuth": "2",
"orgId": "001daaa4d81d46a0a6a6d7150b9d1558",
"orgNo": "12277308",
"orgName": "株洲润锦汽车销售服务有限公司"
}
}
scanAuth为新增参数,代表扫描权限,1收货扫描,2发货扫描,3全部,空代表无权限
异常示例
文件上传接口
上传的zip文件中,必须包含txt格式json文件,其上传的文件名不能重复,支持多个文件。其中图片为根目录下名为abc.png的图片,图片名称不能重复
json格式如下:
[
{
"accountName": "12363332",
"phoneNumber": "345d66a2bee7b000c6dc6785146e857903bdac0d",
"doNumber": "202506120001",
"shopNo": "12573218",
"shopName": "北京融力机械有限公司",
"products": [
{
"productNo": "550033571",
"productName": "壳牌爱力能 XL 40 (2005)",
"codes": [
{
"barcode": "887301211034",
"codeid":"1185798834",
"scanTime": "2025-06-12 10:04:12",
"scanLatitude": 121.670029,
"scanLongitude": 31.212182,
"scanGpsAddress": "上海市浦东新区齐爱路255号",
"img": "abc.png"
}
]
}
]
}
]
请求信息
协议 |
HTTP |
请求方法 |
POST |
请求路径 |
https://uatshellapp.zhsh.co/api/uploadzip/upload |
请求头 |
Content-Type:multipart/form-data |
|
Authorization:Basic QDE4MjAxNjA3OiMxMDAwMDIy |
请求参数
名称 |
是否必须 |
示例 |
备注 |
file |
是 |
|
文件 |
返回消息体
名称 |
是否必须 |
示例 |
备注 |
code |
是 |
200 |
|
message |
否 |
|
|
data |
是 |
|
|
请求示例
响应示例
{
"code": 200,
"message": "success",
"data": null
}
异常示例
{
"code": 500,
"message": "UnsupportedMediaType",
"data": null
}
状态码
状态码 |
描述 |
200 |
成功 |
500 |
参数异常 |
-100 |
系统异常 |
报表查询
请求信息
协议 |
HTTP |
请求方法 |
POST |
请求路径 |
https://uatshellapp.zhsh.co/api/appscan/complex |
请求头 |
Content-Type:application/x-www-form-urlencoded |
请求参数
名称 |
是否必须 |
示例 |
备注 |
app_key |
是 |
@18201607#1000022 |
|
api_name |
是 |
newreport |
|
param |
是 |
{ "accountName":"12772880", "phoneNumber": "abcd", "doNumber": "", "beginDate": "2025-06-12", "endDate": "2025-06-12" } |
|
返回消息体
名称 |
是否必须 |
示例 |
备注 |
code |
是 |
200 |
|
message |
否 |
|
|
data |
是 |
|
|
请求示例
{
"factoryid": "100005",
"accountName": "12772880",
"phoneNumber": "abcd",
"doNumber": "",
"beginDate": "2025-06-12",
"endDate": "2025-06-12"
}
响应示例
[
{
"doNumber": "202506120001",
"dealerNo": "12498386",
"dealerName": "张家港保税区顺通贸易有限公司壳牌润滑油分销中心",
"num": 12
}
]
异常示例
表说明
表名 |
描述 |
t_ac_hubapp_receipt | 物流订单 |
t_ac_hubapp_receipt_item | 物流订单产品 |
t_ac_hubapp_receipt_details | 物流订单扫码明细 |
t_ac_hubapp_mail_send | 邮件发送配置 |
t_ac_hubapp_mail_receive | 邮件收件人配置 |
t_ac_hubapp_mail_template | 邮件模板配置 |
t_ac_hubapp_config | 数据字典配置 |