API
获取PB Container
更新时间: 0000-00-00 00:00:00 访问次数:794

接口说明

通过本接口可获取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#字段展示。仅支持空格,数字,英文字符,不支持特殊字符

请求示例

  1. {
  2. "action":"pis.scanForm.queryUspsScan",
  3. "app_key":"rebecca",
  4. "data":{
  5. "mailDate":"2023-05-17 00:00:00",
  6. "orderVo":[
  7. {
  8. "trackingNo":"4201123592xxxxxxx71660"
  9. },
  10. {
  11. "trackingNo":"4201123592xxxxxxx71677"
  12. }
  13. ],
  14. "fromAddress":{
  15. "name":"revName",
  16. "companyName":"revCompany",
  17. "countryCode":"US",
  18. "address1":"123",
  19. "address2":"",
  20. "stateCode":"DE",
  21. "city":"Herten NRW",
  22. "postcode":"45701"
  23. }
  24. },
  25. "format":"json",
  26. "language":"zh_CN",
  27. "sign":"00000000000000000000000000000000",
  28. "sign_method":"md5",
  29. "platform":"OWNERERP",
  30. "timestamp":"2023-05-17 00:19:26",
  31. "version":"1.0"
  32. }

返回出参

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

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "scanFormNumbers": [
  6. "645394exxxxxxf5e6ac",
  7. "6465eeaxxxxxx17387a"
  8. ],
  9. "scanFormFile": ""
  10. }
  11. }
关键词