接口说明

查询预约单列表及详情。

接口名称

winit.wh.inbound.booking.list

请求说明

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

请求入参

名称	类型	必填	说明	示例
bookingNo	String(128)	N	预约单号	-
status	String(128)	N	预约单状态 WBO：待预约 WABO：待审批 SBO：预约成功 RBO：已到仓 EXRBO：异常到仓 CANCEL：取消
warehouseCode	String(128)	N	仓库编码
pageParams	Object	N	分页参数	-
pageParams.pageNo	Integer	N	页码	默认 1
pageParams.pageSize	Integer	N	分页大小	默认 10

请求示例

{
      "action": "winit.ums.getPickupAddress",
      "app_key": "rebecca",
      "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
      "client_sign":"72DD01D66A971198C6E6CDE0057EE067",
      "data": {
        "bookingNo": "Y0100000002",
        "status": "",
        "pageParams": {
            "pageNo": 1,
            "pageSize": 10
        }
      },
      "format": "json",
      "language": "zh_CN",
      "platform": "OWNERERP",
      "sign": "AF99170EDFFFD64F407C930A7083C3E1",
      "sign_method": "md5",
      "timestamp": "2016-09-09 10:52:47",
      "version": "1.0"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必传	说明	示例
pageParams	Object	Y	分页参数
– pageNo	Integer	Y	页码	20190611
– pageSize	Integer	Y	分页大小	N
– totalCount	Integer	Y	总数量	中国
bookingNo	String(128)	Y	预约单号	Y0100000002
bookingCode	String(128)	Y	预约码	ADEC18HFGS1
bookingType	String(128)	Y	预约类型 Normal-普通预约；ValueAdded-增值预约；VIP-VIP 预约；RegularBus-班车预约
warehouseCode	String(128)	Y	预约仓库编码	US0001
warehouseName	String(128)	N	预约仓库名称	美国仓
customerCode	String(128)	Y	客户编码	C001
customerName	String(128)	N	客户名称	测试客户
sendWarehouseDate	String	Y	预约送仓时间	2025-09-29
actualUnloadDate	String	N	实际到仓时间	2025-09-29 10:30:00
status	String(128)	Y	预约状态 WBO-待预约；WABO-待审批；SBO-预约成功；RBO-已到仓；EXRBO-异常到仓；CANCEL-取消
packageQty	Integer	Y	预约包裹数	10
itemQty	Integer	Y	预约单品数	50
merchandiseQty	Integer	N	预约商品数	20
weight	BigDecimal(16,4)	Y	预约重量（kg）	100.5
volume	BigDecimal(16,9)	Y	预约体积（CBM）	2.5
totalCount	Int	Y	总记录数	34
toWhInOrderList	list	Y	入库单信息列表
orderNo	String(128)	Y	入库单号
inboundOrderStatus	String(16)	Y	入库单状态
isWholeOrderToWh	String(1)	N	是否整单送仓
sendWarehouseInfo	Object	Y	送仓信息
deliveryWayType	String(128)	Y	送仓方式 FCL-整柜；LCL-散货
unloadType	String(128)	Y	卸货方式 LIVE-LIVE 模式；DROP-DROP 模式
containerNo	String(128)	N	集装箱号	-
cabinetType	String(128)	N	柜型 20GP/40GP/40HQ/45HQ/53HQ
isPallet	String(1)	N	是否打托 Y-是；N-否
palletQty	Integer	N	托盘数	-
sealNo	String(128)	N	封条号	-
supplierCode	String(128)	N	供应商编码	-
supplierName	String(128)	N	供应商名称	-
contactPerson	String(128)	N	联系人	-
email	String(255)	N	邮箱	-
contactNumber	String(128)	N	联系电话	-

返回示例

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "pageParams": {
            "pageNo": 1,
            "pageSize": 10,
            "totalCount": 100
        },
        "list": [
            {
                "bookingNo": "Y0100000002",
                "bookingCode": "ADEC18HFGS1",
                "bookingType": "RegularBus",
                "warehouseCode": "US0001",
                "warehouseName": "美国仓",
                "customerCode": "C001",
                "customerName": "测试客户",
                "sendWarehouseDate": "2025-09-29",
                "actualUnloadDate": "",
                "status": "SBO",
                "packageQty": 10,
                "itemQty": 50,
                "merchandiseQty": 20,
                "weight": 100.5,
                "volume": 2.5,
                "toWhInOrderList": [
                    {
                        "orderNo": "WI46122840",
                        "inboundOrderStatus": "TS",
                        "isWholeOrderToWh": "Y"
                    }
                ],
                "sendWarehouseInfo": {
                    "deliveryWayType": "LCL",
                    "unloadType": "LIVE",
                    "contactPerson": "张三",
                    "contactNumber": "13800138000",
                    "email": "supplier@example.com"
                }
            }
        ]
    }
}

关键词