接口说明

通过本接口可获取PB大包号和大包箱单。

使用场景

提前确定大小包关系，通过此接口获取大包号和大包箱单。订单出库时，在大包外粘贴大包箱单，供应商扫描大包时，大包内小包都将产生轨迹，加快您的订单上网速度。
当前仅支持PB Standard Container，USPS ScanFrom 正在对接中，敬请期待。

接口名称

pis.scanForm.queryUspsScan

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。
接口版本Version	1.0

请求入参

名称	类型	必填	说明
mailDate	String(20)	Y	发货日期 yyyy-mm-dd HH:mm:ss 传发件地址当地时间
mailDateTimeZone	String	N	发货日期的时区
orderVo	Array	Y	快递单号List，单次请求限制2000个。单号较多时，接口返回较慢，请设置接口超时时间为10min
–\|trackingNo	String(50)	Y	跟踪号，PB Container 请传输Barcode
fromAddress	Object	N	发件人信息
–\|name	String(50)	N	发货人姓名
–\|companyName	String(100)	N	发货公司
–\|countryCode	String(2)	N	发货地国家二字码
–\|address1	String(35)	N	发货地址1
–\|address2	String(35)	N	发货地址2
–\|stateCode	String(3)	N	发货地州/省编码
–\|city	String(50)	N	发货地城市
–\|postcode	String(10)	N	发货地邮编
shipmentReference	String(25)	N	订单备注用于识别订单，面单以Shpmt Ref#字段展示。仅支持空格，数字，英文字符，不支持特殊字符

请求示例

{
    "action":"pis.scanForm.queryUspsScan",
    "app_key":"rebecca",
    "data":{
        "mailDate":"2023-05-17 00:00:00",
        "orderVo":[
            {
                "trackingNo":"4201123592xxxxxxx71660"
            },
            {
                "trackingNo":"4201123592xxxxxxx71677"
            }
        ],
        "fromAddress":{
            "name":"revName",
            "companyName":"revCompany",
            "countryCode":"US",
            "address1":"123",
            "address2":"",
            "stateCode":"DE",
            "city":"Herten NRW",
            "postcode":"45701"
        }
    },
    "format":"json",
    "language":"zh_CN",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "platform":"OWNERERP",
    "timestamp":"2023-05-17 00:19:26",
    "version":"1.0"
}

返回出参

名称	类型	必传	说明	示例
scanFormNumbers	Arraylist	Y	PB Container ID
scanFormFile	String	Y	Container Base64文件流

返回示例

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "scanFormNumbers": [
            "645394exxxxxxf5e6ac",
            "6465eeaxxxxxx17387a"
        ],
        "scanFormFile": ""
    }
}

关键词