2025壳牌中国Hubapp经销商发货扫描项目


登录

请求信息

协议

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

 

 

 

请求示例

 

 

Java OkHttp

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file","/E:/Document/项目文档/hubapp/2025/zip/1749694431939.zip",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("/E:/Document/项目文档/hubapp/2025/zip/1749694431939.zip")))
  .build();
Request request = new Request.Builder()
  .url("https://uatshellapp.zhsh.co/api/uploadzip/upload")
  .method("POST", body)
  .addHeader("Authorization", "••••••")
  .build();
Response response = client.newCall(request).execute();

响应示例

{

    "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 数据字典配置

 


weizejun 2025年6月30日 15:29 收藏文档